技能配置

所有与技能相关的配置都位于 ''~/.openclaw/openclaw.json'' 的 ''~/.openclaw/openclaw.json'' 下。

{
  skills: {
    allowBundled: ["gemini", "peekaboo"],
    load: {
      extraDirs: ["~/Projects/agent-scripts/skills", "~/Projects/oss/some-skill-pack/skills"],
      watch: true,
      watchDebounceMs: 250,
    },
    install: {
      preferBrew: true,
      nodeManager: "npm", // npm | pnpm | yarn | bun (Gateway runtime still Node; bun not recommended)
    },
    entries: {
      "nano-banana-pro": {
        enabled: true,
        apiKey: "GEMINI_KEY_HERE",
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

- ''allowBundled''：仅针对''捆绑''技能的可选允许列表。设置后，只有

列表中的捆绑技能可用（托管/工作区技能不受影响）。

- ''load.extraDirs''：要扫描的额外技能目录（最低优先级）。

- ''load.watch''：监视技能文件夹并刷新技能快照（默认：true）。

- ''load.watchDebounceMs''：技能监视器事件的防抖时间（毫秒）（默认：250）。

- ''install.preferBrew''：优先使用 brew 安装器（默认：true）。

- ''install.nodeManager''：node 安装器偏好（''npm'' | ''pnpm'' | ''yarn'' | ''bun''，默认：npm）。

这仅影响<strong>技能安装</strong>；网关运行时仍应为 Node

（不建议在 WhatsApp/Telegram 上使用 Bun）。

- ''entries.<skillKey>''：按技能覆盖。

按技能字段：

- ''enabled''：设置为 ''false'' 以禁用技能，即使它已捆绑/安装。

- ''env''：为代理运行注入的环境变量（仅在未设置时）。

- ''apiKey''：声明主环境变量的技能的可选便利设置。

- ''entries'' 下的键默认映射到技能名称。如果技能定义了

''metadata.openclaw.skillKey''，请改用该键。

- 启用监视器时，技能的更改会在下一次代理轮次中被拾取。

当会话被沙盒化时，技能进程在 Docker 内运行。沙盒

''不''继承主机 ''process.env''。

使用以下之一：

- ''agents.defaults.sandbox.docker.env''（或按代理 ''agents.list[].sandbox.docker.env''）

- 将环境变量烘焙到您的自定义沙盒镜像中

全局 ''env'' 和 ''skills.entries.<skill>.env/apiKey'' 仅适用于''主机''运行。