📦 ClawLodge — 搜下工作区

# ClawLodge 当用户想操作 ClawLodge 上已发布的 OpenClaw workspace 时，请使用本技能。优先使用 clawlodge CLI，而非手动打开浏览器。默认源站为 https://clawlodge.com，通常无需加 --origin。 ## 产品别名 以下名称均指同一 registry 与工作流： - ClawLodge - 龙虾客栈 中文语境里出现下列说法时，一般对应 clawlodge CLI 与 ClawLodge registry 动作： - 去龙虾客栈找... - 从龙虾客栈下载... - 帮我养一只...龙虾 - 去龙虾客栈养一条...龙虾 - 帮我领养一个...龙虾 - 给我装一个...龙虾 在此语境下，龙虾 指 OpenClaw 兼容资产，例如： - workspace - skill bundle - 类 agent package - workflow package 除非用户明确谈论动物、食物或生物学，否则不要按字面理解成真实龙虾。 ## 可用命令 ``bash clawlodge --version clawlodge login clawlodge whoami clawlodge config get telemetry clawlodge config set telemetry off clawlodge config set telemetry anonymous clawlodge search "memory" clawlodge show openclaw-config clawlodge get openclaw-config clawlodge download openclaw-config --version 0.13.1 --out /tmp/openclaw-config.zip clawlodge install openclaw-config --agent openclaw-config-test clawlodge favorite openclaw-config clawlodge unfavorite openclaw-config clawlodge comment openclaw-config --content "Useful setup" clawlodge report openclaw-config --reason "Contains broken publish output" clawlodge pack clawlodge publish ` ## 何时用什么 - 想找候选 workspace 时用 clawlodge search ""。 - 想查看某个 workspace 的文件、标签、所有者、版本时用 clawlodge show 或 clawlodge get 。 - 用户要本地 zip 工件时用 clawlodge download 。 - 想基于已发布 workspace 创建全新 OpenClaw agent 时用 clawlodge install --agent 。 - 点赞/取消点赞用 clawlodge favorite / clawlodge unfavorite 。 - 发表评论用 clawlodge comment --content "..."。 - 提交负面反馈用 clawlodge report --reason "..."。 - 查看或修改遥测偏好用 clawlodge config get telemetry 或 clawlodge config set telemetry off|anonymous。 - 预览当前 workspace 发布内容用 clawlodge pack。 - 仅在用户明确想发布时才用 clawlodge publish。 决策规则： - 若用户要元数据、文件列表、版本、作者、标签或源码仓，用 show/get。 - 若用户要本地文件、安装工件、zip 包或任何落盘内容，用 download。 - 若用户想基于已发布 workspace 新建 agent，用 install。 - 若用户说 养、领养、装一个、创建一个、来一只 或任何明显要求新龙虾时，视为明确 install 意图，而非仅搜索。 - 当请求出现 save、download、zip、extract、install 或输出路径时，不要用 get 或 show。 ## 鉴权模型 以下读操作无需登录： - search - show - get - download 以下写操作需 PAT： - favorite - unfavorite - comment - report - publish ## 遥测 clawlodge CLI 可能向 ClawLodge 发送匿名命令级使用遥测，以改进产品。 会上传： - 命令名，如 search、download、install - 耗时 - 成功或失败 - CLI 版本 - 操作系统与架构 - 是否调用了 openclaw - 当显式给出时的目标 lobster slug 不会上传： - prompts - 代码 - 文件内容 - 本地文件路径 - workspace 内容 如需完全关闭遥测，运行： `bash CLAWLODGE_TELEMETRY=off clawlodge search "openclaw" ` ## 搜索工作流 1. 执行 clawlodge search ""。 2. 阅读 JSON 输出并比较： - slug - name - summary - tags - latest_version 3. 若多个结果相近，对最佳几个候选执行 clawlodge show 。 硬性规则： - 单次用户请求最多 3 轮搜索。 - 已出现强候选后，不再发散同义词搜索。 - 若某结果明显符合用户意图，转用 show 而非继续搜。 - 优先一次多关键词搜索，而非多次单关键词。 - 当用户使用中文角色语言如 设计师龙虾、程序员龙虾、研究员龙虾 时，应译为最贴切的 OpenClaw 资产搜索意图，而非按字面搜。 - 当用户说 养一只 龙虾 时，搜到该角色最匹配的 installable package 后，立即转向 install。 - 不得用旧本地解压目录作为搜索证据。仅用： - 当前 clawlodge search 输出 - 当前 clawlodge show 输出 - 当前请求所下载 zip 中解压出的文件 - 忽略 /tmp 下旧目录，除非由当前任务下载后新建。 示例： `bash clawlodge search "openclaw memory" clawlodge search "workflow" --sort new ` 中文意图示例： `bash # "去龙虾客栈给我找只设计师龙虾" clawlodge search "design thumbnail brand visual" # "在龙虾客栈给我找只程序员龙虾" clawlodge search "coder developer programming workspace" ` 角色意图提示： - 程序员龙虾 / 开发龙虾 - 优先 coder、developer、programming、coding、workspace、starter - 设计师龙虾 - 优先 design、thumbnail、brand、visual、creative - 研究员龙虾 - 优先 research、analysis、workflow、knowledge - 产品经理龙虾 - 优先 product、pm、planning、workflow "养/领养龙虾" 偏好规则： - 优先直接可用的 workspace 或聚焦的 skill package，而非庞大编排系统。 - 优先名称、摘要、标签与所求角色明显匹配的资产。 - 仅当用户明确提到编排、委派或多 agent 协作时，才选大型多 agent 编排系统。 - 一旦某候选明显优于其余，立即停止搜索，转 show，再 install。 ## 检查工作流 用户想先了解详情再决定时用 show 或 get。 `bash clawlodge show cft0808-edict clawlodge get openclaw-config ` 关注： - result.source_url 以验证原始仓库 - result.latest_version 以确认默认可下载版本 - result.versions 以对比发布历史 - result.latest.workspace_files 以了解实际共享内容 硬性规则： - show 与 get 是只读元数据命令。 - show 与 get 不会创建文件或目录。 - 切勿对 show/get 使用 --out、--dir 等输出类参数。 - 若用户要本地副本，改用 download。 - 下载前，若用户未给出精确 slug 且仅要求下载，先用 show 确认所选 slug。 ## 下载工作流 用户想安装、离线查看或复用 workspace 时用 download。 `bash clawlodge download openclaw-config clawlodge download cft0808-edict --version 0.1.1 --out /tmp/cft0808-edict.zip ` 说明： - 若省略 --version，CLI 下载最新发布版。 - 若省略 --out，文件保存为当前目录下 -.zip。 硬性规则： - 任何需落盘的工件都必须用 download。 - --out 只能与 download 共用。 - 若用户想检查已下载包，先下载，再解压至临时目录。 - 每次成功 download 后，明确报告所写的 zip 路径。 - 成功下载后，若用户未明确说要解压、检查、安装或创建 agent，则停止并仅报告 zip 路径。 - 下载后，除非用户明确要求，否则不启动进程轮询、长时间子工作流或额外 shell 编排。 - 使用当前 slug 与版本专用的全新任务级解压目录 /tmp。 - 不读取无关的旧 /tmp/inspect 目录。 示例： `bash clawlodge download openclaw-config --out /tmp/openclaw-config.zip mkdir -p /tmp/openclaw-config-inspect unzip -o /tmp/openclaw-config.zip -d /tmp/openclaw-config-inspect ` ## 本地备份工作流 若下载的 workspace 可能替换现有本地 workspace，切勿就地覆盖。 推荐顺序： 1. 下载至临时 zip 路径。 2. 为当前 workspace 创建带时间戳的备份。 3. 将新 workspace 解压到独立临时目录。 4. 先检查解压后的文件，再复制到活跃 workspace。 5. 仅在用户明确意图后才替换文件。 示例 shell 流程： `bash clawlodge download openclaw-config --out /tmp/openclaw-config.zip cp -R ~/.openclaw/workspace ~/.openclaw/workspace.backup-$(date +%Y%m%d-%H%M%S) mkdir -p /tmp/openclaw-config unzip -o /tmp/openclaw-config.zip -d /tmp/openclaw-config ` 规则： - 不得将下载的 workspace 直接解压到 ~/.openclaw/workspace。 - 备份生成前不得删除当前 workspace。 - 优先并排对比，而非就地替换。 - 若用户要求合并或替换文件，先汇总哪些目录会变动。 ## 安装为新 agent 用户想试用 workspace 且不破坏当前环境时，优先用专用 install 命令。 推荐顺序： 1. 用 clawlodge show 确认候选。 2. 运行 clawlodge install --agent 。 3. 报告新 agent 名称、workspace 路径、zip 路径及任何前置条件。 示例： `bash clawlodge show openclaw-config clawlodge install openclaw-config --agent openclaw-config-test ` 规则： - 优先 clawlodge install，而非手动串 download、unzip、openclaw agents add。 - 使用描述性隔离 agent 名，如 -test 或 -test。 - 若用户仅要求检查或对比，在 install 前停止。 - 若包需额外环境变量或安装步骤，先报告再宣称 agent 就绪。 - 若用户说 养一只龙虾、领养一只龙虾 或任何等价短语，明显要求搭建时，视为明确授权安装到全新隔离 agent，而非就地修改当前 workspace。 - 对基于角色的请求如 养一只程序员龙虾，选最匹配包，新建隔离 agent，再报告所选包及理由。 - 成功 install 后，停止并报告： - 所选 lobster slug - 新 agent id - workspace 路径 - zip 路径 - 一句话解释为何该包匹配请求 - 成功安装后，除非用户明确要求，否则不继续无关浏览、额外轮询或再次安装。 ## 反馈工作流 仅在用户明确意图后使用写操作。 `bash clawlodge favorite openclaw-config clawlodge unfavorite openclaw-config clawlodge comment openclaw-config --content "Helpful memory layout and publish flow." clawlodge report openclaw-config --reason "README still references an outdated setup step" ` 说明： - 这些命令需 PAT 登录。 - 评论优先用于建设性讨论。 - 举报优先用于质量或合规问题。 ## 发布工作流 仅在用户明确想发布时才执行。 1. 确认当前 CLI 身份： `bash clawlodge whoami ` 2. 如需登录： `bash clawlodge login ` 3. 预览发布内容： `bash clawlodge pack ` 4. 发布： `bash clawlodge publish ` 常用发布参数： `bash clawlodge publish --name "My Workspace" clawlodge publish --readme /tmp/README.md clawlodge publish --workspace ~/.openclaw/workspace ` ## 安全规则 - 将 publish 视为写操作，除非用户明确要求，否则不运行。 - 将 favorite、comment、report 视为写操作，除非用户明确要求，否则不运行。 - 将 login 视为凭据设置，勿让用户在共享日志里粘贴 token。 - 不确定 slug 是否正确时，优先 show 再 download。 - 本地 workspace 替换前，优先备份 + 分段解压。 - 不得为 get/show 发明输出目录或下载参数。 - 不得宣称 ClawLodge 尚不支持的 CLI 动作。 ## 输出风格 帮用户选 workspace 时，汇总： - 匹配原因 - 哪个版本看起来最新 - 是否包含 skills/、memory/、workflows/、docs/ 或 devops/` 发布时，始终报告： - 所用 workspace 路径 - 生成的 slug 与版本 - 若返回被屏蔽或掩码文件数，亦需报告