openclaw自定义技能本质是为ai编写自然语言说明书而非开发后台服务;需在固定路径建技能文件夹并包含skill.md,按yaml头、触发条件、执行步骤三部分撰写,支持可选python/node.js实现及权限声明。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw自定义技能不是写后台服务,而是给AI写一份“能看懂、会判断、可执行”的说明书。核心不在于编程多深,而在于把你想让它做的事,用清晰结构和自然语言告诉它——哪怕只写一个SKILL.md文件,也能生效。
第一步:选对位置,建好文件夹
新手直接用用户级技能目录,路径固定,免配置:
- Linux/macOS:~/.openclaw/skills/your_skill_name/
- Windows:%USERPROFILE%\.openclaw\skills\your_skill_name\
- 文件夹名就是技能ID,全小写+下划线,比如weather_forecast或pdf_summary
- 必须包含SKILL.md;其他如index.py、manifest.json按需添加
第二步:写好SKILL.md——AI的唯一指令源
这个文件决定AI会不会调、什么时候调、怎么调。结构要干净,重点写三块:
OpenClaw 跨平台配置备份与网关监控。自动备份 openclaw.json,每分钟检测 gateway 状态,宕机时自动恢复。支持 Linux/macOS/Windows。触发:配置备份、gateway 监控、自动恢复、看门狗、watchdog。
- 头部YAML区:写明name(唯一标识)、description(一句话用途,AI靠它匹配场景)
- 触发条件:用自然语言描述用户怎么说才会激活,比如“当用户问‘今天北京天气怎么样’或输入‘查XX市天气’时”
- 执行步骤:分点写清楚AI该调什么工具(浏览器?文件读取?API?)、处理什么信息、怎么组织结果。例如:“1. 提取城市名;2. 调用browser访问中国气象局网页;3. 解析温度、湿度、风力字段;4. 用中文简洁回复,不带HTML标签”
第三步:按需加执行逻辑(非必须,但更可控)
如果纯文本描述不够稳,就补一段轻量代码。主流支持Python和Node.js:
- Python技能:在文件夹里放__init__.py,继承BaseSkill,实现execute()方法
- Node.js技能:放index.js,导出execute函数,接收context对象
- 所有外部操作(如联网、读文件)必须提前在SKILL.md里声明权限,比如加一行permissions: [network, filesystem]
第四步:启用与验证
保存后不用重启OpenClaw,它会自动扫描加载(部分版本需执行openclaw skill reload):
- 在聊天界面直接测试,比如输入你写在“触发条件”里的典型句子
- 观察日志是否显示[Skill] loaded: your_skill_name
- 若未触发,先检查description是否太模糊;若报错,看错误是否指向权限缺失或工具未启用









