围绕任务流程、提示词规则和可复用脚本构建能力包。
Secondary Development
OpenClaw 二次开发
围绕 Skills、Plugins、Hooks、HTTP Routes 和 ClawHub，整理 OpenClaw 常见的二次开发方向、场景与官方资料入口。
面向渠道接入、工具注册和 Gateway 运行时扩展。
围绕任务流程、提示词规则和可复用脚本构建能力包。
面向渠道接入、工具注册和 Gateway 运行时扩展。
用于事件触发以及和外部系统的轻量联动。
适合公开分发、版本管理和复用技能能力。
面向需要扩展 OpenClaw 能力的开发者、技术团队和内部平台团队。
技能包、插件包、Hook / Webhook 入口、HTTP 路由和可复用能力包。
先看 Skills、Plugins、ClawHub 与 Plugin API，再确定本地调试或发布路径。
01
Development Chooser
开发选型对照
根据目标选择开发方式，可以更快判断应从 Skills、Plugins、Hooks 还是 ClawHub 开始。
封装任务流程、提示词规则和配套脚本
建议路径Skills适合把能力打包成可复用的任务单元。
接入新渠道、工具能力或运行时功能
建议路径Plugins适合扩展 Gateway 能力和系统集成。
接外部事件、回调和 Webhook 入口
建议路径Hooks / HTTP Routes适合审批、工单、表单等系统回调场景。
把能力公开分发给团队或社区
建议路径ClawHub适合做版本化共享和公开分发。
02
Preparation Checklist
开发前准备清单
在开始写 Skills、Plugins 或 Hook 之前，先把环境、权限、调试和发布方式准备清楚。
- 确认 OpenClaw 运行环境与版本
- 准备本地调试目录或工作区
- 确认依赖安装与基础命令可用
- 明确需要访问的模型、工具和外部系统
- 确认敏感操作是否需要审批
- 避免在开发阶段默认放开全部权限
- 先准备最小可复现样例
- 优先从本地调试和日志查看开始
- 对 Hook、HTTP 路由和事件入口单独验证
- 确定是内部共享还是公开分发
- 准备基础更新说明
- 公开能力包时补充安装与使用说明
03
Development Types
主要开发形态
根据任务封装、能力接入、事件联动和公开分发等目标，二次开发通常会落到下面几类形态。
Skills 扩展
适合封装提示词规则、脚本、资源文件和操作说明，形成可复用能力包。
Plugins 扩展
适合为 Gateway 增加渠道接入、工具能力和运行时扩展。
Hooks / Webhooks 联动
适合连接外部事件、回调通知和轻量自动流程，让系统与表单、审批、工单等服务联动。
04
Development Process
常见开发流程
从明确目标到确定运行边界，再到分发与复用，是更常见的推进方式。
明确扩展目标
先确定是任务封装、能力接入、事件联动还是公开分发，再选择对应开发形态。
确认运行边界
涉及新工具、HTTP 路由、Hook 或 Gateway 级配置时，再进入插件层开发。
考虑分发与复用
对外公开的技能可进入 ClawHub，团队内部共享更适合工作区或本地托管。
05
Common Pitfalls
常见踩坑
下面这些问题最常见，提前避开会比后期返工轻松很多。
把能做成 skill 的需求写成 plugin
风险：开发复杂度被提前拉高，后续维护成本也会明显增加。
修正：如果目标只是封装任务、提示词和脚本，优先从 Skills 开始。
一开始就放开过多权限
风险：调试虽然方便，但后续很难分清到底哪一层能力真正需要保留。
修正：先按最小权限跑通最小样例，再逐步增加需要的模型、工具和外部访问能力。
没有准备最小测试样例
风险：一旦效果不对，很难判断是代码、配置还是输入问题。
修正：为每个 Skill、Plugin 或 Hook 先准备一个最小可复现输入和预期输出。
只写能力，不写说明
风险：团队成员难以判断怎么安装、调用和升级，复用价值会迅速下降。
修正：在发布或共享前补齐安装说明、输入输出示例和更新说明。
06
Release Checklist
发布前检查
在共享或发布前，把功能、权限、文档和版本说明核对一遍。
- 确认核心功能在最小样例下可用
- 检查输入输出是否符合预期
- 确认失败场景有明确提示或回退方式
- 核对模型、工具和外部系统权限范围
- 确认高风险能力没有默认放开
- 对需要审批的动作保留人工确认链路
- 补齐安装步骤和调用方式
- 提供最小使用示例
- 说明版本要求、依赖和更新事项
- 确认内部共享或公开发布路径
- 准备版本说明或变更记录
- 对公开能力包核对命名、说明和可见内容
07
Scenarios
常见应用场景
Skills
给企业内部知识助手做专用技能包
将术语规则、输出模板、常用脚本和文档资源封装进技能包，方便客服、法务、售前、运营等团队复用。
Plugins / HTTP Routes
把 OpenClaw 接进内部审批或工单系统
通过插件注册 HTTP 路由或 Hook，让审批、工单、表单等事件进入 Gateway。
Plugins
增加新的渠道或第三方消息入口
新增 IM、CRM 或协作平台入口时，通常需要通过插件扩展渠道层能力。
ClawHub
给团队分发可复用的公开能力包
当技能具备通用价值时，可以版本化并发布到 ClawHub，降低团队和社区复用门槛。
08
Official Sources
官方资料索引
下面这些公开资料可直接用于了解 Skills、Plugins、Hook 与 HTTP 接口能力。
OpenClaw Docs
Skills
官方说明 skills 的目录结构、加载位置、优先级，以及 workspace / 本地 / 内置 skills 的覆盖关系。
打开原文OpenClaw Docs
Creating Skills
官方给出创建第一个 skill 的最小步骤，包括目录、`SKILL.md`、刷新与测试方式。
打开原文OpenClaw Docs
ClawHub
官方将 ClawHub 定义为公开技能注册表，支持搜索、安装、更新和发布技能。
打开原文OpenClaw Docs
Plugins
插件文档说明插件的安装方式、导出形式，以及如何在运行时注册 hook。
打开原文OpenClaw Docs
Plugin Agent Tools
官方说明插件可向 LLM 暴露 JSON Schema 形式的 agent tools，并通过 allowlist / denylist 管理可调用范围。
打开原文OpenClaw Docs
Plugin HTTP Routes
官方给出了 `api.registerHttpRoute(...)` 的注册方式，适合做 webhook、回调入口和外部系统接入。
打开原文