课程大纲
课程大纲系列主页
学习进度已完成 0/12
04技能（Skills）与工具生态 · ClawHub 实战05写你的第一个自定义技能

技能（Skills）与工具生态 · ClawHub 实战

入门进行中

适用版本： OpenClaw v2026.4.11（stable） 验证日期： 2026-04-12 目标读者： 已接好至少一个渠道，想让 OpenClaw 能做真实任务 难度： ⭐ 入门 适合首次阅读： 是——装几个技能就能立刻感受到 AI 助手的真实能力

目标

学会从 ClawHub 挑选、安装、验证和管理技能，让 OpenClaw 能处理邮件、日历、文件、网页等真实任务。

完成后你不再只是和 AI 聊天，而是让它真正动手做事。

前置条件

  • 已完成本系列前面的章节
  • openclaw daemon status 显示运行中
  • 至少有一个能发消息的渠道（私聊测试技能更方便）

一、技能是什么（30 秒理解）

技能（Skill）是一个包含 SKILL.md 文件的目录，用 Markdown 教 OpenClaw 怎么做一件具体的事。

text
~/.openclaw/skills/
├── agentmail/
│   └── SKILL.md        ← 技能定义
├── web-researcher/
│   └── SKILL.md
└── daily-report/
    └── SKILL.md

一个最小可用的 SKILL.md：

markdown
---
name: daily-digest
description: 每天早上汇总新闻、天气和日程
user-invocable: true
---

当用户要求每日简报时：
1. 调用天气工具获取今日天气
2. 调用 RSS 工具抓取关注源的最新 5 条
3. 调用日历工具读取今日日程
4. 合并成一份 3 段简报返回

两部分：Frontmatter（YAML 元数据）告诉 OpenClaw 这个技能叫什么、能做什么；指令正文（Markdown）写给 AI 看的操作步骤。

OpenClaw 启动时把所有启用技能的 description 注入系统提示词。当你的消息匹配某个技能的描述时，AI 自动调用它；如果 user-invocable: true，也可以通过斜杠命令 /daily-digest 手动触发。

技能 vs 插件： 技能是 Markdown，指导 AI 行为；插件是 TypeScript/JS 代码，向 Gateway 注入新工具。90% 的需求用技能就够了，先不用管插件。

二、怎么挑：高质量技能的判断标准

ClawHub 是 OpenClaw 官方技能市场，截至 2026 年 4 月已收录 13,000+ 社区技能。自 2026 年 2 月起，ClawHub 集成了 VirusTotal 自动扫描来拦截恶意技能，但安装前仍建议你自己过一遍。

搜索技能

bash
# 关键词搜索
openclaw skills search email

# 查看技能详情（不安装）
openclaw skills info agentmail

也可以在 clawhub.ai 网页版按分类、标签、评分浏览。

五个判断维度

不是所有技能都值得装。安装前按这五条过：

维度怎么看为什么重要
维护频率最近 3 个月内有更新长期无人维护的技能可能和新版 OpenClaw 不兼容
依赖透明度Frontmatter 中的 requires-binary / requires-env 是否明确隐藏依赖会导致装了但跑不起来，排查成本高
权限边界SKILL.md 正文是否调用了 bash、system_command 等危险工具权限越大风险越大，个人使用可以接受，团队共享要审
适用任务description 是否精准描述了一个具体任务描述太泛的技能容易误触发，干扰其他技能
回滚成本是否只读你的数据，还是会写入/修改/删除只读技能随时卸载无副作用；写入型技能要确认它改了什么才能安全移除

💡 建议： 装之前花 30 秒看一眼 SKILL.md 源码。重点检查指令正文中是否有可疑的系统命令调用或外部 URL 请求。

让 OpenClaw 帮你挑技能

不确定该装什么？直接问你的 Bot：

💡 技能推荐 prompt（点击展开，复制发给 Bot）
text
帮我挑选适合我的 OpenClaw 技能。按步骤来：

[第 1 步：了解我的需求]
问我：
- 我主要用 OpenClaw 做什么（工作协作 / 个人助手 / 开发 / 内容创作）
- 最常重复的 3 个任务是什么
- 有没有已经在用但觉得不够好的技能

[第 2 步：搜索推荐]
根据我的回答，用 openclaw skills search 搜索相关技能。
每个推荐附上：技能名 / 一句话说明 / 为什么适合我。
推荐 3-5 个，不要超过 5 个。

[第 3 步：安全检查]
对每个推荐的技能，读一遍 SKILL.md 源码，检查：
- description 是否精准（不会误触发）
- 有没有可疑的系统命令或外部 URL
- 依赖是否透明
告诉我检查结果。

[第 4 步：安装]
我确认后，逐个安装并验证加载：
- openclaw skills install <name>
- openclaw skills list 确认出现
- 用斜杠命令触发一次确认可用

每步等我确认，不要一口气装完。

三、怎么装

从 ClawHub 安装 ✅ 必做

bash
openclaw skills install agentmail

命令会从 ClawHub 下载技能文件，验证 Frontmatter 格式，放到 ~/.openclaw/skills/agentmail/。

⚠️ 版本说明： openclaw skills install 默认安装最新版，适合快速体验。如果你需要锁定版本，可以用 openclaw skills install [email protected] 指定版本号。长期使用的技能建议记录当时验证通过的版本，避免自动更新引入不兼容变更。

独立 CLI 方式（不依赖 OpenClaw 守护进程）：

快速体验方案： npx clawhub@latest 每次运行都拉取最新 CLI。适合临时使用，但版本不固定。长期使用建议全局安装 npm i -g clawhub 后用 clawhub install。

