Skills 配置

配置哪些技能启用以及如何注入环境与密钥。所有与技能相关的配置位于 ~/.clawdbot/moltbot.json 的 skills 下。

{
  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（网关运行时仍为 Node；不推荐 bun）
    },
    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）。仅影响技能安装；网关运行时仍应为 Node（WhatsApp/Telegram 不推荐 Bun）。
• entries.<skillKey>：每技能覆盖。

每技能字段：enabled：设为 false 可禁用已内置/安装的技能。env：仅在进程未设置该变量时注入。apiKey：为声明了 primary env 的技能提供便利。

说明

• entries 下的键默认对应技能名称。若技能定义了 metadata.moltbot.skillKey，则使用该键。
• 启用监视器时，技能变更在下次代理轮次生效。

沙箱技能与 env

当会话处于沙箱时，技能进程在 Docker 内运行，沙箱不继承主机 process.env。请使用其一：agents.defaults.sandbox.docker.env（或每代理 agents.list[].sandbox.docker.env），或将 env 烘焙进自定义沙箱镜像。全局 env 与 skills.entries.<skill>.env/apiKey 仅对主机运行生效。