一、OpenClaw Skills 是什么OpenClaw Skills 是模块化的能力包能让 AI 助理快速获得特定功能。Skills 遵循标准规范YAML frontmatter Markdown 文档可以被 ClawHub 管理、共享和复现。核心特点即插即用clawhub install skill-name一键安装标准化所有技能都有统一的SKILL.md结构跨平台workspace 注入让任何 agent 都能使用可组合多个技能配合实现复杂工作流二、完整开发流程7步第1步规划技能范围问自己三个问题解决了什么痛点— 明确问题边界为什么需要新技能— 现有技能无法满足或需要封装复杂流程输入输出是什么— 定义清晰的使用契约示例开发multi-search-engine技能痛点需要跨多个搜索引擎检索没有统一接口需求封装17个引擎的URL构造用户只需传关键词契约输入{keyword}→ 输出web_fetch(url)调用示例第2步创建项目结构mkdir-p~/.openclaw/workspace/skills/my-skillcd~/.openclaw/workspace/skills/my-skill必需文件my-skill/ ├── SKILL.md # 主文档必须 ├── _meta.json # 元数据可选ClawHub 用 ├── config.json # 配置模板可选 ├── assets/ # 图片、示例文件可选 ├── scripts/ # 辅助脚本可选 └── references/ # 详细参考文档可选第3步编写 SKILL.md核心3.1 YAML frontmatter必须---name:my-skill# 文件夹名一致description:做什么用的简短描述version:1.0.0# 语义化版本author:Your Name# 可选---3.2 Markdown 内容结构推荐模板# Skill Name 一句话价值主张。 ## 功能特性 - 特性1 - 特性2 ## 快速开始 bash # 代码示例直接用实际命令 tool_name({param: value})详细说明子模块1解释用法、参数、返回值子模块2…配置如果需要配置文件说明 config.json 的字段安装与卸载clawhubinstallmy-skill clawhub uninstall my-skill故障排查常见问题及解决方案相关资源参考链接相关技能LicenseMIT / Apache 2.0 / …**关键规则** - **名字必须和文件夹名一致**ClawHub 校验 - **禁止 README.md**用 SKILL.md 作为主文档 - **示例代码必须可复制粘贴运行** - **避免内部细节**专注如何使用第4步测试技能本地安装测试clawhubinstall.# 在当前文件夹运行功能验证在 OpenClaw 会话中触发该技能确认工具可用、参数正确、输出符合预期边界测试空参数、无效参数错误处理是否友好第5步准备发布提交到 ClawHub registry# 登录首次需要clawhub login# 发布clawhub publish.--taglatest发布前检查✅SKILL.md无明显错误✅ 版本号递增遵循 semver✅ License 明确✅ 无敏感信息API keys、 passwords✅ 示例代码能跑通可选添加到 workspaces 安装清单编辑workspace/install_skills.bat或手动安装clawhubinstallmy-skill第6步文档与推广在项目的README.md中说明技能用法如果有相关技能在它们的 See Also 中交叉引用发布到 ClawHub 时写清晰的 changelog第7步维护与更新更新流程修改代码/文档递增版本号bugfix → patch新功能 → minor破坏性改动 → major重新 publish用户升级clawhub update my-skill三、技能分析proactive-agent v3.1.0以Proactive Agentv3.1.0为例拆解一个成熟技能的构成。3.1 元信息YAML frontmatter---name:proactive-agentversion:3.1.0description:Transform AI agents from task-followers into proactive partners that anticipate needs and continuously improve. Now with WAL Protocol, Working Buffer, Autonomous Crons, and battle-tested patterns. Part of the Hal Stack author:halthelobster---亮点versionsemver 规范3.1.0 表示 minor 版本增加description说明核心价值 新特性关键词利于搜索author署名建立信誉3.2 文档结构SKILL.md 内容该文件共有 68KB结构极其完整1. 价值主张前3段The mindset shift:Don’t ask “what should I do?” Ask “what would genuinely delight my human that they haven’t thought to ask for?”开门见山明确心智模式的转变。不做执行机器要做主动伙伴。2. 新版本亮点What’s New in v3.1.0Autonomous vs Prompted CronsVerify Implementation, Not IntentTool Migration Checklist作用老用户快速了解更新内容决定是否升级。3. 快速开始Quick Startcpassets/*.md ./一行命令完成初始化。经验降低使用门槛 技能传播的关键。4. 核心架构6个 PillarsMemory Architecture记忆架构Security Hardening安全加固Self-Healing自愈能力Verify Before Reporting验证再汇报Alignment Systems对齐系统Proactive Surprise主动惊喜每个 Pillar 都有详细协议、触发条件、执行步骤。这种模块化设计让复杂概念可执行。5. 详细协议ProtocolsWAL ProtocolWrite-Ahead Logging触发条件SCAN EVERY MESSAGE FOR 6 类信息执行步骤WRITE → THEN Respond目的确保关键细节在 context flush 前持久化Working Buffer Protocol60% context 阈值时启动记录每一条 exchangeCompaction 后从中恢复上下文这些协议是可执行的不是理论。每条规则都有明确的触发条件和操作序列。6. 检查清单与模板Heartbeat Checklist心跳检查清单Cron 类型对比表Autonomous vs PromptedTool Migration Checklist迁移时逐项打勾Promotion Targets学习成果推广目标表设计智慧把“该做什么”变成“怎么做 检查表”降低执行成本。7. 模板文件在 assets/SESSION-STATE.md— 活动状态存储ONBOARDING.md— 首次运行设置等等用户复制这些模板即可获得完整 scaffolding。提供模板 让起步更容易。8. 故障模式与反模式Failure Mode:UsingsystemEvent需要交互的场景Anti-Drift Limits:禁止为“显得聪明”增加复杂度The Golden Rule:“Does this let future-me solve more problems with less cost?”记录失败模式可以帮助用户避免经典错误。知识传递做得很好。3.3 可复制的设计模式从 proactive-agent 学到的 5 个模式即刻价值First 3 seconds开头就问“This mindset shift…” 让用户立即明白“这对我有什么用”版本差异化What’s New每次更新都列出变化让老用户快速决定是否升级提供模板Copy-Paste Readycp assets/*.md ./一键生成全部配置文件检查清单Checklists把抽象原则变成具体动作比如 Tool Migration Checklist反模式警示Failure Modes告诉用户“什么不该做”比“什么该做”更有价值四、其他技能亮点multi-search-engine v2.0.1特点纯工具型技能无状态17 个搜索引擎 URL 模板高级操作符表site:、filetype:、time filtersDuckDuckGo Bangs 快捷键WolframAlpha 知识查询结构## Search Engines ### Domestic (8) / International (9) 表格列出名称 URL 模板 ## Quick Examples 代码块直接展示用法 ## Advanced Operators 参数表格 示例 ## Time Filters / Privacy Engines / Bangs 分类说明产品思维按地理分组Domestic/International降低认知负荷Quick Examples 让用户 10 秒上手表格化参数便于查找self-improving-agent v1.0.11特点元技能meta-skill教其他 agent 如何从错误中学习三类日志LEARNINGS.md、ERRORS.md、FEATURE_REQUESTS.md标准化格式[LRN-YYYYMMDD-XXX]编号系统推广机制从.learnings/升华到CLAUDE.md、AGENTS.md跨 agent 支持Claude Code、Codex、Copilot、OpenClaw设计理念可发现性用 ID 编号便于搜索链接生命周期pending→resolved→promoted过滤机制Area、Priority、Status 三类标签github v1.0.0特点极简参考型技能只做一件事封装ghCLI 的高级用法不做重复文档用户应阅读 gh --help提供特定场景下的命令示例JSON 输出 jq 过滤的高级技巧克制之美不试图重新发明文档只做“场景化速查”。五、最佳实践总结设计阶段单一职责一个技能解决一个领域的问题契约清晰输入/输出明确定义渐进增强基础功能先做高级功能后续迭代实现阶段模板先行参考现有技能的结构可复制粘贴示例代码要能直接运行错误处理给出失败场景的解决方案配置最小化配置文件字段 ≤ 5 个文档阶段价值前置前 100 字说明“为什么需要这个”分层文档Quick Start10 行代码演示Detailed Guide完整操作Reference API参数表检查清单把复杂流程变成勾选项发布阶段SemVer严格遵循版本号规则Changelog每次发布说明 Breaking Changes跨技能引用See Also 建立技能网络License设定明确的复用条款维护阶段Backward Compatibilityv1.x → v2.x 应提供迁移路径Feedback Loop收集用户问题 → 更新 FAQDeprecation旧功能先标记deprecated再移除六、技能之间的互操作OpenClaw 技能不是孤岛。设计时要考虑技能组合githubself-improvement 学习 GitHub 相关最佳实践并固化技能依赖proactive-agent依赖self-improvement实现自愈技能竞争两个技能实现相同功能 → 引导用户只安装其一技能扩展multi-search-engine可以扩展国内小众引擎而不改核心架构七、实战建议如果你要开发第一个技能从小开始先做一个能解决自己痛点的 200 行技能参考现有克隆multi-search-engine的结构先本地测试clawhub install .在工作流中试用一周渐进发布v0.1.0 → v0.2.0 → v1.0.0如果你要维护现有技能定期回访每月查看 issues收集使用反馈技术债管理一次重构只做一件事比如升级依赖或改进文档向后兼容除非 major 版本否则不删除旧接口社区建设鼓励用户分享使用案例八、结语OpenClaw Skills 的成功 明确的问题 优雅的封装 极致的使用体验。从multi-search-engine我们看到一个简单的 URL 模板聚合通过良好的分类和示例也能成为高频技能。从proactive-agent我们看到复杂的代理架构通过协议化WAL、Working Buffer和检查清单变得可实施、可传承。核心心法你的技能是给人的不是给机器的用户不需要知道内部机制只需要知道“怎么用”好的文档 用户不看官方手册也能成功