3. OpenClaw自定义skill通过环境变量传参

科技前沿 • 2026-03-16 09:23 • 阅读 0

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

 
  
    
     1. 目录结构

skill主要存放在三个地方：1）捆绑类skill，通过npm安装，一般在npm的modules目录下，看你是全局还是局部安装；2）本地skill，存放在OpenClaw主目录下的skills文件夹，目录为"~/.openclaw/skills"；3）workspace skill，存放在" /skill"目录下。

优先级是类别3最高，即workspace下的skill拥有最高优先级，其次是2，然后是1默认捆绑的skill。同名skill冲突时，OpenClaw按照这个优先级进行处理。看官方文档，说是还可以关联外部目录，通过"~/.openclaw/openclaw.json"的"skills.load.extraDirs"参数进行配置，这个优先级最低。

除了优先级，还有一点不同的是，"workspace"下的skill相当于私有的，仅对当前的agent的有效，而类别2，就是根目录下的skills是共享的，所有agent的都可以使用。

注意：“~/.openclaw” 对应的是linux的目录，"~"代表当前用户的根目录，对于windows平台，也是一致的，对应"C:Users[用户名]"目录，后面不再解释。

1.1 skill文件布局

GPT plus 代充 只需 145

SKILL.md是必须存在的，其他都是可选的，如果说SKILL.md的内容过长，最好的办法就是分割成多个文件，放到“references”目录下，在SKILL.md文件中引用，这样做的好处是让模型在读取的时候，消耗的token少些，模型会按照需求读取引用的文件。

2. SKILL.md

字段名必须存在描述 name Yes 描述skill的名称，64个字符以内，小写字母（a-z）和（-）的混合体，字母开头 description Yes 描述skill能做什么，什么时候触发，这个很关键 license No license描述，可以关联单独的文件 metadata No 元数据配置，比如需要哪些环境变量，需要提前装哪个程序

2.1 metadata配置

key 描述 emoji 设置macOS skills UI图标 homepage 配置URL地址 os 当前skill支持的os列表，例如（darwin，linux，win32），如果目标系统不在os列表中，skill会被禁用，数组格式 requires.bins 提供一个程序列表，所有程序必须保证在PATH范围内能找到，数组格式 requires.anyBins 提供一个程序列表，在PATH范围内至少存在一个，数组格式 requires.env 需要提供的环境变量列表，如果不存在，skill就会被禁用，数组格式 primaryEnv env变量名关联到skills.entries..apiKey install 安装器配置，支持brew、node、go等

3. 更新

3.1 更新SKILL.md

name修改的更规范些，按照官方标注，修改为小写字母和“-”的组合，增加metadata字段，导入环境变量信息，其他非必要字段我都删除了，如下：

配置好以后，重启openclaw

GPT plus 代充 只需 145

3.2 修改执行脚本

修改脚本，从环境变量获取这些参数，python代码进行一些微量修改：

4. 执行测试

4.1 测试1

在这里插入图片描述
执行控制插座指令，开关都正常（参数都配置在环境变量中）。

4.2 测试2

在这里插入图片描述
但是要提醒的是，这样是以明文配置在“~/openclaw.json”文件中。

TODO：官方文档说是可以用加密方式配置，暂时还不知道怎么配置，后续研究。