#11 OpenClaw Skills 技能系统入门

🎯 什么是 Skills 技能系统？

在前几篇文章中，我们已经了解了 OpenClaw 的核心架构和工作区概念。今天，我们要深入探讨 OpenClaw 最强大的特性之一——Skills（技能）系统。简单来说，Skills 就是告诉 AI「什么时候该用什么工具」的指令包，它让 OpenClaw 从一个通用助手变成真正的领域专家。

想象一下：你请了一个全能管家，但他需要一本「操作手册」才知道如何泡咖啡、整理文件或处理快递。Skills 就是这本操作手册——每个技能目录里包含一个 SKILL.md 文件，里面详细描述了该技能的用途、使用方法和注意事项。

📦 Skills 的目录结构

每个 Skill 都是一个独立的目录，通常包含以下文件：

skills/
  my-skill/
    SKILL.md          # 核心指令文件（必须有）
    scripts/          # 可选：辅助脚本
    references/       # 可选：参考文档
    README.md         # 可选：说明文档

其中 SKILL.md 是灵魂文件。它使用自然语言编写，告诉 AI：

• 这个技能是做什么的
• 什么时候应该激活它
• 具体的执行步骤
• 注意事项和边界条件

🔧 如何安装 Skills？

OpenClaw 提供了 ClawHub 作为技能的包管理器。安装技能非常简单：

# 从 ClawHub 搜索技能
clawhub search weather

# 安装技能
clawhub install weather

# 更新技能
clawhub update weather

# 查看已安装的技能
clawhub list

安装后，技能会被放置在 ~/.openclaw/skills/ 目录下。OpenClaw 在每次对话开始时会扫描所有已安装的技能，并根据用户的输入自动匹配最合适的技能。

🛠️ 内置技能一览

OpenClaw 自带了一套丰富的内置技能，覆盖了日常使用的大部分场景：

开发类技能

• coding-agent — 委托 Codex、Claude Code 等编码代理完成复杂编程任务
• github — 通过 gh CLI 操作 GitHub（Issues、PRs、CI 等）
• mcporter — 配置和调用 MCP 服务器工具

内容与文档类技能

• feishu-doc — 飞书文档读写操作
• feishu-wiki — 飞书知识库导航
• nano-pdf — 自然语言编辑 PDF

监控与运维类技能

• blogwatcher — 监控博客和 RSS/Atom 更新
• healthcheck — 主机安全审计和风险配置
• weather — 天气查询（通过 wttr.in 或 Open-Meteo）

社交媒体类技能

• xurl — X（Twitter）API 操作（发推、搜索、私信等）
• qqbot-media — QQ Bot 媒体收发

✍️ 如何创建自定义 Skill？

创建自定义技能非常简单，只需要三个步骤：

第一步：创建目录结构

mkdir -p ~/.openclaw/skills/my-custom-skill
cd ~/.openclaw/skills/my-custom-skill

第二步：编写 SKILL.md

# My Custom Skill

## Description
这是一个自定义技能，用于处理特定任务。

## When to Use
- 当用户说"..."时激活
- 当需要执行特定操作时激活

## Instructions
1. 首先检查...
2. 然后执行...
3. 最后返回...

## Notes
- 注意事项1
- 注意事项2

第三步：添加辅助文件（可选）

如果需要，可以在 scripts/ 目录下添加辅助脚本，在 references/ 目录下添加参考文档。

💡 最佳实践

• 精准触发 — 在 SKILL.md 的 "When to Use" 部分明确列出触发条件，避免技能被误激活
• 职责单一 — 每个技能只做一件事，复杂的组合通过多个技能协作实现
• 善用约束 — 在 SKILL.md 中明确标出"不要做什么"，和"做什么"同等重要
• 定期更新 — 工具和 API 会变化，保持技能文档同步更新
• 参考已有技能 — 查看内置技能的 SKILL.md，学习结构和写法

🔍 Skills 的匹配机制

OpenClaw 的技能匹配是基于描述（Description）的语义匹配。每个技能的 SKILL.md 开头通常有一个 description 字段，系统会将用户输入与这些描述进行匹配，选择最合适的技能。这意味着：

• 技能描述写得越精准，匹配效果越好
• 使用自然语言而非关键词堆砌
• 多技能同时存在时，系统会选择最具体（最相关）的那个

📚 总结

Skills 技能系统是 OpenClaw 扩展能力的核心机制。通过 Skill，你可以：

• 让 AI 知道什么时候该用什么工具
• 为特定领域定制专业的操作指南
• 通过 ClawHub 快速安装和分享技能
• 创建自己的专属技能，打造个性化 AI 助手

在下一篇文章中，我们将深入探讨 OpenClaw 的工具调用机制，了解 AI 是如何真正执行这些技能指令的。