Skills 設定

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

{
  skills: {
    allowBundled: ["gemini", "peekaboo"],
    load: {
      extraDirs: ["~/Projects/agent-scripts/skills", "~/Projects/oss/some-skill-pack/skills"],
      allowSymlinkTargets: ["~/Projects/manager/skills"],
      watch: true,
      watchDebounceMs: 250,
    },
    install: {
      preferBrew: true,
      nodeManager: "npm", // npm | pnpm | yarn | bun (Gateway runtime still Node; bun not recommended)
      allowUploadedArchives: false,
    },
    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 },
    },
  },
}

• ネイティブの Nano Banana Pro スタイルのセットアップ: agents.defaults.imageGenerationModel.primary: "google/gemini-3-pro-image-preview"
• ネイティブの fal セットアップ: agents.defaults.imageGenerationModel.primary: "fal/fal-ai/flux/dev"

​

エージェントのスキル許可リスト

{
  agents: {
    defaults: {
      skills: ["github", "weather"],
    },
    list: [
      { id: "writer" }, // inherits defaults -> github, weather
      { id: "docs", skills: ["docs-search"] }, // replaces defaults
      { id: "locked-down", skills: [] }, // no skills
    ],
  },
}

• agents.defaults.skills: agents.list[].skills を省略したエージェント向けの共有ベースライン許可リスト。
• 既定でスキルを制限しない場合は、agents.defaults.skills を省略します。
• agents.list[].skills: そのエージェントの明示的な最終スキルセット。既定値とはマージされません。
• agents.list[].skills: []: そのエージェントにはスキルを公開しません。

​

フィールド

• 組み込みのスキルルートには、常に ~/.openclaw/skills、~/.agents/skills、 <workspace>/.agents/skills、<workspace>/skills が含まれます。
• allowBundled: バンドル済みスキル専用の任意の許可リスト。設定すると、 リスト内のバンドル済みスキルのみが対象になります（管理対象、エージェント、ワークスペースのスキルには影響しません）。
• load.extraDirs: スキャン対象に追加するスキルディレクトリ（最も低い優先順位）。
• load.allowSymlinkTargets: シンボリックリンクされたスキルフォルダーが、そのシンボリックリンクが ターゲットルート外にある場合でも解決できる、信頼済みの実ターゲットディレクトリ。 ~/.agents/skills/manager -> ~/Projects/manager/skills のような 意図的な兄弟リポジトリ構成に使用します。
• load.watch: スキルフォルダーを監視し、スキルスナップショットを更新します（既定: true）。
• load.watchDebounceMs: スキル監視イベントのデバウンス時間（ミリ秒、既定: 250）。
• install.preferBrew: 利用可能な場合は brew インストーラーを優先します（既定: true）。
• install.nodeManager: node インストーラーの優先設定（npm | pnpm | yarn | bun、既定: npm）。 これは スキルのインストール にのみ影響します。Gateway ランタイムは引き続き Node である必要があります （Bun は WhatsApp/Telegram には推奨されません）。
  • openclaw setup --node-manager はより狭い範囲で、現時点では npm、 pnpm、または bun を受け入れます。Yarn ベースのスキルインストールを 使いたい場合は、skills.install.nodeManager: "yarn" を手動で設定してください。
• install.allowUploadedArchives: 信頼済みの operator.admin Gateway クライアントが、skills.upload.* を通じてステージングされたプライベート zip アーカイブを インストールできるようにします（既定: false）。これはアップロード済みアーカイブ経路のみを有効にします。通常の ClawHub インストールでは不要です。
• entries.<skillKey>: スキルごとの上書き設定。
• agents.defaults.skills: agents.list[].skills を省略したエージェントに 継承される任意の既定スキル許可リスト。
• agents.list[].skills: 任意のエージェントごとの最終スキル許可リスト。明示的な リストは、継承された既定値とマージされず置き換えます。

​

シンボリックリンクされた兄弟リポジトリ

{
  skills: {
    load: {
      extraDirs: ["~/Projects/manager/skills"],
      allowSymlinkTargets: ["~/Projects/manager/skills"],
    },
  },
}

• enabled: バンドル済み/インストール済みであっても、スキルを無効化するには false を設定します。
• env: エージェント実行時に注入される環境変数（未設定の場合のみ）。
• apiKey: プライマリ環境変数を宣言するスキル向けの任意の便利設定。 プレーンテキスト文字列または SecretRef オブジェクト（{ source, provider, id }）をサポートします。

​

注記

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

​

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

• Docker バックエンドには agents.defaults.sandbox.docker.env（またはエージェントごとの agents.list[].sandbox.docker.env）。
• カスタムサンドボックスイメージまたはリモートサンドボックス環境に env を組み込みます。

​

関連