Clawic CLI

使用已发布的 clawic 包，从基于 GitHub 的注册表中发现、检查和安装 Clawic 技能。整个工作流应始终锚定在真实的注册表索引、每个 slug 对应的清单文件（manifest），以及明确指定的安装目标路径上。

适用场景

当用户需要了解确切的 clawic CLI 命令、标志（flags）、注册表行为或安装流程时，请使用本技能。适用于 search、show、install、registry、CLAWIC_REGISTRY_BASE_URL，以及将技能文件写入 workspace 时所涉及的安全检查。

除非用户明确正在使用已发布的 clawic 包，否则请勿将通用的 clawhub 或 openclaw CLI 请求路由至此技能。

架构

状态数据（Memory）存储在 ~/clawic/ 目录下。若该目录不存在，请运行 setup.md 初始化。其结构详见 memory-template.md。

~/clawic/
├── memory.md    # 稳定默认值：运行时选择、安装根路径、审查姿态（review posture）
├── installs.md  # 已安装的 slug、目标目录及覆盖说明
└── queries.md   # 可靠命中对应技能的查询短语

快速参考

仅打开当前阻塞问题所需的最小文件即可。大多数会话只需 command-patterns.md 和 install-safety.md 两个文件。

快速开始

npx clawic registry
npx clawic search pocketbase --limit 5
npx clawic show pocketbase
npx clawic install pocketbase --dir ./skills

全局安装方式同样有效：

npm install -g clawic
clawic search pocketbase --limit 5

前提要求

• Node.js 20 或更高版本
• 临时使用可执行 npx clawic ...；如需持久化本地二进制文件，则执行 npm install -g clawic
• 执行 install 前，目标目录必须具有写入权限
• 仅当用户明确希望指向一个兼容的替代注册表时，才需设置可选环境变量 CLAWIC_REGISTRY_BASE_URL

安全提示

npx clawic ... 在本地缓存中未命中时，可能从 npm 获取已发布的包。若用户需要可复现的本地二进制文件而非临时拉取包，请改用全局安装或锁定项目依赖的工作流。

核心规则

1. 首先确认运行时路径

• 确认用户倾向使用 npx clawic ... 还是已全局安装的 clawic 二进制文件。
• 在排查注册表或安装错误前，先确认 Node.js 版本 ≥ 20。
• 若工具链本身异常，应优先修复工具链问题，而非臆测注册表故障。

2. 按精确技能名词搜索，而非模糊意图

• clawic search 是对已下载注册表索引进行的本地词法匹配，不涉及语义排序。
• 查询应使用目标技能实际包含的 slug、名称或描述关键词，例如 pocketbase、skill installer 或 github actions。
• 若宽泛请求返回结果不佳，应重写为该技能实际会包含的产品级名词。

3. 当适配性不明确时，先执行 show 再执行 install

• show 会获取并展示清单内容，报告技能标识、文件数量、仓库路径、源仓库地址及摘要，且不写入任何文件。
• 当对可信度、版本兼容性或写入范围存疑时，请优先审阅 slug 和源仓库信息。
• 将 show 视为低风险检查步骤，install 视为写入操作步骤。

4. 将清单（manifest）视为安装契约

• install 会将清单中 files 数组列出的所有路径，写入至 // 下。
• 若清单中包含相应条目，则预期会写入如 SKILL.md、辅助文档以及 _meta.json 等元数据文件。
• 不得承诺清单中未声明的文件，也不得假设存在隐藏的安装后步骤。

5. 显式控制目标安装目录

• 默认安装根目录为 ./skills，最终路径为 ./skills//。
• 当用户需要项目内路径、vendor 目录或用于审查的临时路径时，请始终使用 --dir 参数。
• 仅在确认覆盖现有文件确属用户本意后，方可使用 --force。

6. 覆盖注册表基地址时，务必显式声明

• clawic registry 命令用于打印当前生效的注册表基地址 URL。
• 默认基地址为 clawic/skills 在 GitHub 上的 raw 内容地址。
• 仅当用户明确希望使用兼容的镜像站或测试注册表时，才应设置 CLAWIC_REGISTRY_BASE_URL。

7. 网络行为细节须准确无误

• 注册表索引下载完成后，所有搜索词均在本地处理；clawic 不会将查询文本发送至远程搜索端点。
• 唯一产生的远程流量为 HTTP GET 请求：获取注册表索引、选定的清单文件，以及清单中引用的各技能文件。
• 若用户更改了注册表基地址，则上述请求模式将作用于该替代主机。

常见陷阱

• 混淆 clawic 与 clawhub 或 openclaw → 用户获得错误的命令族与注册表模型。
• 将 clawic search 当作语义发现工具 → 因匹配基于词法与字段，模糊请求必然失效。
• 未审阅清单即执行安装 → 错误的 slug 被写入 workspace。
• 忽略安装根目录默认为 ./skills → 文件出现在意料之外的目录中。
• 未加 --force 即对已有目标目录重复执行 install → 第一个已存在的路径将导致文件创建失败。
• 在共享或脏（dirty）目录树中使用 --force → 此前已审阅的文件将被覆盖。
• 覆盖 CLAWIC_REGISTRY_BASE_URL 但未验证兼容性 → 注册表索引或清单拉取返回 404 或格式错误的 JSON。
• 误以为 registry 命令可校验可用性 → 它仅打印当前生效的基地址 URL。

外部端点

若设置了 CLAWIC_REGISTRY_BASE_URL，则上述请求模式将转向该替代注册表主机。
除上述明确列出的行为外，本文档所述 CLI 流程不会向外部发送任何其他数据。

安全与隐私

离开您设备的数据：

• 向当前注册表基地址发起的 HTTP GET 请求
• install 过程中，针对清单所选技能文件的下载请求

保留在本地的数据：

• 注册表索引下载完成后，用户的查询文本
• 安装到指定目标目录的技能文件
• ~/clawic/ 中的可选默认值与备注

本技能明确不执行以下操作：

• 不向托管式语义搜索 API 发送搜索查询
• 不经用户许可自动安装技能
• 不覆盖文件，除非用户主动选择 --force
• 不读取或修改选定安装目标目录以外的文件（~/clawic/ 中用于可选状态存储的文件除外）

作用域

本技能仅支持以下功能：

• 协助使用官方 clawic CLI 接口
• 解释注册表索引、清单（manifest）与文件下载之间的协同关系
• 当用户需要工作流连续性时，在 ~/clawic/ 中持久化显式的工作流默认值

本技能永不执行以下操作：

• 发明不受支持的子命令或隐藏的注册表 API
• 声称 registry 命令可验证健康状态（它仅打印基地址 URL）
• 隐藏 install 或 --force 的写入副作用
• 修改自身的 SKILL.md

信任声明

使用本技能时，注册表与文件请求将发往 clawic/skills 在 GitHub 上的 raw 注册表，或用户手动指定的兼容注册表替代地址。
请仅在您信任该注册表所有者所分发文件的前提下，安装并使用本技能。

相关技能

若用户确认需求，可通过 clawhub install 安装以下技能：

• skill-finder —— 当用户尚未绑定 clawic 注册表时，提供更广泛的技能发现能力
• bash —— 在重复调用 clawic 命令及目录检查场景下，提供更安全的 Shell 组合能力
• documentation —— 为重度 CLI 工作流提供更清晰的命令参考与排障说明
• workflow —— 将反复出现的审查与安装流程固化为标准操作规程（SOP）
• javascript —— 调试本地 CLI 执行过程中的 Node 运行时与包管理问题

反馈

• 若本技能有用：clawhub star clawic
• 保持更新：clawhub sync