夜雨聆风OpenClaw 入门到精通 · 第 4 章 / 共 7 章
🔌 Skills 技能系统：像装 App 一样扩展助理能力
01 技能系统的设计哲学
为什么不把所有功能都内置进去？这是一个很好的问题。答案是：不同的人有完全不同的需求。一个程序员需要代码审查技能，一个编辑需要排版规范技能，一个销售需要 CRM 集成技能。如果把所有可能的功能都内置，助理会变得臃肿，每次对话都要加载海量的"说明书"，既慢又贵。
技能系统的核心设计理念是"按需加载"。每个技能本质上是一个 SKILL.md 文件——一套专业操作指南，告诉助理"在这个特定场景下，应该怎么做才最专业"。助理只在需要时加载相关技能，平时保持轻量。
自动激活原理：每次对话开始时，助理会扫描所有已安装技能的 description 字段，判断哪个技能和当前对话的意图匹配，然后自动加载对应的完整技能指南。全程对用户透明——你不需要手动"开启某个技能"，只需要自然说话，助理自动识别。
实际体验：你对助理说"帮我读一下这个飞书文档的内容"，后台自动激活 feishu-doc 技能，助理立刻按照飞书文档的专业操作流程来处理，准确率和稳定性大幅提升。你完全感知不到这个过程，就像你对 Siri 说"帮我播放音乐"，不需要知道背后调用了哪个音乐 App 的 API。
02 8 个内置技能详解
OpenClaw 安装时自带以下 8 个技能，覆盖最常见的工作场景：
feishu-doc — 飞书云文档读写
触发场景：你提到"飞书文档"、"云文档"、"docx"，或者给了一个飞书文档链接。
能做什么：创建文档、读取文档内容、向文档写入格式化内容（标题、正文、列表、代码块等），精准操作文档结构。示例："帮我把这份大纲写成一篇完整的飞书文档"。
feishu-wiki — 知识库操作
触发场景：提到"知识库"、"wiki"，或者给了一个飞书知识库链接。
能做什么：在知识库中创建页面、读取知识库内容、组织知识结构。适合团队用飞书知识库做文档管理的场景。示例："把这份产品文档整理到我们团队的知识库里"。
feishu-drive — 云盘文件管理
触发场景：提到"云盘"、"文件夹"、"上传"、"下载"。
能做什么：列出云盘文件、在文件夹间移动文件、管理云盘结构。示例："帮我整理一下飞书云盘里的文件，把旧项目文件夹归档到 2024-Archive 里"。
feishu-perm — 权限管理
触发场景：提到"分享"、"权限"、"协作者"、"只读"、"编辑权限"。
能做什么：给文档添加或删除协作者、修改权限级别（查看/评论/编辑）、获取文档分享链接。示例："帮我把这个文档分享给设计团队，只读权限"。
weather — 全球天气查询
触发场景：提到"天气"、"气温"、"下雨"、"要不要带伞"。
能做什么：查询全球任意城市的当前天气和未来几天预报。基于 Open-Meteo 和 wttr.in，不需要 API Key，免费使用。示例："上海明天天气怎么样，需要带伞吗？"
healthcheck — 系统安全审计
触发场景：提到"安全检查"、"系统安全"、"防火墙"、"SSH"。
能做什么：自动检查你的系统安全配置，包括防火墙状态、SSH 配置、系统更新情况、敏感文件权限。输出风险等级和修复建议。示例："帮我做一次系统安全检查"。第七章会详细介绍。
nano-pdf — 自然语言编辑 PDF
触发场景：提到"PDF"、"编辑 PDF"、"在 PDF 上加内容"。
能做什么：用自然语言指令编辑 PDF 文件，无需专业 PDF 软件。示例："帮我在这份合同 PDF 的第 3 页结尾加一段免责声明"。
skill-creator — 技能编写助手
触发场景：提到"创建技能"、"写一个新技能"、"帮我定制一个功能"。
能做什么：引导你创建符合规范的自定义技能。如果你有重复性的专业任务想要固化，用这个技能来生成你的第一个自定义技能文件。
03 从 ClaWHub 安装社区技能
除了内置技能，OpenClaw 还有一个社区技能市场——ClaWHub（clawhub.com），类似 App Store，里面有社区用户贡献的各种技能：Notion 集成、GitHub 操作、邮件管理、日历同步等等。
安装方法很简单：
在 ClaWHub 找到你想要的技能，下载 SKILL.md 文件
在本地创建技能目录：
mkdir -p ~/.openclaw/skills/my-skill-name把下载的 SKILL.md 放入该目录：
mv ~/Downloads/SKILL.md ~/.openclaw/skills/my-skill-name/
重启 OpenClaw 网关：
openclaw gateway restart重启后技能立即生效，开始对话时自动识别触发。04 自己写一个技能
什么时候需要自己写技能？当你有一个高频重复的专业任务，每次都要给助理解释"怎么做"，不如把"怎么做"固化成一个技能文件，以后自动加载。
技能目录结构：
~/.openclaw/skills/ — 所有技能的根目录~/.openclaw/skills/my-skill/ — 你的技能目录~/.openclaw/skills/my-skill/SKILL.md — 核心文件~/.openclaw/skills/my-skill/references/ — 可选：参考文档~/.openclaw/skills/my-skill/scripts/ — 可选：辅助脚本SKILL.md 的结构非常简单：
name: weekly-report
description: 生成工作周报。当用户提到"周报"、"本周总结"、"工作汇报"时触发。
工作流程
1. 读取本周的日志文件（~/work/logs/YYYY-MM-DD.md）
2. 提取完成的任务、遇到的问题、下周计划
3. 按公司周报模板格式整理
4. 询问用户是否需要发送到飞书
输出格式
• 本周完成：...
• 遇到的挑战：...
• 下周计划：...
最重要的部分是 description 字段。这是助理判断"是否激活这个技能"的唯一依据——当你说的话和 description 里描述的场景匹配，技能就自动激活。所以 description 要写清楚：在什么情况下触发，用户可能说哪些关键词。
实战提示：不确定怎么写？直接对助理说"帮我写一个技能，功能是xxx"，skill-creator 技能会自动激活，引导你一步步创建符合规范的技能文件。
小结
技能 = SKILL.md 文件，告诉助理在特定场景下如何专业操作
自动激活，无需手动开关，自然对话即可触发
8 个内置技能覆盖飞书操作、天气、安全审计、PDF 编辑等场景
ClaWHub 社区市场持续增加新技能，下载放入目录即可用
自己写技能：SKILL.md + 准确的 description = 自定义专属工作流
下一章，我们进入进阶玩法：Heartbeat 心跳机制、Cron 定时任务、子代理并行——让助理在你睡觉时也在工作。
你最想给助理装什么技能？欢迎在评论区分享你的想法，说不定下篇就是这个主题！
📚 OpenClaw 入门到精通系列 · 第 4 章 共 7 章公众号：码上驰骋 | 转载请注明出处