bash
npx clawhub@latest install agentmail

从本地或 Git 安装 📌 可选

bash
# 本地技能：直接放到 skills 目录
mkdir -p ~/.openclaw/skills/my-skill
cp ~/Downloads/SKILL.md ~/.openclaw/skills/my-skill/

# 从 Git 仓库安装
# ⚠️ 请替换：换成你要安装的真实仓库地址
openclaw skills install --from-git https://github.com/username/skill-repo

装完后最短验证步骤

装完后跑这三步确认技能已加载并可触发：

bash
# 1. 确认技能出现在已安装列表中
openclaw skills list
# 应该看到你刚装的技能，状态为 enabled

# 2. 查看技能详情，确认 frontmatter 正确解析
openclaw skills info agentmail

# 3. 在聊天中触发（最关键的一步）
# 方式 A：斜杠命令直接调用（如果 user-invocable: true）
#   在聊天中发送 /agentmail
# 方式 B：用自然语言触发
#   发送"帮我检查最近的未读邮件"
# 如果 AI 调用了对应技能，说明加载成功

💡 建议： 如果自然语言没触发，先试斜杠命令。斜杠命令能触发说明技能已加载，只是 description 不够精准导致模型没匹配到——这种情况可以编辑 SKILL.md 改进描述。

四、怎么管理和移除

常用命令速查

bash
# 列出所有已安装技能
openclaw skills list

# 禁用技能（不删除文件，从系统提示词中移除）
openclaw skills disable agentmail

# 重新启用
openclaw skills enable agentmail

# 更新到最新版本
openclaw skills update agentmail

# 更新全部技能
openclaw skills update --all

# 彻底卸载（删除文件）
openclaw skills uninstall agentmail

数量控制

每个启用的技能都会向系统提示词注入描述。技能越多，每轮对话的有效上下文越少，AI 的触发准确率也会下降。建议保持 20 个以内活跃技能。

不常用但偶尔需要的技能，用 disable 代替 uninstall——文件还在，需要时一条命令启用。

技能加载位置与优先级

OpenClaw 按以下顺序扫描技能，同名技能高优先级覆盖低优先级：

  1. <workspace>/skills（最高）
  2. <workspace>/.agents/skills
  3. ~/.agents/skills
  4. ~/.openclaw/skills
  5. 内置技能
  6. skills.load.extraDirs 配置指定的目录（最低）

大部分情况只用关心 ~/.openclaw/skills/，这是 openclaw skills install 的默认安装位置。

五、推荐入门技能

以下是 ClawHub 上下载量和评分靠前的实用技能，按难度分级：

技能作用难度
summarize网页、文档、长文智能摘要⭐ 装完即用
obsidian连接 Obsidian vault，读写笔记⭐ 装完即用
github管理 Issue、PR、代码搜索⭐ 装完即用
agentmail邮件收发、分类、自动起草回复⭐⭐ 需配邮箱凭证
calendar-assistant日程查询、会议安排⭐⭐ 需配日历 API
agent-browser浏览器自动化：打开网页、填表单、抓数据⭐⭐ 需 Chrome

起步套餐（5 分钟）

bash
openclaw skills install summarize
openclaw skills install obsidian
openclaw skills install github

三个技能覆盖「信息获取、知识管理、开发协作」核心场景，装完即用无需额外配置。

💡 建议： 新装的技能前两三天特别关注触发情况。如果装了一周都没被 AI 主动调用过一次，要么需求不匹配，要么 description 不够具体——直接 disable，不要让它占用系统提示词空间。

验证清单

bash
# 1. 守护进程运行正常
openclaw daemon status

# 2. 已安装技能列表
openclaw skills list

# 3. 在聊天中成功触发
# 私聊 Bot 发送："/summarize" 或 "帮我总结一下这个链接的内容"

# 4. 查看日志确认技能执行
openclaw logs --follow

常见问题

Q: 安装了技能但 AI 不主动调用？

最常见原因是 description 不够具体，模型没匹配到。先试斜杠命令 /<技能名> 确认技能已加载。如果斜杠命令能触发但自然语言不行，可以编辑 ~/.openclaw/skills/<name>/SKILL.md 改进 description。注意：手动修改后 openclaw skills update 可能覆盖你的改动——建议 fork 一份改名。

Q: 技能报错说缺少依赖？

查看 SKILL.md 的 Frontmatter 中 requires-binary / requires-env 字段。前者需要安装对应的系统工具（如 ffmpeg、pandoc），后者需要配置环境变量（如 API Key）。

Q: 装太多技能会不会影响性能？

会。每个启用的技能都向系统提示词注入描述。建议保持 20 个以内活跃技能，不常用的 disable 掉。

Q: ClawHub 上找不到需要的技能？

自己写一个——技能只是 Markdown 文件，门槛很低。详见第 5 篇《写你的第一个自定义技能》。

Q: 技能的 preferred-model 是什么？

在 Frontmatter 中可以指定首选模型（使用 provider/model 格式，如 anthropic/claude-opus-4-6）。OpenClaw 会优先用这个模型执行该技能的任务，其他技能继续走默认路由。模型路由配置详见第 2 篇《架构核心概念与配置管理（打地基）》。

下一步

装了社区技能之后，你可能会想：能不能自己写一个专属技能？

去第 5 篇《写你的第一个自定义技能》，从零写一个 SKILL.md，掌握技能开发的完整生命周期。

技能（Skills）与工具生态 · ClawHub 实战 | 资讯狗 | Zixungou