Skills 配置

所有 Skills 相关配置都在 ~/.openclaw/openclaw.json 的 skills 段下面。这个页面关注的是开关、额外目录、安装器偏好和单 Skills 覆盖。

完整示例

skills 配置块

{
  skills: {
    allowBundled: ["gemini", "peekaboo"],
    load: {
      extraDirs: ["~/Projects/agent-scripts/skills"],
      watch: true,
      watchDebounceMs: 250
    },
    install: {
      preferBrew: true,
      nodeManager: "npm"
    },
    entries: {
      "nano-banana-pro": {
        enabled: true,
        apiKey: "GEMINI_KEY_HERE",
        env: { GEMINI_API_KEY: "GEMINI_KEY_HERE" }
      }
    }
  }
}

字段说明

allowBundled：只对白名单内的内置 Skills 生效，不影响工作区 / 本地安装的 Skills。

load.extraDirs：附加扫描目录；load.watch 与 watchDebounceMs 控制动态刷新。

install.nodeManager：只影响 Skills 安装时用哪个 Node 包管理器，不改变 Gateway 的推荐运行时。

entries.<skillKey>：单 Skills 覆盖，可控制 enabled、env、apiKey。