OpenClaw 实战指南

Appearance

9.2 从 ClawHub 安装技能 ​

上一节你知道了 Skills 是什么。但光知道概念没用，你得会装、会用。

想象一下这个场景：

你刚配置好 OpenClaw，想让它帮你查一下竞品的最新动态。

你问：“帮我搜索某某公司的最新产品发布”

OpenClaw 回复：“抱歉，我无法访问互联网，无法进行搜索。”

你有点失望——这 AI 怎么连网都上不了？

不是 AI 不行，是没装 Skills。

这就像你买了一台新电脑，但没装浏览器、没装 Office，当然什么也干不了。

ClawHub 是 OpenClaw 的官方技能市场，拥有 700+ 社区贡献的技能包。这一节，我们用15分钟，学会从 ClawHub 安装技能，让你的 OpenClaw 真正“长出手脚”。

准备工作 ​

开始前，确认你有：

  • Node.js 环境（Node 18+）
  • OpenClaw 已安装并运行
  • 约 15 分钟时间

第一步：安装 ClawHub CLI ​

ClawHub 提供了命令行工具，方便你搜索、安装、管理 Skills。

1.1 安装命令 ​

bash
npm i -g clawhub

或者用 pnpm：

bash
pnpm add -g clawhub

1.2 验证安装 ​

bash
clawhub --version

看到版本号输出，说明安装成功。

第二步：搜索技能 ​

不知道装哪个？先搜索。

2.1 基本搜索 ​

bash
clawhub search "calendar"

2.2 自然语言搜索 ​

ClawHub 使用向量搜索，支持自然语言描述：

bash
clawhub search "send email"
clawhub search "postgres backup"
clawhub search "flight search"

2.3 搜索结果解读 ​

搜索结果会显示：

字段说明
名称Skill 的显示名称
slug安装标识（如 tavily-search）
描述功能简介
下载量社区使用热度
作者开发者信息

第三步：安装技能 ​

找到想要的 Skill 后，用 slug 安装。

3.1 基本安装 ​

bash
clawhub install tavily-search

3.2 指定版本 ​

bash
clawhub install tavily-search --version 1.2.0

3.3 强制覆盖 ​

如果 Skill 已存在，想重新安装：

bash
clawhub install tavily-search --force

3.4 安装位置 ​

默认情况下，Skills 安装到当前目录的 ./skills 文件夹。如果配置了 OpenClaw 工作区，会安装到工作区的 skills 目录。

试一试：安装第一个 Skill ​

让我们安装一个实用的联网搜索技能，让 OpenClaw 能上网查资料。

步骤 1：搜索 ​

bash
clawhub search "web search"

从结果中找到 tavily-search。

步骤 2：安装 ​

bash
clawhub install tavily-search

步骤 3：重启会话 ​

安装完成后，启动一个新的 OpenClaw 会话，新 Skill 才会生效。

步骤 4：测试 ​

在对话中输入：

搜索今天的科技新闻

如果 Skill 安装成功，OpenClaw 会调用搜索工具返回结果。

管理已安装的技能 ​

查看已安装 ​

bash
clawhub list

这会读取 .clawhub/lock.json，显示当前工作区安装的所有 Skills 及其版本。

更新单个技能 ​

bash
clawhub update tavily-search

更新所有技能 ​

bash
clawhub update --all

注意：更新前建议查看变更日志，特别是涉及权限、凭据、命令执行的 Skills。

热门技能推荐 ​

根据社区反馈和使用场景，以下 Skills 被高频推荐：

Skill用途推荐理由
tavily-search联网搜索“没这个跟瞎子一样”，AI 优化版搜索
githubGitHub 集成管理 repo、issue、PR，开发者必备
gogGoogle WorkspaceGmail、日历、Drive 全家桶
skill-vetter安全扫描安装前扫描技能安全性
find-skills自动找技能让 Agent 自己去 ClawHub 搜索安装
proactive-agent主动式 Agent加记忆和自我迭代能力
feishu-doc飞书集成国内用户常用，文档/云盘操作

套装推荐：

bash
# 开发者套装
clawhub install github
clawhub install tavily-search

# 办公自动化套装
clawhub install gog
clawhub install feishu-doc

# 安全必备
clawhub install skill-vetter

700+ 技能库生态 ​

ClawHub 目前的 Skills 覆盖以下领域：

  • 搜索与研究（300+）：论文整理、竞品分析、数据爬取
  • 开发工具（1000+）：代码审查、自动化测试、部署脚本
  • PDF 处理（100+）：合同生成、发票处理、文档转换
  • 市场销售（100+）：亚马逊 FBA、供应商管理、客户跟进
  • 财务记账（50+）：预算管理、交易分类、报表生成
  • 生活助手（200+）：航班查询、天气、健康管理

GitHub 上的 awesome-openclaw-skills 仓库还提供了按场景的精选清单，方便你发现适合的技能。

故障排查 ​

安装失败 ​

检查清单：

  • [ ] Node.js 版本是否 18+：node --version
  • [ ] npm/pnpm 是否能正常访问网络
  • [ ] 是否有写入权限：检查当前目录是否可写
  • [ ] 查看详细错误：clawhub install <slug> --verbose

安装后 Skill 不生效 ​

检查清单：

  • [ ] 是否重启了 OpenClaw 会话
  • [ ] Skill 是否安装到正确的目录
  • [ ] 运行 clawhub list 确认安装成功
  • [ ] 检查 Skill 是否需要额外配置（如 API Key）

搜索无结果 ​

检查清单：

  • [ ] 网络是否正常连接
  • [ ] 关键词是否准确（尝试英文关键词）
  • [ ] 换个描述方式搜索（向量搜索支持自然语言）

Skill 运行报错 ​

检查清单：

  • [ ] 查看 Skill 文档，确认所需凭据已配置
  • [ ] 检查 API Key 是否有效
  • [ ] 查看日志获取详细错误：openclaw logs --follow

对话示例 ​

安装 tavily-search 后的对话：

你：搜索一下 OpenAI 最新发布的产品

OpenClaw：我来帮你搜索...

[调用 tavily-search 工具]

根据搜索结果，OpenAI 最近发布了：
1. GPT-4 Turbo with Vision - 支持图像理解的新模型
2. DALL-E 3 - 图像生成能力集成到 ChatGPT
3. Whisper v3 - 语音识别模型更新

详细信息可以查看官方博客...

安装 github 后的对话：

你：帮我查看 my-repo 项目最近有哪些未处理的 issue

OpenClaw：我来查询...

[调用 github 工具]

my-repo 当前有 5 个未处理的 issue：

#127 - 登录页面加载缓慢 (high priority)
#125 - 移动端适配问题
#123 - 文档需要更新
#120 - 新功能请求：导出 PDF
#118 - 小 bug 修复

建议优先处理 #127，是否需要我查看详情？

这一节，你做了什么 ​

做了什么核心命令
安装 ClawHub CLInpm i -g clawhub
搜索技能clawhub search “关键词”
安装第一个技能clawhub install tavily-search
查看已安装clawhub list
更新技能clawhub update --all

关键提醒：

  • 安装后需要重启 OpenClaw 会话才能生效
  • 安装前建议查看 Skill 的文档，了解需要的权限和凭据
  • 不要一次性安装太多 Skills，先装 2-3 个核心需求的

下一节 ​

如果现有的 Skills 都不能满足你的需求？

下一节，我们来学习编写自己的 Skill。

基于 MIT 许可发布

Copyright © 2025 Gleam2Torch