Skills Config

你的电脑小助手有很多“技能”，就像你的玩具箱里有不同的玩具。这页说明书教你如何在一张叫 openclaw.json 的“清单”上，告诉小助手该怎么管理它的技能玩具箱。

这张清单里，所有关于技能的事情，都写在一个叫 skills 的大格子里。我们来看看这个格子里可以写些什么。

1. 允许使用哪些“自带玩具”

   • 做什么：告诉小助手，它可以玩哪些“自带玩具”（也就是软件自己带的技能）。
   • 怎么做：在清单里写上 allowBundled，后面跟一个列表，比如 ["gemini", "peekaboo"]。这样，小助手就知道它只能玩“gemini”和“peekaboo”这两个自带玩具，其他的自带玩具暂时收起来。

2. 去哪里找“新玩具”

   • 做什么：告诉小助手，除了自带的玩具，还可以去家里的哪些“玩具箱”里找新玩具。
   • 怎么做：在 load.extraDirs 后面写上文件夹的路径，比如 ["~/Projects/agent-scripts/skills"]。这就像告诉小助手：“去‘Projects’房间的‘agent-scripts’柜子里的‘skills’抽屉里找找看！”
   • 要小心：这里的路径要写对，不然小助手会找不到。

3. 要不要盯着“玩具箱”看

   • 做什么：决定小助手要不要一直盯着玩具箱，一有新玩具放进去就马上发现。
   • 怎么做：把 load.watch 写成 true（打开）或 false（关上）。如果打开了，小助手就会一直看着。watchDebounceMs 是告诉它，看到变化后等一小会儿（比如250毫秒，眨一下眼的时间）再行动，免得它太着急。

4. 怎么安装“新玩具”

   • 做什么：告诉小助手，如果新玩具需要安装，它更喜欢用什么工具来装。
   • 怎么做：install.preferBrew 写成 true，它就会优先用“Brew”这个工具（如果玩具支持的话）。install.nodeManager 可以选 npm、pnpm、yarn 或 bun，告诉它装“Node.js”类玩具时喜欢用哪个小帮手。
   • 要小心：说明书特别提醒，小助手的核心部分（Gateway）最好还是用 Node 来运行，用 Bun 的话，有些功能（像 WhatsApp/Telegram）可能不太灵。

5. 给每个“玩具”写小纸条

   • 做什么：给每一个技能玩具单独写一张使用说明。
   • 怎么做：在 entries 下面，用技能的名字（比如 "nano-banana-pro"）当标题，然后给它写设置。
     • enabled: true 意思是“这个玩具可以玩”，false 就是“先收起来不玩”。
     • env 是给这个玩具的“秘密能量”，比如一个叫 GEMINI_API_KEY 的密码。你可以直接写出来，或者告诉它去电脑的“环境变量”这个秘密抽屉里找。
     • apiKey 是专门放主要密码的地方，用法和 env 差不多。

一些重要的小提醒：

• 在 entries 下面写玩具名字时，默认就用技能自己的名字。但如果这个技能自己有个特别的 skillKey 名字，就要用那个特别的名字。
• 当你改了这张技能清单，小助手通常会在下一次要它干活的时候，才注意到这些变化（如果 watch 开着的话，它会更快发现）。
• 如果小助手是在一个叫“沙盒”的隔离小房间里工作（为了安全），那这个小房间不会自动拿到外面电脑的所有“秘密能量”（环境变量）。你需要通过另外的方式（比如在 agents 的设置里，或者做一个定制的小房间镜像）把能量传给它。清单里的 env 和 apiKey 设置，只对小助手在“外面”工作时有效。