第五章 Skills 技能系统
前提：本章假设你已完成第一章的安装配置。技能系统是 OpenClaw 的核心扩展机制，所有用户都建议了解。
OpenClaw 的技能系统就像手机的 App Store，让你可以为龙虾安装各种能力扩展。想让它查天气？安装天气技能。想让它管理 Gmail？安装邮件技能。截至 2026 年 3 月，社区维护的 ClawHub 注册表已有超过 16,000 个技能，覆盖生产力、开发、运维、内容创作等多个领域。
1. 什么是技能
技能（Skill）本质上是一组提示词指令的集合，以 SKILL.md 文件为核心。技能从三个位置按优先级加载：
- 工作区技能（workspace）：项目目录下的技能，优先级最高
- 托管技能（managed）：
~/.openclaw/skills/目录下通过clawhub安装的技能 - 内置技能（bundled）：OpenClaw 自带的基础技能（web-search、web-fetch、browser、filesystem、shell）
路径说明：
~/是 Linux/macOS 中"用户主目录"的简写。在 Windows 上对应C:\Users\你的用户名\。例如~/.openclaw/在 Windows 上就是C:\Users\你的用户名\.openclaw\。
每个技能包含两个核心部分：
元数据（YAML frontmatter）：文件顶部用 --- 包围的一段结构化信息，定义技能名称、描述、版本号等。你可以把它理解为技能的"身份证"，OpenClaw 通过它识别技能的基本信息。
提示词指令（Markdown 正文）：元数据下方的文本内容，教 OpenClaw 如何使用工具完成任务。比如"查询天气时优先使用用户所在城市"。Markdown 是一种简单的文本排版格式，类似于写笔记时用 # 表示标题、- 表示列表。
技能在会话启动时会被"快照"固定，确保本次对话中技能行为不变。技能配置统一存放在工作区级的 openclaw.json（JSON 格式）中，而非技能目录内部。
展开阅读：技能的形式化定义（学术视角，可跳过）
1.1 技能的形式化定义
从计算理论的视角，OpenClaw 的技能系统可以用有限自动机（Finite Automaton）来形式化描述。一个技能的生命周期可表示为一个确定性有限自动机（DFA）五元组：
其中：
- Q（状态集）= {Unregistered, Installed, Disabled, Gated, Active, HotReloading, SoftDeleted}，共 7 个状态
- Σ（输入字母表）= {install, uninstall, enable, disable, gate, grant, revoke, edit, hot-reload, soft-delete, restore}，共 11 个输入符号
- δ（转移函数）：定义状态之间的转换规则（见下方状态图）
- q₀（初始状态）= Unregistered
- F（接受状态集）=
状态转移关系如下：
Unregistered --install--> Installed --enable--> Active
Active --disable--> Disabled --enable--> Active
Active --gate--> Gated --grant--> Active
Gated --revoke--> Disabled
Active --edit--> HotReloading --hot-reload--> Active
Active --soft-delete--> SoftDeleted --restore--> Installed
Active --uninstall--> Unregistered
Disabled --uninstall--> Unregistered
SoftDeleted --uninstall--> Unregistered其中 Gated 状态表示技能需要满足门控条件（如 API Key 配置）才能激活，HotReloading 状态用于开发时实时编辑技能而不中断会话。
这个形式化模型的意义在于：
- 状态可预测：技能在任意时刻只能处于一个确定状态，避免了"薛定谔的插件"问题
- 转换可验证：每个操作（输入符号）只能在特定状态下执行，非法操作会被拒绝
- 生命周期可追踪：通过记录状态转移序列，可以完整还原技能的使用历史
- 会话一致性：技能在会话启动时快照固定，保证了行为的形式正则性（formal regularity）
参考文献：Agents as Automata（arxiv.org/html/2510.23487v1）将 Agent 行为建模为有限自动机，MetaAgent FSM（arxiv.org/html/2507.22606v1）进一步将此框架扩展到多 Agent 编排。
在实际使用中，clawhub install 会自动将技能从 Unregistered → Installed → Active（合并为一步），但底层仍然遵循这个状态机模型。
2. ClawHub：技能注册表
OpenClaw 社区维护了一个名为 ClawHub 的技能注册表（类似 npm 之于 Node.js），源码托管在 github.com/openclaw/clawhub。你可以通过 clawhub 命令行工具或 clawhub.ai 网站浏览和管理技能。
2.0 安装 clawhub CLI
clawhub 是 ClawHub 技能注册表的命令行工具，需要单独安装：
npm i -g clawhub安装后需要登录才能使用：
- 访问 clawhub.ai，注册并登录
- 点击右上角用户头像，选择 Settings
- 在设置页面找到 API tokens 栏，点击 Create token
- 复制生成的 Token（只显示一次，请立即保存）
- 在终端执行：
clawhub login --token <你的token>验证登录成功：
clawhub whoami2.1 浏览和搜索技能
# 列出所有可用技能
clawhub list
# 搜索特定类型的技能
clawhub search agent
clawhub search email
clawhub search database2.2 安装技能
安装技能有两种方式：
方式一：通过 clawhub CLI（推荐）
clawhub install weatherOpenClaw 会自动下载技能文件到 ~/.openclaw/skills/weather/，解析配置需求，然后引导你完成配置。
方式二：通过聊天粘贴 GitHub URL
直接在对话中粘贴包含 SKILL.md 的 GitHub 仓库 URL，OpenClaw 会自动识别并安装。
安装完成后可以立即测试：
帮我查一下明天的天气2.3 管理已安装的技能
# 查看已安装的技能
clawhub list
# 更新单个技能
clawhub update weather
# 更新所有技能
clawhub update --all
# 卸载技能
clawhub uninstall weather展开：技能文件结构详解（开发者参考）
3. 技能文件结构
3.1 SKILL.md 格式
每个技能的核心是一个 SKILL.md 文件，使用 YAML frontmatter 定义元数据：
---
name: weather
description: 查询全球城市天气预报和空气质量
version: 1.2.0
requirements:
- curl
---
# Weather Skill
当用户询问天气相关问题时，使用以下工具获取数据。
## 使用规则
1. 优先使用用户所在城市
2. 默认返回未来 3 天的天气
3. 如果用户关心空气质量，一并返回 AQI 数据
## 工具
### get_weather
- 参数：city (string), days (number, default: 3)
- 用途：获取指定城市未来 N 天的天气预报frontmatter 字段说明：
| 字段 | 说明 | 必填 |
|---|---|---|
| name | 技能标识符（即技能的唯一英文短名，如 weather），用于安装和引用 | 是 |
| description | 一句话功能描述 | 是 |
| version | 语义化版本号 | 是 |
| requirements | 系统依赖列表（如 python3, curl） | 否 |
| user-invocable | 是否可由用户通过斜杠命令手动调用 | 否 |
| disable-model-invocation | 禁止模型自动调用，只能用户手动触发 | 否 |
| metadata | 单行 JSON，定义门控条件等高级配置 | 否 |
3.2 目录结构
一个完整的技能目录结构：
~/.openclaw/skills/weather/
├── SKILL.md # 核心：技能说明和指令（唯一必需文件）
├── scripts/ # 可选：辅助脚本
│ └── fetch.sh
└── examples/ # 可选：使用示例
└── demo.md注意：技能目录内没有
config.yaml或tools.yaml。所有技能配置统一在工作区级的openclaw.json中管理，而非分散在各技能目录中。
4. 新手必装：十大推荐技能
ClawHub 上有超过 16,000 个技能，质量参差不齐——有的非常实用，有的只是披着 Skill 壳的模型伪装，甚至有的会窃取你的 API Key。以下是从中精选的 10 个安全且实用的技能，建议按顺序安装：
第一个必装：安全守卫
clawhub install skill-vetterSkill Vetter 会自动检测你后续安装的每一个技能，扫描是否存在危险行为（如窃取 API Key、上传个人信息）。请务必第一个安装它。
核心能力技能
| 序号 | 技能 | 安装命令 | 一句话说明 |
|---|---|---|---|
| 2 | Tavily Web Search | clawhub install tavily-search | 专为 Agent 设计的联网搜索，结果全、新、简洁 |
| 3 | Agent Browser | clawhub install agent-browser | 让龙虾打开浏览器，抓取信息、填写表单、操作网页 |
| 4 | Summarize | clawhub install summarize | 对网页、PDF、图像、音频、YouTube 等内容生成摘要 |
| 5 | Gog | clawhub install gog | Google 全家桶：Gmail、Calendar、Drive、Docs 一键打包 |
| 6 | GitHub | clawhub install github | PR 管理、Issue 追踪、代码搜索、仓库操作，开发者必备 |
| 7 | Obsidian | clawhub install obsidian | 接入本地 Obsidian 笔记库，整理笔记、知识关联 |
进阶能力技能
| 序号 | 技能 | 安装命令 | 一句话说明 |
|---|---|---|---|
| 8 | Self-Improving Agent | clawhub install self-improving-agent | 记录经验教训和纠正措施，让龙虾持续自我改进 |
| 9 | Proactive Agent | clawhub install proactive-agent | 赋予龙虾主动性，记住历史行为并根据环境变化自动执行任务 |
| 10 | Capability Evolver | clawhub install capability-evolver | 让龙虾自主进化——分析已有流程，在薄弱环节创造新 Skill 辅助迭代 |
一键安装全部：你也可以直接告诉龙虾"帮我安装 skill-vetter、tavily-search、agent-browser"，它会帮你逐个下载安装。
更多精选技能
ClawHub 上技能数量庞大，社区项目 awesome-openclaw-skills 从中精选了 5,000+ 个高质量技能，按场景分类，过滤了大量低质和危险技能。如果上面 10 个不够用，去那里逛逛。
5. 技能分类速查
以下按使用场景分类列出更多常用技能，方便按需选装：
5.1 生产力套件
| 技能 | 安装命令 | 功能 |
|---|---|---|
| Google Workspace (gog) | clawhub install gog | Gmail、Calendar、Drive、Docs、Sheets 统一访问 |
| Notion | clawhub install notion | 数据库、页面同步，长期记忆存储 |
| Todoist | clawhub install todoist | 任务管理、标签、优先级、周期规则 |
| Slack | clawhub install slack | 消息发送、频道管理、文件上传 |
| Obsidian | clawhub install obsidian | Markdown 笔记库管理，支持 wikilink |
5.2 开发工具
| 技能 | 安装命令 | 功能 |
|---|---|---|
| GitHub | clawhub install github | 仓库、Issue、PR 管理，REST API + GraphQL |
| Git Operations | clawhub install git-ops | 安全的 Git 命令执行 |
| Code Reviewer | clawhub install code-reviewer | Diff 分析、代码审查、Commit 消息生成 |
| SQL Toolkit | clawhub install sql-toolkit | PostgreSQL/MySQL/SQLite 只读查询 |
| CI/CD Pipeline | clawhub install cicd-pipeline | GitHub/GitLab/Jenkins 流水线控制 |
5.3 运维与基础设施
| 技能 | 安装命令 | 功能 |
|---|---|---|
| DevOps Toolkit | clawhub install devops | Docker 编排、进程管理、健康监控 |
| AWS Infrastructure | clawhub install aws-infra | EC2、S3、Lambda 对话式管理 |
| Azure DevOps | clawhub install azure-devops | 项目、仓库、看板、流水线管理 |
5.4 内容与社交
| 技能 | 安装命令 | 功能 |
|---|---|---|
clawhub install linkedin | 帖子生成、轮播图、定时发布 | |
| X (Twitter) | clawhub install x-api | 推文、线程、媒体附件 |
| Blogburst | clawhub install blogburst | 长文内容自动拆分为社交媒体帖子 |
5.5 个人助理
| 技能 | 安装命令 | 功能 |
|---|---|---|
| Weather | clawhub install weather | 天气、交通、航班实时数据 |
| Calendar Pro | clawhub install caldav-calendar | 多日历集成、冲突检测 |
| AgentMail | clawhub install agentmail | IMAP/SMTP 邮件管理、线程摘要、自动回复 |
| Home Assistant | clawhub install home-assistant | 智能家居设备控制 |
5.6 特殊技能
| 技能 | 安装命令 | 功能 |
|---|---|---|
| Playwright | clawhub install playwright | 无头浏览器自动化、表单填写、数据提取 |
| Hacker News | clawhub install hackernews | 技术新闻摘要和个性化推送 |
| Self-Improving | clawhub install self-improving | 记录成功/失败执行，自我优化模式识别 |
6. 配置技能
安装后可以随时修改技能配置。技能配置统一存放在工作区级的 openclaw.json 中：
{
"skills": {
"weather": {
"api_key": "your_api_key",
"default_city": "Beijing",
"units": "metric",
"language": "zh_CN"
}
}
}也可以通过交互式命令配置：
openclaw config对于需要 API Key 的技能，安装时会自动引导你输入。你也可以后续通过 openclaw config 或直接编辑 openclaw.json 修改。
展开：创建和发布自定义技能
7. 创建自定义技能
如果 ClawHub 上没有你需要的技能，可以自己创建。
7.1 最小化技能
创建一个查询 IP 地址的技能，只需要一个 SKILL.md：
---
name: my-ip
description: 查询当前公网 IP 地址和地理位置
version: 1.0.0
---
# IP 查询技能
当用户询问 IP 地址或网络位置时，执行以下命令：
curl -s https://ipinfo.io/json
返回结果中包含 IP、城市、地区、国家、运营商等信息。7.2 安装自定义技能
# 从本地目录安装
clawhub install ./my-ip
# 或直接复制到技能目录
cp -r my-ip ~/.openclaw/skills/7.3 发布到 ClawHub
如果你的技能对他人有用，可以提交到 ClawHub：
# 1. Fork github.com/openclaw/clawhub
# 2. 添加你的技能目录
# 3. 提交 Pull Request7.4 使用 Skill Seekers 自动生成技能
如果你想为特定技术栈或文档快速生成技能，可以使用 Skill Seekers 工具。它能自动将文档网站、GitHub 仓库、PDF 和视频转换为 Claude/Gemini/OpenAI Skills。
安装：
pip install skill-seekers从文档网站生成技能：
# 为 React 文档生成技能
skill-seekers create https://docs.react.dev/
# 从 GitHub 仓库生成
skill-seekers create facebook/react
# 从本地项目生成
skill-seekers create ./my-project导出为 OpenClaw 可用格式：
# 打包为 Claude Skill（可导入 OpenClaw）
skill-seekers package output/react --target claudeSkill Seekers 的优势：
- ⚡ 99% faster — 数天的手动准备 → 15-45 分钟
- 🎯 高质量 SKILL.md — 500+ 行的完整技能文件
- 📊 RAG-ready 分块 — 智能分块保留代码块和上下文
- 🌐 多源支持 — 文档 + GitHub + PDF + 视频
📖 更多信息：Skill Seekers GitHub
8. 飞书插件：技能实战案例
飞书官方插件是一个典型的复合技能，展示了技能如何深度集成外部服务。安装飞书插件后（安装步骤参见第三章 2.4 节），OpenClaw 不仅能通过飞书收发消息，还能直接操作飞书的办公数据：
| 能力 | 说明 |
|---|---|
| 消息 | 群聊/单聊历史搜索、消息发送、文件下载 |
| 文档 | 创建和编辑飞书云文档 |
| 多维表格 | 表格管理与数据操作（类似 Airtable） |
| 日程 | 日历查看、会议创建、忙闲查询 |
| 任务 | 任务和清单的创建与管理 |
使用示例：
帮我在飞书上创建一个项目周报文档，包含本周完成的任务和下周计划查看我今天的飞书日程，如果有冲突的会议帮我标记出来在项目管理多维表格中添加一条新任务：完成 API 文档编写，截止日期下周五这种深度集成体现了技能系统的核心价值：通过标准化的 SKILL.md 接口，将复杂的外部服务能力无缝注入 OpenClaw 的执行循环中。
展开：性能考量与安全提示
9. 技能系统的性能考量
技能并非越多越好。每个活跃技能都会增加上下文加载量，影响响应速度。
技能加载机制
OpenClaw 采用三级加载优先级：
| 优先级 | 来源 | 路径 | 说明 |
|---|---|---|---|
| 1（最高） | 工作区级 | ~/.openclaw/workspace/skills/ | 你手动放置或针对当前工作区安装的技能 |
| 2 | 共享级 | ~/.openclaw/skills/ | clawhub install 安装的全局技能 |
| 3（最低） | 内置级 | OpenClaw 安装目录 | 随 OpenClaw 一起发布的默认技能 |
同名技能按优先级覆盖——如果工作区有一个 web-search，它会屏蔽全局和内置的同名技能。
每次对话开始时，OpenClaw 会生成一份技能快照（snapshot），将所有活跃技能的 SKILL.md 内容注入上下文。技能采用懒加载策略：只有在对话中被触发（匹配到关键词或被 AI 主动选用）时，才会执行技能脚本。
性能影响与建议
| 技能数量 | 上下文占用 | 响应速度影响 | 建议 |
|---|---|---|---|
| 1-5 个 | 低 | 几乎无感 | 新手推荐 |
| 5-10 个 | 中等 | 略有延迟 | 日常使用合理上限 |
| 10-20 个 | 较高 | 明显变慢 | 建议禁用不常用的 |
| 20+ 个 | 很高 | 严重影响 | 不推荐 |
按需安装：只安装真正需要的技能。5-10 个常用技能是一个合理的数量。
定期清理：用 clawhub list 查看所有已安装技能，用 clawhub uninstall <技能名> 卸载不再使用的技能，保持系统精简。
# 查看当前安装了哪些技能
clawhub list
# 只看活跃的技能
clawhub list --active
# 卸载不需要的技能
clawhub uninstall old-unused-skill保护敏感信息：技能配置中的 API 密钥存储在本地，但仍要注意不要将 ~/.openclaw/skills/ 目录上传到公开仓库。
测试后再用：新安装的技能先在测试环境试用，确认没问题后再用于生产任务。对于未经审计的第三方技能，建议在 Docker 沙箱中运行。
Peringatan Keamanan: Audit keamanan pada bulan Februari 2026 (insiden ClawHavoc) menemukan bahwa sekitar 12% keterampilan di ClawHub memiliki perilaku jahat atau kerentanan keamanan. Tim OpenClaw sudah berbenah, namun Anda tetap harus waspada saat memasang skill pihak ketiga. Disarankan untuk mengutamakan keterampilan bintang tinggi dan memeriksa konten instruksi di SKILL.md.
Pasang Penjaga Keamanan: Sangat disarankan untuk menginstal skill-vetter (lihat Bagian 4 bab ini untuk rinciannya). Ini akan secara otomatis memindai setiap keterampilan yang Anda instal selanjutnya untuk mendeteksi apakah ada perilaku berbahaya seperti mencuri Kunci API dan mengunggah informasi pribadi:
clawhub install skill-vetterBaca selengkapnya: Hubungan antara keterampilan dan MCP
10. Hubungan antara skill dan MCP
Sistem keterampilan OpenClaw dan MCP (Model Context Protocol) adalah konsep pada dua tingkat berbeda:
- Keterampilan: Paket perintah pada tingkat kata cepat yang menentukan aturan perilaku Agen dan metode penggunaan alat
- MCP: Protokol proses tingkat alat, menyediakan antarmuka standar untuk alat eksternal
Saat ini, OpenClaw tidak mendukung MCP (Masalah terkait #4834 telah ditutup dengan status "tidak direncanakan"). Namun, sudah ada sejumlah besar pembungkus MCP di komunitas, yang dapat memaparkan kemampuan server MCP ke OpenClaw melalui antarmuka keterampilan.
Langkah selanjutnya: 第六章 外部服务集成