如果说 OpenClaw 的基础安装是让 AI 助手”活起来”,那么 Skills 技能系统就是让它真正变得”有用”的关键。一个没有任何技能的 OpenClaw 就像一部没装 App 的智能手机——可以打电话,但远未发挥潜力。本文将从技能系统的底层逻辑出发,带你掌握查找、安装、管理和自定义技能的完整流程。更多资源请访问 OpenClaw 中文版官网

一、什么是 OpenClaw Skills?

OpenClaw Skills(技能)是一套遵循 AgentSkills 规范的模块化扩展系统。每个技能本质上是一个文件夹,核心文件是一个名为 SKILL.md 的 Markdown 文件,里面包含 YAML 格式的元数据和自然语言写成的操作指令,告诉 AI 智能体在什么情况下激活该技能、如何一步步完成对应任务。

技能文件夹中除了 SKILL.md,还可以包含辅助脚本(scripts/ 目录)、配置文件和 API 集成所需的参考资源。当你安装一个技能后,OpenClaw 会在下次会话开始时自动扫描技能目录并加载——无需重启,无需改代码,安装即生效。

目前 ClawHub(OpenClaw 官方技能注册中心)已收录超过 5700 个社区贡献的技能,覆盖开发自动化、内容创作、智能家居、邮件管理、SEO 工具等几乎所有使用场景。

二、技能的加载优先级

OpenClaw 支持多个层级的技能目录,当同名技能出现冲突时,按以下优先级从高到低生效:

  1. <workspace>/skills/(工作区级,仅对当前智能体生效,优先级最高)
  2. <workspace>/.agents/skills/(项目级)
  3. ~/.agents/skills/(个人级,跨工作区生效)
  4. ~/.openclaw/skills/(全局安装目录)
  5. OpenClaw 内置技能(捆绑技能,优先级最低)

理解这一优先级机制,可以帮你为不同项目维护独立的技能配置,而不互相干扰。

三、从 ClawHub 安装社区技能

