- ✓ 理解 Skills 是什么
- ✓ 安装第一个 Skill
- ✓ 使用已安装的 Skill
学习目标
理解 Skills 的概念，学会用终端命令从 ClawHub 搜索、安装和管理 Skill，让小龙虾拥有更多新能力。
概念解释
你的手机刚买来的时候，只能打电话、发短信。但是去应用商店装了微信就能聊天，装了美团就能点外卖，装了抖音就能刷视频——每装一个 App，手机就多一个能力。
OpenClaw 的 Skills 也是一样的道理：
- Skills 就是包含
SKILL.md文件的文件夹，遵循统一的 AgentSkills 兼容格式 - ClawHub（clawhub.com）就是 OpenClaw 的”应用商店”，是官方的 Skills 注册中心
- 小龙虾”出厂”时能聊天、能写东西、能翻译，但装上新的 Skill 之后，它就多了更多本领
- 跟手机 App 一样，想装就装，不想用就卸掉，非常灵活
Skills 存放在哪里？
Skills 有三个安装位置，小龙虾会按顺序查找：
- 项目级：你的项目文件夹下的
/skills目录——只对当前项目生效 - 全局级：
~/.openclaw/skills目录——对你所有项目都生效 - 捆绑技能：随 OpenClaw 安装一起发布的内置技能——开箱即用
这就像手机上的 App：有的装在手机内存里（项目级），有的装在 SD 卡上（全局级），还有的系统自带（捆绑技能）。
动手做
第一步：搜索想要的 Skill
ClawHub 上有很多别人开发好的 Skill，就像应用商店一样可以搜索。打开终端（不是聊天窗口！），输入：
openclaw skills search 图片小龙虾会去 ClawHub 上帮你搜索跟”图片”相关的所有 Skill，列出名称和简介。
再试试搜索其他关键词：
openclaw skills search 文件
openclaw skills search 翻译小贴士： 所有 Skills 管理命令都是在终端里运行的，不是在跟小龙虾的聊天窗口里输入的哦！
第二步：查看已安装的 Skills
在终端中运行：
openclaw skills list小龙虾会列出当前已经安装的所有 Skills，包括名称、版本和简要说明。刚装好的 OpenClaw 可能只有几个捆绑的基础 Skill，不用担心，我们马上来装新的。
第三步：安装一个 Skill
找到想要的 Skill 后，用 install 命令安装：
openclaw skills install image-lab等待安装完成，终端会提示安装成功。安装完成后，可以再用 openclaw skills list 确认新 Skill 已经出现在列表中。
如果想知道某个 Skill 的详细信息：
openclaw skills info image-lab它会告诉你这个 Skill 能做什么、需要什么配置、有没有依赖项。
第四步：在配置文件中启用 Skill
有些 Skill 安装后还需要在配置文件中启用。打开 OpenClaw 的配置文件，添加 skills 配置：
{
skills: {
entries: {
"image-lab": {
enabled: true,
// 有些 Skill 需要提供 API Key
env: { GEMINI_API_KEY: "你的key" },
}
}
}
}enabled: true表示启用这个 Skillenv里可以设置 Skill 运行时需要的环境变量（比如 API Key）
注意： 不是所有 Skill 都需要额外配置，简单的 Skill 安装完就能直接用。
第五步：检查 Skill 状态
安装了多个 Skill 之后，可以用 check 命令一次性检查它们的状态：
openclaw skills check这个命令会告诉你：
- 哪些 Skill 已经准备就绪，可以正常使用
- 哪些 Skill 还缺少依赖或配置，需要你补充
就像手机里”应用更新”的提示一样，帮你掌握所有 Skill 的健康状态。
关于 Web Search 的特别说明
上一课我们发现，AI 无法获取实时信息。你可能会想”那我去装一个搜索 Skill 吧”——但其实，Web Search 不是通过安装 Skill 获得的！
Web Search 是 OpenClaw 内置的搜索功能，需要在配置中开启。有两种方式：
- 在初始化向导（onboard wizard）中配置——第一次运行 OpenClaw 时会引导你设置
- 在配置文件中手动设置——指定搜索提供商和对应的 API Key
OpenClaw 支持多个搜索提供商，包括：Perplexity、Brave、Gemini、Grok、Kimi 等。选择你有的 API Key 对应的服务即可。
常用的 Skills 管理命令速查
| 你想做什么 | 终端命令 |
|---|---|
| 搜索 Skill | openclaw skills search [关键词] |
| 安装 Skill | openclaw skills install <名称> |
| 查看已安装 | openclaw skills list |
| 查看 Skill 详情 | openclaw skills info <名称> |
| 更新单个 Skill | openclaw skills update <名称> |
| 更新所有 Skill | openclaw skills update --all |
| 检查 Skill 状态 | openclaw skills check |
就像管理手机 App 一样简单，只不过操作的地方是终端而不是应用商店的图形界面。
检查你的成果
完成以上步骤后，你应该做到：
- 理解 Skills 是什么，能用自己的话解释（“就是给小龙虾装的 App”）
- 知道 ClawHub 是什么（“就是小龙虾的应用商店”）
- 成功用终端命令搜索和安装了一个 Skill
- 知道 Web Search 是配置项，不是 Skill
- 掌握了 Skills 的常用终端管理命令
常见失败排查
1. openclaw skills search 报错「连接失败」
原因： 网络问题，无法连接到 ClawHub（clawhub.com）。
解决： 检查网络连接是否正常。如果使用了代理，确保终端也配置了正确的代理设置。
2. Skill 安装成功但不工作
原因： 某些 Skill 需要额外的配置才能运行，比如需要提供 API Key 或者其他环境变量。
解决： 运行 openclaw skills check 查看哪些 Skill 缺少配置，然后根据提示在配置文件中补充需要的信息。
3. Skill 安装后提示「缺少依赖」
原因： 这个 Skill 依赖其他程序或库，你的电脑上还没有安装。
解决： 运行 openclaw skills info <名称> 查看这个 Skill 需要哪些依赖，然后按照说明安装对应的依赖。
4. 以为 Web Search 要用 install 安装
原因： 把 Web Search 当成了 Skill。
解决： Web Search 是 OpenClaw 的内置功能，不是 Skill。它需要在配置文件中设置搜索提供商和 API Key，或者在初始化向导中完成配置。
挑战任务
浏览 ClawHub 上的 Skills 列表（用 openclaw skills search 多搜几个关键词），找一个你觉得日常生活中最有用的 Skill，安装它，然后运行 openclaw skills check 确认它是否准备就绪。如果有缺少的配置，试着补全它。