OpenClaw Docs CN

扩展生态 / ClawHub

ClawHub 全流程

如果你已经成功安装了 OpenClaw,接下来最值得学的一个模块,通常就是 ClawHub。ClawHub 是 OpenClaw 的公共 Skill 注册中心。 你可以通过它搜索、安装、更新、同步、发布 Skills,而不必手动去管理一堆分散的技能目录。

先把定位记住

ClawHub 不是 Skill 本身,而是 Skill 的分发和管理入口。它解决的是搜索、安装、更新、同步、发布这类“分发问题”。

先搞清楚:ClawHub 和 Skill 分别是什么

  • Skill 是一个目录,里面至少包含一个 SKILL.md
  • 这个目录还可以包含脚本、配置和额外资源。
  • OpenClaw 会从不同目录加载这些 Skills,并根据优先级决定谁生效。

第一步:安装 ClawHub CLI

官方文档给出的安装方式非常直接,任选一种:

npm i -g clawhub
pnpm add -g clawhub

官方给出的新手流程非常清晰,第一步不是安装,而是先搜索:

clawhub search "calendar"

你也可以换成更具体的需求:

clawhub search "postgres backups"

第三步:安装一个 Skill

clawhub install <skill-slug>

如果你要安装指定版本,也可以这样写:

clawhub install <skill-slug> --version <version>
安装完成后,要开启一个新的 OpenClaw 会话,系统才会稳定地拾取到新的 Skill。

ClawHub 把 Skill 安装到哪里

  • 默认情况下,ClawHub 会把 Skill 安装到当前工作目录下的 ./skills
  • 如果当前环境配置了 OpenClaw workspace,clawhub 会回退到这个 workspace。
  • OpenClaw 会把它当成 <workspace>/skills 来加载。

官方还明确了 Skills 的加载优先级:

  1. <workspace>/skills
  2. ~/.openclaw/skills
  3. bundled skills

最常用的 ClawHub 命令

clawhub login
clawhub whoami
clawhub search "query"
clawhub install <slug>
clawhub update <slug>
clawhub update --all
clawhub list
clawhub sync --all

更新 Skill 时要注意什么

官方文档提到,ClawHub 在更新时会用内容哈希比对本地 Skill 和注册表版本。如果你本地改过 Skill,更新时可能会触发覆盖确认;在非交互场景里,通常需要 --force 才能强制覆盖。

安装第三方 Skill 时,安全比方便更重要

官方 Skills 文档明确提醒:把第三方 Skill 当成不受信任代码来对待。

安装第三方 Skill 前,至少建议检查这几件事:

  1. SKILL.md 里到底在教智能体做什么。
  2. 看有没有脚本、外部下载或危险命令。
  3. 看它要求哪些环境变量和 API Key。
  4. 看它依赖哪些本地二进制工具。
  5. 看你是否真的需要这个 Skill。
  6. 看它是不是来自相对可信的作者或来源。
  7. 不要在不理解内容时直接给高权限运行环境。

下一步最适合看什么