如果说 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 支持多个层级的技能目录,当同名技能出现冲突时,按以下优先级从高到低生效:
<workspace>/skills/(工作区级,仅对当前智能体生效,优先级最高)<workspace>/.agents/skills/(项目级)~/.agents/skills/(个人级,跨工作区生效)~/.openclaw/skills/(全局安装目录)- OpenClaw 内置技能(捆绑技能,优先级最低)
理解这一优先级机制,可以帮你为不同项目维护独立的技能配置,而不互相干扰。
三、从 ClawHub 安装社区技能
方式一:通过 Web 控制面板安装(推荐新手)
- 打开 OpenClaw Web 控制面板(
http://127.0.0.1:18789),进入 Skills 页面 - 在搜索框中输入技能名称或关键词(如”github”、”calendar”、”weather”)
- 点击目标技能,查看其描述、作者、版本和安装量
- 点击 Install 按钮,等待安装完成
- 安装后填写技能所需的配置项(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. 完成后向用户简要汇报结果
## 规则约束
- 执行任何操作前必须向用户确认
- 如果缺少必要输入,先向用户询问再继续
- 永远不要在未经明确指令的情况下删除文件
创建技能的四个步骤
- 创建技能目录:在
~/.openclaw/skills/下新建一个以技能名命名的文件夹 - 编写 SKILL.md:按上方结构填写元数据和指令
- 添加辅助脚本(可选):在
scripts/子目录中放置技能依赖的脚本文件,并在 SKILL.md 中用{baseDir}引用技能目录路径 - 测试技能:向 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 此后加强了审核机制,整体安全性明显提升,但风险并未完全消除。
安装任何社区技能前,建议执行以下检查清单:
- 阅读 SKILL.md 全文:重点检查是否有指令要求 AI 访问外部服务器或发送数据
- 检查 scripts/ 目录:如果包含
curl -s [外部URL] | bash这类命令,立即放弃安装 - 核查作者信息:查看作者的 GitHub 账号历史,注册时间不足一周的账号需格外谨慎
- 对比安装量与账号年龄:安装量异常高但账号很新的技能需要警惕
- 隔离测试后再上线:在测试环境中验证技能行为,确认无异常后再用于生产环境
- 查询安全公告:ClawHub 与 VirusTotal 有合作,可在技能页面查看安全扫描报告
总结
OpenClaw 的 Skills 系统是整个平台最具扩展性的部分:从 ClawHub 一键安装社区技能,到用 SKILL.md 从零创建专属功能,再到用 SOUL.md 塑造助手的个性——这套系统让每个人都能拥有一个真正量身定制的 AI 助手。
新手建议从安装 2~3 个高频使用场景的技能开始(如 google-calendar、weather、github),跑通基本工作流之后再逐步定制自己的专属技能。遇到问题随时运行 openclaw skills check 进行自动诊断,或访问 OpenClaw 中文版官网 获取更多中文技能资源和教程支持。