ClawCN - OpenClaw 中文版

主题

技能配置 ​

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

json5
{
  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)。 这仅影响技能安装;Gateway 运行时仍应使用 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 仅适用于宿主机运行。