方式一:通过 Web 控制面板安装(推荐新手)

  1. 打开 OpenClaw Web 控制面板(http://127.0.0.1:18789),进入 Skills 页面
  2. 在搜索框中输入技能名称或关键词(如”github”、”calendar”、”weather”)
  3. 点击目标技能,查看其描述、作者、版本和安装量
  4. 点击 Install 按钮,等待安装完成
  5. 安装后填写技能所需的配置项(API Token、账号 ID 等),点击保存

方式二:通过 clawhub 命令行安装

在终端中使用 clawhub 工具安装技能,灵活性更高:

# 安装单个技能
npx clawhub install github-integration

# 安装指定版本
npx clawhub install github-integration@2.1.0

# 一次安装多个技能
npx clawhub install google-calendar spotify github-integration

# 从 GitHub 仓库直接安装
npx clawhub install github:username/my-skill

# 查看已安装的技能
openclaw skills list

# 更新所有技能到最新版本
clawhub update --all

# 卸载技能
npx clawhub remove github-integration

技能默认安装至 ~/.openclaw/skills/[技能名]/ 目录,每个技能拥有独立的子目录。

方式三:手动安装(适合从 GitHub 获取的技能)

# 克隆技能仓库
git clone https://github.com/username/skill-name ~/.openclaw/skills/skill-name

# 或手动创建目录并复制 SKILL.md
mkdir ~/.openclaw/skills/my-custom-skill
cp /path/to/SKILL.md ~/.openclaw/skills/my-custom-skill/

四、2026 年最受欢迎的技能推荐

以下是社区中使用率最高、口碑最好的技能,适合大多数用户作为入门选择:

开发者工具类

  • github:完整的 GitHub 工作流集成,支持 Issues、PR、代码审查、CI 监控
  • cron-backup:定时自动备份文件或目录,支持版本追踪和旧备份清理
  • security-check:安装前扫描技能安全漏洞,执行定期安全审计

内容创作类

  • blog-writer:长篇 SEO 博客写作,支持关键词密度控制
  • content-creator:带品牌调性的 SEO 营销内容生成
  • seo-audit:网站技术 SEO 健康检查与优化建议
  • cold-email:高度个性化的外发邮件序列生成

效率工具类

  • google-calendar:日历读写、会议安排和提醒管理
  • weather:通过 wttr.in 获取实时天气和预报
  • nano-pdf:用自然语言指令编辑和操作 PDF 文件
  • markdown-converter:将任意文档格式转换为 Markdown

多智能体协作类

  • agent-team-orchestration:编排多智能体团队,支持角色分工、任务交接和审查流程
  • agentdo:向其他 AI 智能体发布任务,或从任务队列中接取任务

五、常用技能管理命令

# 查看所有已安装技能
openclaw skills list

# 查看符合当前环境的可用技能
openclaw skills list --eligible

# 查看某个技能的详细信息
openclaw skills info github-integration

# 检查技能配置健康状态
openclaw skills check

六、创建你自己的自定义技能

任何人都可以创建自定义技能。整个过程不需要写代码,只需按照规范编写一个 SKILL.md 文件即可。

SKILL.md 基础结构

---
name: 我的自定义技能
description: 用一句话描述这个技能的功能
version: 1.0.0
requirements:
  - python3
---

## 使用场景
当用户提到 [触发词或触发条件] 时,激活此技能。

## 操作步骤
1. [第一步,写清楚具体操作]
2. [第二步]
3. 完成后向用户简要汇报结果

## 规则约束
- 执行任何操作前必须向用户确认
- 如果缺少必要输入,先向用户询问再继续
- 永远不要在未经明确指令的情况下删除文件

创建技能的四个步骤

  1. 创建技能目录:在 ~/.openclaw/skills/ 下新建一个以技能名命名的文件夹
  2. 编写 SKILL.md:按上方结构填写元数据和指令
  3. 添加辅助脚本(可选):在 scripts/ 子目录中放置技能依赖的脚本文件,并在 SKILL.md 中用 {baseDir} 引用技能目录路径
  4. 测试技能:向 OpenClaw 发送一条触发该技能的消息,观察执行结果

写好技能后,如果想分享给社区,可以 Fork github.com/openclaw/clawhub,将技能文件夹添加进去并提交 PR。

写好 SKILL.md 的核心原则

把 SKILL.md 想象成给一位”非常字面执行”的厨师写的菜谱——AI 会照字执行,所以指令必须明确无歧义。以下几点尤为重要:

  • 触发条件要具体,避免与其他技能产生歧义
  • 操作步骤要详尽,边界情况要单独说明
  • 用”规则约束”章节固化你永远不想让 AI 逾越的底线
  • 在发布到社区前,在多个不同场景下充分测试

七、SOUL.md:定义助手的”灵魂”

除了技能系统,OpenClaw 还有一个特殊文件 SOUL.md,存放在 ~/clawd/ 目录下。它与技能的作用截然不同:

  • 技能(Skills):定义助手”能做什么”,是可安装/卸载的行为模块
  • SOUL.md:定义助手”是什么”,是每次推理循环都会优先加载的助手”宪法”

你可以在 SOUL.md 中定义助手的沟通风格(正式/轻松/简洁/详细)、价值观和伦理规则(”永远不要未经确认就删除文件”)、称呼方式和人格特质。所有技能的执行都必须在 SOUL.md 设定的边界内进行。

OpenClaw 提供了 SOUL.md 模板,花 10 分钟定制一份,是让助手真正”符合你个人风格”的最高效投资。

八、技能安全:使用前必须知道的事

2026 年初,安全研究人员在 ClawHub 中发现了约 1467 个恶意技能,占当时注册量的 3% 左右,其中 91% 同时包含提示注入和传统恶意代码。ClawHub 此后加强了审核机制,整体安全性明显提升,但风险并未完全消除。

安装任何社区技能前,建议执行以下检查清单:

  1. 阅读 SKILL.md 全文:重点检查是否有指令要求 AI 访问外部服务器或发送数据
  2. 检查 scripts/ 目录:如果包含 curl -s [外部URL] | bash 这类命令,立即放弃安装
  3. 核查作者信息:查看作者的 GitHub 账号历史,注册时间不足一周的账号需格外谨慎
  4. 对比安装量与账号年龄:安装量异常高但账号很新的技能需要警惕
  5. 隔离测试后再上线:在测试环境中验证技能行为,确认无异常后再用于生产环境
  6. 查询安全公告:ClawHub 与 VirusTotal 有合作,可在技能页面查看安全扫描报告

总结

OpenClaw 的 Skills 系统是整个平台最具扩展性的部分:从 ClawHub 一键安装社区技能,到用 SKILL.md 从零创建专属功能,再到用 SOUL.md 塑造助手的个性——这套系统让每个人都能拥有一个真正量身定制的 AI 助手。

新手建议从安装 2~3 个高频使用场景的技能开始(如 google-calendar、weather、github),跑通基本工作流之后再逐步定制自己的专属技能。遇到问题随时运行 openclaw skills check 进行自动诊断,或访问 OpenClaw 中文版官网 获取更多中文技能资源和教程支持。