Zui近捣鼓OpenCLAW的时候总觉得少点意思——官方技Neng虽然够用，但总不如自己亲手Zuo的顺手不是？比如想让它帮我统计CSV里的数据时直接调我写好的脚本…害！干脆自己加个自定义技Neng算了！

折腾完才发现：这事儿居然比想象中简单多了！但过程里踩过的坑也够记一阵子——比如漏写某个装饰器导致技Neng没注册上、SKILL.md路径错了半天找不到文件…今天就把这点家底掏出来唠唠：到底怎么给OpenCLAW塞个专属技Neng进去？

先别急！搞清楚「自定义技Neng到底是啥」

咱就是说啊～别一上来就冲代码怼——先得明白OpenCLAW眼里的「技Neng」是个啥样：它不是随便一段Python脚本,而是「Neng被Planner识别并直接调用的Neng力块」。简单讲：你写一段逻辑,再给它贴个「标签」,它就Neng乖乖听你话啦～

第一步：环境检查——别让依赖问题卡脖子

我第一次搞的时候就栽这儿了：兴冲冲写好代码一跑,直接弹「ModuleNotFoundError: No module named 'openclaw'」…害！白忙活半小时才想起——得先确认OpenCLAW环境是不是正常运行！

具体要查啥？ - 终端敲 openclaw --version kankanNeng不Neng正常输出版本号； - 检查Python环境：OpenCLAW默认用3.8+版本,别整那种老掉牙的2.7啊喂； - 依赖包有没有装全？比如 pandastyping…直接 pip install openclaw pandas 一条龙搞定,省得麻烦。

第二步：写个Zui傻但Zui有用的「Hello World」技Neng

既然是入门,那就从Zui极简的例子开始——反正目标是「跑通流程」,复杂逻辑后面再慢慢加嘛～

,找个地方存你的技Neng文件.OpenCLAW默认会把用户技Neng放 ~/.openclaw/workspace/skills/ 目录下.咱就建个 hello_world 文件夹放这儿,名字随便取,只要Neng对应上就行.

然后写Python脚本——文件名无所谓,但后缀得是 .py,比如 hello_skill.py python

from openclaw.core import BaseSkill, register_skill from openclaw.types import SkillParam from typing import Dict, Any

@registerskill( name="helloworld", # 技Neng唯一ID,后面调用靠这个 description="返回一句定制化问候语", # 功Neng描述,Planner会kan这个匹配需求 author="你自己名字" # 作者信息,随便填但Zui好留 ) def helloworldskill -> str: # params是用户输入的参数,比如想加个名字就Neng喊「XX你好」 name = params.get return f"哈喽～{name}！这是你的专属问候 —— from OpenCLAW自定义技Neng😆"

写完这段是不是觉得「也就那样」？害！先别急吐槽——等会儿你就知道它有多香了～

第三步：灵魂文件SKILL.md——没它Planner根本不认你

哎哎哎！重点来了啊朋友们！hen多人以为写完代码就完事儿…结果测试的时候输入关键词,OpenCLAW要么装聋作哑要么让大模型乱答复.为啥？因为少了「说明书」——SKILL.md!

这个文件是连接「用户说人话」和「代码执行」的桥梁! Planner会根据里面写的「触发关键词」和「参数说明」来判断:「哦~用户说这句话/输这个关键词,是要用我的XXX技Neng对吧?」

那到底怎么写?直接上我抄官方文档的模板:

markdown

描述

一个Neng根据用户输入返回专属问候语的简单技Neng~支持自定义姓名参数哦～

使用场景

当你想快速获取一句暖心问候时

调用方式

直接输入: hello

参数说明

参数名	是否必填	类型	描述
name	否	str	需要问候的对象姓名

返回示例

输入: hello 小明 → 返回:「哈喽～小明！这是你的专属问候 —— from OpenCLAW自定义 skills😆」 输入: hello → 返回:「哈喽～陌生人！这是你的专属问候 —— from OpenCLAW自定义 skills😆」

把这个文件丢进刚才建的 hello_world 文件夹里——跟Python脚本放一起!记住哦:文件名必须是大写SKILL.MD吗?不对不对!其实小写也行?害我之前纠结半天…后来试了才知道:只要后缀是.md且名字包含SKILL就行?不!等等!官方文档说Zui好叫SKILL.md,不然可Neng扫描不到!稳妥起见就按官方来哈~

为什么百度不收录我的技Neng说明?

哎等等!刚才写SKILL.md的时候突然想到一个傻问题:我这么用心写的文档会不会被百度收录呀?要是Neng搜到我的教程该多好…结果转念一想:呸呸呸!这东西是给OpenCLAW框架kan的数据格式啊喂!又不是网页文章!搜索引擎根本识别不了.md里这种结构化内容好嘛!害得我白高兴一场😂

第四步：注册&激活——让OpenCLAW认识你的新技Neng

写完代码和说明书还不够!还得让OpenCLAW把这个技Neng「加载进来」.怎么弄?两种办法选一个就行~

办法1：懒人专用——重启Gateway服务

OpenCLAW有个网关服务,负责管理所有技Neng注册.只要重启一下它,就Neng自动扫描新增的.py和.md文件啦!

终端敲一行命令就行: bash openclaw gateway restart

等屏幕弹出「Gateway restarted successfully」就成啦~是不是超简单?

办法2：手动改配置文件

要是重启不行,那就手动改配置吧.OpenCLAW有个全局配置文件叫 ~/.openclaw/openclaw.json,打开它找到 enabled_skills字段:

json { "agent": { "enabled_skills": // 添加你的技Nengname } }

改完保存再重启一次Gateway——完美~

第五步：测试！终于到见证奇迹的时候啦！

激动的心颤抖旳手!打开OpenCL AW Dashboard.找到聊天框输入:hello world小明——见证奇迹吧!

Ru果返回:哈喽～小明!/陌生人!,这是你的专属问候 —— from OpenCl AW自定义 skills 😆,而不是大模型那种千篇一律の回复…那恭喜你!成功啦!!!🎉🎉🎉

那些坑我帮你们踩过了!

路径错了=白搭:一定要把.py和.SKILL.MD丢进 /Users/用户名/.openCl AW/workspace/skills/xxx/目录下 !别放别的地方啊喂!!; 2.装饰器漏了=隐形人:@register_Skill这个东西必须加 !不然Planner根本找不到你的函数; 3.参数类型搞错=报错:SkillParam.get方法返回の值记得转成对应类型 !比如params.get拿出来可Neng是字符串 ,要算年龄就得int转一下; 4.网络不好=安装失败:Ru果用官方のskill installer安装社区插件 ,记得开全局代理 !;

Zui后一下 :其实真不难对吧?

从准备环境到测试成功 ,全程Zui多半小时 !关键就是别嫌麻烦 :把每个细节dou落实 .等你搞定第一个自定义 skill之后 ,再去 什么 CSV分析 / Shell命令 /多模型调用之类の高级功Neng ,简直不要太轻松 ~

对咯对咯 !要是还有不懂の地方 ,评论区喊我 !毕竟咱dou是从坑里爬出来の人 ~ 😏

---