スキル設定

スキル関連のすべての設定は ''~/.openclaw/openclaw.json'' の ''~/.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: {
      "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）。

これは<strong>スキルインストール</strong>にのみ影響します；ゲートウェイランタイムは引き続き Node である必要があります

（WhatsApp/Telegram では Bun は推奨されません）。

- ''entries.<skillKey>''：スキルごとのオーバーライド。

スキルごとのフィールド：

- ''enabled''：''false'' に設定して、バンドル/インストール済みでもスキルを無効化。

- ''env''：エージェント実行のために注入される環境変数（未設定の場合のみ）。

- ''apiKey''：プライマリ環境変数を宣言するスキルのオプションの便利設定。

- ''entries'' の下のキーはデフォルトでスキル名にマップされます。スキルが

''metadata.openclaw.skillKey'' を定義している場合、代わりにそのキーを使用します。

- ウォッチャーが有効な場合、スキルの変更は次のエージェントターンでピックアップされます。

セッションがサンドボックス化されている場合、スキルプロセスは Docker 内で実行されます。サンドボックスは

ホストの ''process.env'' を''継承しません''。

以下のいずれかを使用します：

- ''agents.defaults.sandbox.docker.env''（またはエージェントごとの ''agents.list[].sandbox.docker.env''）

- カスタムサンドボックスイメージに環境変数をベイクする

グローバル ''env'' と ''skills.entries.<skill>.env/apiKey'' は''ホスト''実行にのみ適用されます。