技能配置

适用范围

在以下情况使用此页面:

• 添加或修改技能配置
• 调整捆绑允许列表或安装行为

所有与技能相关的配置都位于 ~/.moltbot/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: 为声明主要环境变量的技能提供的可选便利。

注意事项

• entries 下的键默认映射到技能名称。如果技能定义了 metadata.moltbot.skillKey，请改用该键。
• 当启用监视器时，技能的更改将在下一个代理轮次时被获取。

沙箱化技能 + 环境变量

当会话被沙箱化时，技能进程在 Docker 内运行。沙箱不继承主机 process.env。

使用以下之一:

• agents.defaults.sandbox.docker.env(或每个代理的 agents.list[].sandbox.docker.env)
• 将环境变量烘焙到你的自定义沙箱镜像中

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