Skills 配置

​

Skills 配置

所有与 Skills 相关的配置都位于 skills 下的 ~/.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: {
      "image-lab": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // or plaintext string
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

对于内置的图像生成/编辑，首选 agents.defaults.imageGenerationModel 加上核心的 image_generate 工具。skills.entries.* 仅用于自定义或 第三方技能工作流。

如果选择特定的图像提供商/模型，还需配置该提供商的 auth/API 密钥。典型示例：google/* 的 GEMINI_API_KEY 或 GOOGLE_API_KEY，openai/* 的 OPENAI_API_KEY，以及 fal/* 的 FAL_KEY。

示例：

• 原生 Nano Banana 风格设置：agents.defaults.imageGenerationModel.primary: "google/gemini-3-pro-image-preview"
• 原生 fal 设置：agents.defaults.imageGenerationModel.primary: "fal/fal-ai/flux/dev"

​

字段

• allowBundled：仅针对 内置 技能的可选允许列表。设置后，列表中仅有内置技能符合条件（托管/工作区技能不受影响）。
• load.extraDirs：要扫描的其他技能目录（优先级最低）。
• load.watch：监视技能文件夹并刷新技能快照（默认为 true）。
• load.watchDebounceMs：技能监视器事件的防抖时间，以毫秒为单位（默认为 250）。
• install.preferBrew：如果可用，优先使用 brew 安装程序（默认为 true）。
• install.nodeManager：node 安装程序首选项（npm | pnpm | yarn | bun，默认为 npm）。 这仅影响 技能安装；Gateway(网关) 运行时仍应为 Node （不建议将 Bun 用于 Gateway(网关)/Bun）。
• entries.<skillKey>：针对每个技能的覆盖设置。

针对每个技能的字段：

• enabled：设置 false 可禁用技能，即使该技能是内置的或已安装。
• env：为代理运行注入的环境变量（仅当尚未设置时）。
• apiKey：针对声明了主要环境变量的技能的可选便利设置。 支持纯文本字符串或 SecretRef 对象（{ source, provider, id }）。

​

注意事项

• entries 下的键默认映射到技能名称。如果技能定义了 metadata.openclaw.skillKey，则改用该键。
• 启用监视器后，技能的更改将在下一轮代理对话时被检测到。

​

沙箱隔离技能 + 环境变量

当会话处于沙箱隔离状态时，技能进程在 Docker 内运行。沙箱不继承主机的 process.env。

使用以下方法之一：

• agents.defaults.sandbox.docker.env（或每个代理的 agents.list[].sandbox.docker.env）
• 将环境变量 bake 到您的自定义沙箱镜像中

全局 env 和 skills.entries.<skill>.env/apiKey 仅适用于 host 运行模式。

---

本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。