​

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 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: 同梱 Skills のみに対する任意の許可リストです。設定されている場合、リスト内の同梱 Skills のみが対象になります（管理された／ワークスペースの Skills には影響しません）。 allowBundled: 同梱 Skills のみに対する任意の許可リストです。設定されている場合、リスト内の同梱 Skills のみが対象になります（管理された／ワークスペースの Skills には影響しません）。 設定されている場合、リスト内の バンドルされたスキルのみが対象となります(管理スキル/ワークスペーススキルは影響を受けません)。
• load.extraDirs: スキャン対象とする追加の Skill ディレクトリ（優先度は最も低い）。
• load.watch: Skill フォルダーを監視し、Skills のスナップショットを更新します（デフォルト: true）。
• load.watchDebounceMs: Skill ウォッチャーのイベントに対するデバウンス（ミリ秒、デフォルト: 250）。
• install.preferBrew: 利用可能な場合に brew インストーラーを優先します（デフォルト: true）。
• install.nodeManager: Node インストーラーの優先設定（npm | pnpm | yarn | bun、デフォルト: npm）。 これは Skill のインストール のみに影響します。Gateway ランタイムは引き続き Node を使用してください （WhatsApp/Telegram では Bun は推奨されません）。 install.nodeManager: Node インストーラーの優先設定（npm | pnpm | yarn | bun、デフォルト: npm）。 これは Skill のインストール のみに影響します。Gateway ランタイムは引き続き Node を使用してください （WhatsApp/Telegram では Bun は推奨されません）。 これはスキルインストールにのみ影響します。ゲートウェイランタイムはノード (WhatsApp/Telegramにはお勧めしません)。
• entries.<skillKey>: Skill ごとの上書き設定。

• enabled: false を設定すると、同梱／インストール済みであっても Skill を無効化します。
• env: エージェント実行時に注入される環境変数（未設定の場合のみ）。
• apiKey: 主要な環境変数を宣言する Skills 向けの任意の利便機能です。

​

注記

• entriesの下のキーは、デフォルトでスキル名にマップされます。 entries 配下のキーは、既定では Skill 名にマッピングされます。Skill が metadata.openclaw.skillKey を定義している場合は、そのキーを使用してください。 entries 配下のキーは、既定では Skill 名にマッピングされます。Skill が metadata.openclaw.skillKey を定義している場合は、そのキーを使用してください。
• ウォッチャーが有効な場合、Skills への変更は次回のエージェントのターンで反映されます。

​

サンドボックス化された Skills と環境変数

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