openclaw自定义插件开发有四种路径：一、用clawhub cli初始化typescript项目；二、手动基于sdk构建模块；三、skill.md驱动式零代码开发；四、复用社区验证模板快速迭代。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望为OpenClaw添加特定自动化功能，但其内置Skill无法满足需求，则需通过TypeScript开发自定义插件。以下是实现该目标的多种可行路径：
一、使用ClawHub CLI初始化项目结构
ClawHub CLI是OpenClaw官方推荐的脚手架工具，可自动生成符合v2026.3.31版本规范的TypeScript Skill目录与基础配置文件，避免手动创建时因结构错误导致加载失败。
1、执行全局安装命令：npm install -g @openclaw/cli@latest。
2、运行初始化指令：openclaw skill init my-custom-skill，其中my-custom-skill为唯一技能ID，建议使用小写字母与横杠组合。
3、进入生成目录，确认存在skill.yaml、src/handler.ts、package.json三个核心文件。
4、在skill.yaml中填写name、version、description字段，并明确定义trigger.type为command或intent，同时声明所需permissions（如network、fs:read）。
二、基于OpenClaw SDK手动构建TypeScript模块
此方式适用于需深度集成OpenClaw内核API或复用现有类型定义的场景，不依赖CLI，完全由开发者控制依赖与构建流程。
1、在OpenClaw安装目录的skills子目录下新建文件夹，命名为my-ts-skill。
2、创建plugin.json文件，写入name、version、entry_point（固定为index.ts）、class_name及permissions数组。
3、新建index.ts，导入OpenClaw SDK中的BaseSkill与Context类型，定义类并继承BaseSkill。
4、在execute方法中编写业务逻辑，调用context.get_param获取参数，使用this.logger记录关键状态，返回标准化对象{status: "success" | "error", data?: any}。
OpenClaw 原生 PDF/文档处理技能，适用于 Nutrient DWS，帮助用户完成 PDF 转换、OCR、文字/表格提取、PII 脱敏等功能。
三、采用SKILL.md驱动式开发（零代码优先）
OpenClaw v2026.3.31支持仅凭自然语言描述文件即可启用Skill，AI通过解析SKILL.md理解能力边界与调用条件，适合快速验证想法或非技术用户参与插件生态。
1、在用户技能目录（~/.openclaw/skills/）下新建文件夹，命名如weather-lookup。
2、在该文件夹内创建SKILL.md，首段明确说明用途：“本Skill用于查询指定城市的实时天气数据，需网络权限。”
3、在“使用示例”章节列出至少两个完整指令格式，例如：“/weather 北京”、“/weather 上海 湿度”。
4、在“异常处理”段落注明超时、城市不存在、API不可达等情形下的预期响应文本，增强AI调用鲁棒性。
四、复用社区Skill模板进行快速迭代
ClawHub平台已托管大量经v2026.3.31验证的TypeScript Skill模板，可直接克隆、修改并重命名，大幅缩短开发周期，尤其适用于常见任务如HTTP请求、本地文件操作、系统命令执行等。
1、访问ClawHub官网镜像站（https://cn.clawhub.dev），筛选标签为typescript与verified的模板。
2、选择适配当前OpenClaw版本的模板仓库，执行：git clone https://cn.clawhub.dev/templates/http-get.git。
3、将克隆目录移入OpenClaw skills路径，重命名为新Skill ID，如api-proxy。
4、修改src/handler.ts中的fetch调用地址与参数映射逻辑，更新skill.yaml中的name与description字段，保存后重启OpenClaw服务。
