通过 ClawHub 安装技能指南
通过 ClawHub 安装技能指南
本文档介绍如何在 OpenClaw 环境中，通过 clawhub 安装和管理常用技能。内容包含 clawhub 安装、API Key 获取、登录、技能搜索、技能安装、安装验证，以及常见问题排查。
一、前提说明
在开始之前，请确认：
- 你的机器已经安装
Node.js和npm - 你的 OpenClaw 环境已经可以正常使用
- 你的机器可以访问
https://clawhub.ai/ - 你准备通过
clawhub来统一搜索、安装和管理技能
如果还没有安装 Node.js，可以先检查版本：
node -v
npm -v
只要命令能正常输出版本号，就可以继续下一步。
二、安装 ClawHub
使用 npm 全局安装 clawhub：
npm i -g clawhub
安装完成后，执行下面的命令确认是否安装成功：
clawhub --help
如果看到 ClawHub CLI 的帮助信息，说明安装成功。
你也可以查看版本：
clawhub -V
三、登录 ClawHub 获取 API Key
clawhub 在未登录状态下也许可以执行部分操作，但通常会遇到匿名访问限流问题，例如：
Error: Rate limit exceeded
为了避免这个问题，建议先登录并绑定自己的 API Key。
1. 打开 ClawHub 官网
在浏览器中访问：
https://clawhub.ai/
2. 登录你的账号
使用网页端完成登录。
3. 获取 API Key
登录后，在 ClawHub 网站中找到 API Key 或 Token 管理页面，创建一个新的 API Key。
建议：
- 给这个 Key 取一个容易识别的名称，例如
openclaw-linux - 不要把真实 Key 写进公开文档、代码仓库或截图里
- 如无必要，不要长期复用同一个高权限 Key
四、通过 Token 登录 ClawHub
拿到 API Key 之后，在终端执行：
clawhub login --token "你的_API_Key"
例如：
clawhub login --token "clh_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
说明：
- 请把
你的_API_Key替换成你自己在 ClawHub 网站生成的真实 Key - 不建议把真实 Key 固化到文档、脚本或仓库中
登录完成后，执行下面命令验证是否登录成功：
clawhub whoami
如果能正常显示当前账号信息，说明登录成功。
如果返回类似下面的提示，说明还没有登录成功：
Error: Not logged in. Run: clawhub login
五、ClawHub 常用基础命令
下面这些命令是后续安装技能时最常用的。
1. 查看帮助
clawhub --help
2. 搜索技能
clawhub search 关键词
例如：
clawhub search tavily
clawhub search github
clawhub search weather
3. 安装技能
clawhub install 技能slug
4. 查看已安装技能
clawhub list
5. 查看技能详情
clawhub inspect 技能slug
6. 更新已安装技能
clawhub update
7. 卸载技能
clawhub uninstall 技能slug
六、安装常用技能
下面是一组比较常见、适合在 OpenClaw 中使用的技能。安装前建议先搜索一次，确认技能 slug 是否与当前仓库中的名称一致。
1. self-improving-agent
作用：增强 Agent 的自我迭代、自我优化能力。
clawhub search self-improving-agent
clawhub install self-improving-agent
2. tavily-search
作用：联网页面搜索、实时信息检索。
clawhub search tavily-search
clawhub install tavily-search
有些仓库里也可能叫 tavily-web-search，如果前一个搜索不到，可以再查：
clawhub search tavily-web-search
3. gog
作用：Google Workspace 相关能力，如 Gmail、日历、Drive、Docs 等。
clawhub search gog
clawhub install gog
4. github
作用：GitHub 集成，便于处理仓库、Issue、PR 等。
clawhub search github
clawhub install github
5. summarize
作用：总结网页、PDF、图片、音频等内容。
clawhub search summarize
clawhub install summarize
6. find-skills
作用：帮助 Agent 搜索、推荐和发现技能。
clawhub search find-skills
clawhub install find-skills
7. ontology / agent-memory / memory
作用：用于记忆、知识图谱或结构化上下文管理。
这类技能在不同仓库里命名可能不一致，建议先分别搜索：
clawhub search ontology
clawhub search agent-memory
clawhub search memory
找到你需要的那个之后再安装，例如：
clawhub install ontology
8. weather
作用：天气查询，通常比较容易测试成功。
clawhub search weather
clawhub install weather
9. proactive-agent
作用：增强 Agent 主动规划和任务推进能力。
clawhub search proactive-agent
clawhub install proactive-agent
有些版本可能带后缀，例如：
clawhub search proactive-agent-1-2-4
10. skill-vetter / security-audit
作用：用于安装前审查技能内容，提升安全性。
同样可能存在不同命名，建议先搜索：
clawhub search skill-vetter
clawhub search security-audit
确认后再安装，例如：
clawhub install skill-vetter
七、推荐安装顺序
为了提高成功率，建议优先安装不依赖复杂外部授权的技能，再安装需要额外配置的技能。
第一组：优先安装
clawhub install weather
clawhub install summarize
clawhub install find-skills
clawhub install self-improving-agent
clawhub install proactive-agent
第二组：后续安装
clawhub install tavily-search
clawhub install gog
clawhub install github
第三组：先搜索再安装
clawhub search ontology
clawhub search agent-memory
clawhub search memory
clawhub search skill-vetter
clawhub search security-audit
确认 slug 后再执行安装。
八、一次性安装示例
如果你已经确认这些技能的 slug 都正确，可以按下面的顺序执行：
clawhub install weather
clawhub install summarize
clawhub install find-skills
clawhub install self-improving-agent
clawhub install proactive-agent
clawhub install tavily-search
clawhub install gog
clawhub install github
然后再对命名不确定的技能进行搜索：
clawhub search ontology
clawhub search agent-memory
clawhub search memory
clawhub search skill-vetter
clawhub search security-audit
九、安装完成后的验证方法
安装完成后，建议做以下检查。
1. 查看已安装技能列表
clawhub list
2. 查看某个技能的详细信息
clawhub inspect weather
clawhub inspect github
3. 更新技能
clawhub update
4. 验证当前登录状态
clawhub whoami
十、常见问题排查
1. 报错：Rate limit exceeded
含义：访问 ClawHub 仓库时触发了限流。
常见原因：
- 未登录，走的是匿名访问配额
- 短时间内重复安装、搜索过多
- 当前网络出口 IP 被限流
- 远端服务临时繁忙
处理方式：
clawhub whoami
如果没有登录，先执行：
clawhub login --token "你的_API_Key"
然后稍等几分钟再重试安装。
2. 报错：Not logged in
表示当前没有有效登录状态。
重新执行：
clawhub login --token "你的_API_Key"
clawhub whoami
3. 搜不到技能
可能原因：
- 技能 slug 拼写不对
- 技能名称与文章、截图里的名字不一致
- 技能已经改名或下架
建议做法：
clawhub search 关键词
先通过搜索确认再安装。
4. 某些技能安装后还不能直接使用
这是正常情况。部分技能安装完成后，还需要额外配置第三方账号或 API Key，例如：
tavily-search可能需要 Tavily API Keygog可能需要 Google 账号授权github可能需要单独完成 GitHub 认证ontology或memory类技能可能需要额外的存储配置
这类情况建议安装后再使用：
clawhub inspect 技能slug
先看说明，再继续配置。
十一、推荐操作流程汇总
如果你想从零开始快速完成配置，可以按下面顺序执行：
npm i -g clawhub
clawhub --help
clawhub login --token "你的_API_Key"
clawhub whoami
clawhub install weather
clawhub install summarize
clawhub install find-skills
clawhub install self-improving-agent
clawhub install proactive-agent
clawhub install tavily-search
clawhub install gog
clawhub install github
clawhub search ontology
clawhub search skill-vetter
clawhub list
十二、安全建议
- 不要把真实 API Key 写进文档、脚本、截图或 Git 仓库
- 不要把
clawhub login --token里的真实 token 直接分享给别人 - 如果怀疑 token 泄露，请立刻去 ClawHub 网站删除并重新生成
- 对不熟悉的技能，先
search、再inspect、最后再install
如果后续你还要补充 OpenClaw 的目录结构、技能生效位置、配置文件位置或多机同步方式，可以在这份文档基础上继续扩展。