​

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 (Gateway runtime は引き続き Node。bun は非推奨)
    },
    entries: {
      "image-lab": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // または平文文字列
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

• ネイティブ Nano Banana 風セットアップ: agents.defaults.imageGenerationModel.primary: "google/gemini-3.1-flash-image-preview"
• ネイティブ fal セットアップ: agents.defaults.imageGenerationModel.primary: "fal/fal-ai/flux/dev"

​

エージェント Skill allowlist

{
  agents: {
    defaults: {
      skills: ["github", "weather"],
    },
    list: [
      { id: "writer" }, // デフォルトを継承 -> github, weather
      { id: "docs", skills: ["docs-search"] }, // デフォルトを置き換える
      { id: "locked-down", skills: [] }, // Skills なし
    ],
  },
}

• agents.defaults.skills: agents.list[].skills を省略した エージェント向けの共通ベースライン allowlist。
• デフォルトで Skills を無制限にしたい場合は agents.defaults.skills を省略します。
• agents.list[].skills: そのエージェント向けの明示的な最終 Skill セット。デフォルトとは マージされません。
• agents.list[].skills: []: そのエージェントには Skill を公開しません。

​

フィールド

• 組み込み Skill ルートには常に ~/.openclaw/skills、~/.agents/skills、 <workspace>/.agents/skills、<workspace>/skills が含まれます。
• allowBundled: バンドルされた Skills のみを対象にした任意の allowlist。設定すると、 リスト内のバンドル Skill のみが対象になります（managed、agent、workspace Skills には影響しません）。
• load.extraDirs: 追加でスキャンする Skill ディレクトリ（最も低い優先度）。
• load.watch: Skill フォルダを監視し、Skills スナップショットを更新します（デフォルト: true）。
• load.watchDebounceMs: Skill watcher イベントのデバウンス時間（ミリ秒、デフォルト: 250）。
• install.preferBrew: 利用可能な場合は brew インストーラーを優先します（デフォルト: true）。
• install.nodeManager: Node インストーラーの優先設定（npm | pnpm | yarn | bun、デフォルト: npm）。 これは Skill インストール のみに影響します。Gateway runtime は引き続き Node を使うべきです （WhatsApp/Telegram では Bun は非推奨）。
  • openclaw setup --node-manager はより限定的で、現時点では npm、 pnpm、bun のみ受け付けます。Yarn ベースの Skill インストールを使いたい場合は、 skills.install.nodeManager: "yarn" を手動で設定してください。
• entries.<skillKey>: Skill ごとの上書き。
• agents.defaults.skills: agents.list[].skills を省略したエージェントが 継承する任意のデフォルト Skill allowlist。
• agents.list[].skills: エージェントごとの任意の最終 Skill allowlist。明示的な リストは継承されたデフォルトをマージせずに置き換えます。

• enabled: バンドル済み/インストール済みであっても Skill を無効化したい場合は false にします。
• env: エージェント実行時に注入される環境変数（まだ設定されていない場合のみ）。
• apiKey: 主要な env var を宣言する Skills 向けの任意の簡易指定。 平文文字列または SecretRef オブジェクト（{ source, provider, id }）に対応します。

​

注意

• entries 配下のキーは、デフォルトでは Skill 名に対応します。Skill が metadata.openclaw.skillKey を定義している場合は、代わりにそのキーを使ってください。
• 読み込み優先順位は <workspace>/skills → <workspace>/.agents/skills → ~/.agents/skills → ~/.openclaw/skills → バンドル Skills → skills.load.extraDirs です。
• Skills への変更は、watcher が有効なら次のエージェントターンで反映されます。

​

サンドボックス化された Skills と env vars

• agents.defaults.sandbox.docker.env（またはエージェントごとの agents.list[].sandbox.docker.env）
• カスタム sandbox イメージに env を焼き込む