Pluginマニフェスト

このページでは、OpenClaw ネイティブ Plugin マニフェストである openclaw.plugin.json について説明します。互換バンドルレイアウト（Codex、Claude、Cursor）については、Plugin バンドルを参照してください。

互換バンドル形式では、代わりにそれぞれ独自のマニフェストファイルを使用します。

• Codex バンドル: .codex-plugin/plugin.json
• Claude バンドル: .claude-plugin/plugin.json、またはマニフェストを使用しないデフォルトの Claude コンポーネントレイアウト
• Cursor バンドル: .cursor-plugin/plugin.json

OpenClaw はこれらのレイアウトを自動検出しますが、以下の openclaw.plugin.json スキーマに照らした検証は行いません。互換バンドルの場合、レイアウトが OpenClaw のランタイム要件と一致していれば、OpenClaw はバンドルメタデータ、宣言されたスキルルート、Claude コマンドルート、Claude の settings.json デフォルト、Claude LSP デフォルト、およびサポートされるフックパックを読み取ります。

すべての OpenClaw ネイティブ Plugin は、Plugin ルートに openclaw.plugin.json を必ず含める必要があります。OpenClaw はこれを読み取り、Plugin コードを実行せずに設定を検証します。マニフェストが存在しないか無効な場合、設定の検証はブロックされ、Plugin エラーとして扱われます。

Plugin システムの完全なガイドについてはPluginを、ネイティブ機能モデルと現在の外部互換性に関するガイダンスについては機能モデルを参照してください。

このファイルの役割

openclaw.plugin.json は、OpenClaw がPlugin コードを読み込む前に読み取るメタデータです。含まれるすべての情報は、Plugin ランタイムを起動せずに低コストで検査できる必要があります。

次の用途に使用します。

• Plugin の識別、設定の検証、設定 UI のヒント
• 認証、オンボーディング、セットアップのメタデータ（エイリアス、自動有効化、プロバイダー環境変数、認証方法の選択肢）
• コントロールプレーンの各サーフェス向けの有効化ヒント
• モデルファミリーの短縮表記の所有権
• 静的な機能所有権のスナップショット（contracts）
• 共有 openclaw qa ホストが検査できる QA ランナーのメタデータ
• カタログおよび検証サーフェスに統合される、チャネル固有の設定メタデータ

次の用途には使用しないでください。 ランタイム動作の登録、コードエントリポイントの宣言、npm インストールメタデータ。これらは Plugin コードと package.json に記述します。

最小構成の例

{  "id": "voice-call",  "configSchema": {    "type": "object",    "additionalProperties": false,    "properties": {}  }}

詳細な例

{  "id": "openrouter",  "name": "OpenRouter",  "description": "OpenRouter provider plugin",  "version": "1.0.0",  "providers": ["openrouter"],  "modelSupport": {    "modelPrefixes": ["router-"]  },  "modelIdNormalization": {    "providers": {      "openrouter": {        "prefixWhenBare": "openrouter"      }    }  },  "providerEndpoints": [    {      "endpointClass": "openrouter",      "hostSuffixes": ["openrouter.ai"]    }  ],  "providerRequest": {    "providers": {      "openrouter": {        "family": "openrouter"      }    }  },  "cliBackends": ["openrouter-cli"],  "syntheticAuthRefs": ["openrouter-cli"],  "setup": {    "providers": [      {        "id": "openrouter",        "envVars": ["OPENROUTER_API_KEY"]      }    ]  },  "providerAuthAliases": {    "openrouter-coding": "openrouter"  },  "channelEnvVars": {    "openrouter-chatops": ["OPENROUTER_CHATOPS_TOKEN"]  },  "providerAuthChoices": [    {      "provider": "openrouter",      "method": "api-key",      "choiceId": "openrouter-api-key",      "choiceLabel": "OpenRouter API key",      "groupId": "openrouter",      "groupLabel": "OpenRouter",      "optionKey": "openrouterApiKey",      "cliFlag": "--openrouter-api-key",      "cliOption": "--openrouter-api-key <key>",      "cliDescription": "OpenRouter API key",      "onboardingScopes": ["text-inference"]    }  ],  "uiHints": {    "apiKey": {      "label": "API key",      "placeholder": "sk-or-v1-...",      "sensitive": true    }  },  "configSchema": {    "type": "object",    "additionalProperties": false,    "properties": {      "apiKey": {        "type": "string"      }    }  }}

トップレベルフィールドのリファレンス

catalog リファレンス

catalog は、Plugin ブラウザー向けの任意の表示ヒントを提供します。ホストはこれらのヒントを無視できます。これらによって Plugin がインストールまたは有効化されることはなく、実行時の動作や信頼レベルも変更されません。

{  "catalog": {    "featured": true,    "order": 10  }}

生成プロバイダーのメタデータリファレンス

生成プロバイダーのメタデータフィールドは、対応する contracts.*GenerationProviders リストで宣言されたプロバイダーの静的認証シグナルを記述します。OpenClaw はプロバイダーのランタイムが読み込まれる前にこれらのフィールドを読み取るため、コアツールはすべてのプロバイダー Plugin をインポートせずに、生成プロバイダーが利用可能かどうかを判断できます。

これらのフィールドは、低コストで宣言的な事実にのみ使用してください。トランスポート、リクエスト変換、トークン更新、認証情報の検証、実際の生成動作は Plugin のランタイムが引き続き担います。

{  "contracts": {    "imageGenerationProviders": ["example-image"]  },  "imageGenerationProviderMetadata": {    "example-image": {      "aliases": ["example-image-oauth"],      "authProviders": ["example-image"],      "configSignals": [        {          "rootPath": "plugins.entries.example-image.config",          "overlayPath": "image",          "mode": {            "path": "mode",            "default": "local",            "allowed": ["local"]          },          "requiredAny": ["workflow", "workflowPath"],          "required": ["promptNodeId"]        }      ],      "authSignals": [        {          "provider": "example-image"        },        {          "provider": "example-image-oauth",          "providerBaseUrl": {            "provider": "example-image",            "defaultBaseUrl": "https://api.example.com/v1",            "allowedBaseUrls": ["https://api.example.com/v1"]          }        }      ]    }  }}

各メタデータエントリは次のフィールドに対応しています。

各 configSignals エントリは次のフィールドに対応しています。

各 mode ガードは次のフィールドに対応しています。

各 authSignals エントリは次のフィールドに対応しています。

各 providerBaseUrl ガードは次のフィールドに対応しています。

ツールメタデータのリファレンス

toolMetadata は、ツール名をキーとして、生成プロバイダーのメタデータと同じ configSignals および authSignals の形式を使用します。contracts.tools は所有権を宣言します。toolMetadata は低コストな可用性の証拠を宣言するため、OpenClaw はツールファクトリーが null を返すか確認するためだけに Plugin のランタイムをインポートせずに済みます。

{  "setup": {    "providers": [      {        "id": "example",        "envVars": ["EXAMPLE_API_KEY"]      }    ]  },  "contracts": {    "tools": ["example_search"]  },  "toolMetadata": {    "example_search": {      "authSignals": [        {          "provider": "example"        }      ],      "configSignals": [        {          "rootPath": "plugins.entries.example.config",          "overlayPath": "search",          "required": ["apiKey"]        }      ]    }  }}

toolMetadata エントリでは、上記の共通 configSignals / authSignals フィールドに加えて、optional（Plugin の有効化に必須ではないツールとしてマーク）と replaySafe（モデルのターンが不完全に終了した後でも、安全に再実行できるツールとしてマーク）も指定できます。

ツールに toolMetadata がない場合、OpenClaw は既存の動作を維持し、ツールコントラクトがポリシーに一致すると所有元の Plugin を読み込みます。ファクトリーが認証や設定に依存するホットパスのツールでは、コアが問い合わせのためにランタイムをインポートするようにするのではなく、Plugin の作成者が toolMetadata を宣言する必要があります。

providerAuthChoices リファレンス

各 providerAuthChoices エントリは、1 つのオンボーディングまたは認証の選択肢を記述します。OpenClaw はプロバイダーのランタイムが読み込まれる前にこれを読み取ります。プロバイダーのセットアップ一覧では、プロバイダーのランタイムを読み込まずに、これらのマニフェストの選択肢、記述子から導出されたセットアップの選択肢、インストールカタログのメタデータを使用します。

commandAliases リファレンス

Plugin がランタイムコマンド名を所有し、ユーザーが誤ってその名前を plugins.allow に指定したり、ルート CLI コマンドとして実行しようとしたりする可能性がある場合は、commandAliases を使用する。OpenClaw は、Plugin のランタイムコードをインポートせずに、このメタデータを診断に使用する。

{  "commandAliases": [    {      "name": "dreaming",      "kind": "runtime-slash",      "cliCommand": "memory"    }  ]}

activation リファレンス

Plugin が、どのコントロールプレーンイベントで自身を有効化／読み込み計画に含めるべきかを低コストで宣言できる場合は、activation を使用する。

このブロックはプランナー用メタデータであり、ライフサイクル API ではない。ランタイム動作を登録せず、register(...) の代わりにもならず、Plugin コードがすでに実行済みであることも保証しない。有効化プランナーはこれらのフィールドを使用して候補 Plugin を絞り込み、その後、providers、channels、commandAliases、setup.providers、contracts.tools、フックなどの既存のマニフェスト所有権メタデータにフォールバックする。

すでに所有権を表している最も限定的なメタデータを優先する。関係を表現できる場合は、providers、channels、commandAliases、セットアップ記述子、または contracts を使用する。それらの所有権フィールドでは表現できない追加のプランナーヒントには、activation を使用する。claude-cli、my-cli、google-gemini-cli などの CLI ランタイムエイリアスには、トップレベルの cliBackends を使用する。activation.onAgentHarnesses は、既存の所有権フィールドを持たない組み込みエージェントハーネス ID 専用である。

すべての Plugin は、activation.onStartup を意図的に設定する必要がある。Gateway の起動中に Plugin を実行する必要がある場合にのみ、true に設定する。起動時には何もせず、より限定的なトリガーによってのみ読み込む場合は、false に設定する。onStartup を省略しても、Plugin が暗黙的に起動時に読み込まれることはなくなった。起動、チャンネル、設定、エージェントハーネス、メモリ、またはその他のより限定的な有効化トリガーには、明示的な有効化メタデータを使用する。

{  "activation": {    "onStartup": false,    "onProviders": ["openai"],    "onCommands": ["models"],    "onChannels": ["web"],    "onRoutes": ["gateway-webhook"],    "onConfigPaths": ["browser"],    "onCapabilities": ["provider", "tool"]  }}

現在の実運用コンシューマー:

• Gateway の起動計画では、明示的な起動時インポートに activation.onStartup を使用する。
• コマンドをトリガーとする CLI 計画では、旧形式の commandAliases[].cliCommand または commandAliases[].name にフォールバックする。
• エージェントランタイムの起動計画では、組み込みハーネスに activation.onAgentHarnesses を使用し、CLI ランタイムエイリアスにトップレベルの cliBackends[] を使用する。
• チャンネルをトリガーとするセットアップ／チャンネル計画では、明示的なチャンネル有効化メタデータがない場合、旧形式の channels[] 所有権にフォールバックする。
• 起動時の Plugin 計画では、バンドルされたブラウザー Plugin の browser ブロックなど、チャンネル以外のルート設定領域に activation.onConfigPaths を使用する。
• プロバイダーをトリガーとするセットアップ／ランタイム計画では、明示的なプロバイダー有効化メタデータがない場合、旧形式の providers[] およびトップレベルの cliBackends[] 所有権にフォールバックする。

プランナー診断では、明示的な有効化ヒントとマニフェスト所有権へのフォールバックを区別できる。たとえば、activation-command-hint は activation.onCommands が一致したことを意味し、manifest-command-alias はプランナーが代わりに commandAliases の所有権を使用したことを意味する。これらの理由ラベルはホスト診断およびテスト用である。Plugin 作成者は、所有権を最も適切に表すメタデータを引き続き宣言する必要がある。

qaRunners リファレンス

Plugin が共有の openclaw qa ルート配下に 1 つ以上のトランスポートランナーを提供する場合は、qaRunners を使用する。このメタデータは軽量かつ静的に保つ。実際の CLI 登録は、対応する qaRunnerCliRegistrations をエクスポートする軽量な runtime-api.ts インターフェースを通じて、引き続き Plugin ランタイムが所有する。任意の adapterFactory は、登録済みコマンドのランナーを変更せずに、トランスポートを共有 QA シナリオに公開する。

{  "qaRunners": [    {      "commandName": "matrix",      "description": "Run the Docker-backed Matrix live QA lane against a disposable homeserver"    }  ]}

adapterFactory の id は commandName と一致する必要があります。マニフェストに存在しないコマンドの登録をエクスポートしないでください。

setup リファレンス

ランタイムの読み込み前に、セットアップとオンボーディングのサーフェスで低コストな Plugin 所有のメタデータが必要な場合は、setup を使用します。

{  "setup": {    "providers": [      {        "id": "openai",        "authMethods": ["api-key"],        "envVars": ["OPENAI_API_KEY"],        "authEvidence": [          {            "type": "local-file-with-env",            "fileEnvVar": "OPENAI_CREDENTIALS_FILE",            "requiresAllEnv": ["OPENAI_PROJECT"],            "credentialMarker": "openai-local-credentials",            "source": "openai local credentials"          }        ]      }    ],    "cliBackends": ["openai-cli"],    "configMigrations": ["legacy-openai-auth"],    "requiresRuntime": false  }}

トップレベルの cliBackends は引き続き有効で、CLI 推論バックエンドを記述します。setup.cliBackends は、メタデータのみに留めるべきコントロールプレーン／セットアップフロー向けの、セットアップ固有の記述子サーフェスです。

setup.providers と setup.cliBackends が存在する場合、セットアップ検出では、記述子を優先する検索サーフェスとしてこれらが推奨されます。記述子が候補 Plugin を絞り込むだけで、セットアップ時にさらに高度なランタイムフックが必要な場合は、requiresRuntime: true を設定し、フォールバック実行パスとして setup-api を維持してください。

OpenClaw は、汎用的なプロバイダー認証と環境変数の検索にも setup.providers[].envVars を含めます。providerAuthEnvVars は非推奨期間中、互換アダプターを通じて引き続きサポートされますが、これを使用し続けるバンドル外の Plugin にはマニフェスト診断が表示されます。新しい Plugin では、セットアップ／ステータス用の環境変数メタデータを setup.providers[].envVars に配置してください。

課金または組織レベルの資格情報によって、推論用資格情報として扱わずに resolveUsageAuth を有効化する必要がある場合は、providerUsageAuthEnvVars を使用します。これらの名前は、ワークスペースの dotenv ブロック、ACP 子プロセスからの除去、サンドボックスのシークレットフィルタリング、および広範なシークレット消去の対象になります。プロバイダーランタイムは、引き続き resolveUsageAuth 内で値を読み取り、分類します。

セットアップエントリがない場合、または setup.requiresRuntime: false によりセットアップランタイムが不要と宣言されている場合、OpenClaw は setup.providers[].authMethods から単純なセットアップ選択肢を導出することもできます。カスタムラベル、CLI フラグ、オンボーディングのスコープ、アシスタントのメタデータには、明示的な providerAuthChoices エントリが引き続き優先されます。

これらの記述子だけでセットアップサーフェスに十分な場合に限り、requiresRuntime: false を設定してください。OpenClaw は明示的な false を記述子のみの契約として扱い、セットアップ検索のために setup-api または openclaw.setupEntry を実行しません。記述子のみの Plugin がこれらのセットアップランタイムエントリのいずれかを提供している場合でも、OpenClaw は追加診断を報告し、そのエントリを引き続き無視します。requiresRuntime を省略すると従来のフォールバック動作が維持されるため、フラグなしで記述子を追加した既存の Plugin が破損することはありません。

セットアップ検索では Plugin 所有の setup-api コードを実行できるため、正規化された setup.providers[].id と setup.cliBackends[] の値は、検出されたすべての Plugin 間で一意である必要があります。所有者が曖昧な場合、検出順から優先対象を選ぶのではなく、フェイルクローズします。

セットアップランタイムが実行される場合、setup-api がマニフェスト記述子に宣言されていないプロバイダーまたは CLI バックエンドを登録したとき、あるいは記述子に対応するランタイム登録がないとき、セットアップレジストリ診断は記述子の不一致を報告します。これらの診断は追加的なものであり、従来の Plugin を拒否するものではありません。

setup.providers リファレンス

authEvidence は、ランタイムコードを読み込まずに検証できる、プロバイダー所有のローカル資格情報マーカー用です。これらのチェックは低コストかつローカルに留める必要があります。ネットワーク呼び出し、キーチェーンまたはシークレットマネージャーの読み取り、シェルコマンド、およびプロバイダー API のプローブは使用できません。

サポートされる証拠エントリ：

setup フィールド

uiHints リファレンス

uiHints は、設定フィールド名から小さなレンダリングヒントへのマップです。ネストされた設定フィールドにはドット区切りのキーを使用できますが、パスセグメントに __proto__、constructor、または prototype を含めることはできず、セットアップはこれらの名前を拒否します。

{  "uiHints": {    "apiKey": {      "label": "API key",      "help": "Used for OpenRouter requests",      "placeholder": "sk-or-v1-...",      "sensitive": true    }  }}

各フィールドヒントには、次の項目を含めることができます。

contracts リファレンス

Plugin ランタイムをインポートせずに OpenClaw が読み取れる、静的な機能所有権メタデータに限り contracts を使用します。

{  "contracts": {    "agentToolResultMiddleware": ["openclaw", "codex"],    "trustedToolPolicies": ["workflow-budget"],    "externalAuthProviders": ["acme-ai"],    "embeddingProviders": ["openai-compatible"],    "speechProviders": ["openai"],    "realtimeTranscriptionProviders": ["openai"],    "realtimeVoiceProviders": ["openai"],    "memoryEmbeddingProviders": ["local"],    "mediaUnderstandingProviders": ["openai"],    "imageGenerationProviders": ["openai"],    "videoGenerationProviders": ["qwen"],    "musicGenerationProviders": ["stability-audio"],    "documentExtractors": ["example-docs"],    "webContentExtractors": ["firecrawl"],    "webFetchProviders": ["firecrawl"],    "webSearchProviders": ["gemini"],    "workerProviders": ["example-worker"],    "usageProviders": ["acme-ai"],    "migrationProviders": ["hermes"],    "gatewayMethodDispatch": ["authenticated-request"],    "tools": ["firecrawl_search", "firecrawl_scrape"]  }}

各リストは任意です。

contracts.embeddedExtensionFactories は、同梱の Codex app-server 専用拡張ファクトリー用として維持されています。同梱のツール結果変換は、代わりに contracts.agentToolResultMiddleware を宣言し、api.registerAgentToolResultMiddleware(...) で登録する必要があります。インストール済み Plugin は、明示的に有効化され、かつ contracts.agentToolResultMiddleware で宣言したランタイムに限り、同じミドルウェア接続点を使用できます。

ホストが信頼するツール実行前ポリシー層を必要とするインストール済み Plugin は、登録する各ローカル ID を contracts.trustedToolPolicies で宣言し、明示的に有効化される必要があります。同梱 Plugin は既存の信頼済みポリシー経路を引き続き使用できますが、未宣言のポリシー ID を持つインストール済み Plugin は登録前に拒否されます。ポリシー ID は登録元 Plugin のスコープ内にあるため、2 つの Plugin がともに workflow-budget を宣言して登録できますが、単一の Plugin が同じローカル ID を 2 回登録することはできません。

実行時の api.registerTool(...) 登録は contracts.tools と一致する必要があります。ツール検出ではこのリストを使用し、要求されたツールを所有できる Plugin ランタイムだけを読み込みます。

resolveExternalAuthProfiles を実装するプロバイダー Plugin は、contracts.externalAuthProviders を宣言する必要があります。未宣言の外部認証フックは無視されます。

resolveUsageAuth と fetchUsageSnapshot の両方を実装するプロバイダー Plugin は、自動検出される各プロバイダー ID を contracts.usageProviders で宣言する必要があります。使用量検出では、ランタイムコードを読み込む前にこの契約を参照し、宣言された所有者だけを読み込んだ後で両方のフックを検証します。

汎用埋め込みプロバイダーは、api.registerEmbeddingProvider(...) で登録する各アダプターについて contracts.embeddingProviders を宣言する必要があります。メモリ検索で利用されるプロバイダーを含む、再利用可能なベクトル生成には汎用契約を使用してください。contracts.memoryEmbeddingProviders は非推奨のメモリ固有互換機能であり、既存プロバイダーが汎用埋め込みプロバイダー接続点へ移行する間だけ維持されます。

ワーカープロバイダーは、api.registerWorkerProvider(...) の各 ID を contracts.workerProviders で宣言する必要があります。コアは provision を呼び出す前に永続的な意図を保存します。プロバイダーは外部リソースを割り当てる前に設定を検証し、同じ操作 ID で繰り返し呼び出された場合は同じリースを引き継ぐ必要があります。コアは検証済み設定のスナップショットも保存し、名前付きプロファイルが変更または削除された後も含めて、leaseId とともに inspect({ leaseId, profile }) および destroy({ leaseId, profile }) に渡します。破棄は冪等であり、検査は閉じた active / destroyed / unknown ステータスの共用体を返します。また、SSH 秘密鍵素材は SecretRef を通じてのみ参照されます。プロビジョニングされた SSH エンドポイントには、信頼済みのプロビジョニング出力から得た公開 hostKey も、ホスト名やコメントを含めず、正確に algorithm base64 形式で含める必要があります。これにより、コアは接続前にホストを固定できます。動的な ID 参照を発行するプロバイダーは、正式な resolveSshIdentity({ leaseId, profile, keyRef }) を実装できます。これを持たないプロバイダーは、コアの汎用シークレットリゾルバーを使用します。正式な unknown は、アクティブなローカルレコードを孤立状態にします。永続化された破棄要求の後では、これが破棄完了を確認します。

contracts.gatewayMethodDispatch は現在 "authenticated-request" を受け付けます。これは、意図的に Gateway コントロールプレーンメソッドをプロセス内でディスパッチするネイティブ Plugin HTTP ルートのための API 衛生ゲートであり、悪意あるネイティブ Plugin に対するサンドボックスではありません。すでに Gateway HTTP 認証を必要とする、厳密にレビューされた同梱または運用者向けのサーフェスにのみ使用してください。権限を付与されたルートが、Gateway のルート作業受付が閉じている間も到達可能になるのは、そのルートが auth: "gateway" と、ルート固有の gatewayRuntimeScopeSurface: "trusted-operator" の両方を宣言している場合だけです。同じ Plugin の通常の兄弟ルートは、引き続き受付境界の背後に留まります。これにより、Plugin 全体へ受付回避権限を与えることなく、一時停止状態の確認と再開を到達可能なまま維持できます。ディスパッチ外での解析とレスポンス整形は限定的に保ってください。実質的な処理や変更を伴う処理は、受付とスコープの強制を担う Gateway メソッドディスパッチを経由する必要があります。

configContracts リファレンス

Plugin ランタイムをインポートせずに汎用コアヘルパーが必要とする、マニフェスト所有の設定動作には configContracts を使用します。対象は、危険なフラグの検出、SecretRef 移行先、従来の設定パスの絞り込みです。

{  "configContracts": {    "compatibilityMigrationPaths": ["legacyProvider"],    "compatibilityRuntimePaths": ["legacyProvider.webhook"],    "dangerousFlags": [      {        "path": "accounts.*.allowUnverifiedSenders",        "equals": true      }    ],    "secretInputs": {      "bundledDefaultEnabled": false,      "paths": [        {          "path": "apiKey",          "expected": "string"        }      ]    }  }}

各 dangerousFlags エントリは次をサポートします。

secretInputs は次をサポートします。

mediaUnderstandingProviderMetadata リファレンス

メディア理解プロバイダーにデフォルトモデル、自動認証フォールバックの優先順位、または汎用コアヘルパーがランタイムのロード前に必要とするネイティブ文書対応がある場合は、mediaUnderstandingProviderMetadata を使用します。キーは contracts.mediaUnderstandingProviders にも宣言する必要があります。

{  "contracts": {    "mediaUnderstandingProviders": ["example"]  },  "mediaUnderstandingProviderMetadata": {    "example": {      "capabilities": ["image", "audio"],      "defaultModels": {        "image": "example-vision-latest",        "audio": "example-transcribe-latest"      },      "autoPriority": {        "image": 40      },      "nativeDocumentInputs": ["pdf"],      "documentModels": {        "pdf": {          "textExtraction": "example-doc-text-latest",          "image": "example-doc-vision-latest"        }      }    }  }}

各プロバイダーエントリには、次の項目を含めることができます。

channelConfigs リファレンス

チャンネル Plugin がランタイムのロード前に軽量な設定メタデータを必要とする場合は、channelConfigs を使用します。読み取り専用のチャンネル設定・ステータス検出では、設定エントリがない場合、または setup.requiresRuntime: false によって設定時にランタイムが不要と宣言されている場合、設定済みの外部チャンネルに対してこのメタデータを直接使用できます。

channelConfigs は Plugin マニフェストのメタデータであり、新しいトップレベルのユーザー設定セクションではありません。ユーザーは引き続き channels.<channel-id> でチャンネルインスタンスを設定します。OpenClaw は、Plugin のランタイムコードが実行される前に、設定されたチャンネルをどの Plugin が所有するか判断するためにマニフェストのメタデータを読み取ります。

チャンネル Plugin では、configSchema と channelConfigs は異なるパスを記述します。

• configSchema は plugins.entries.<plugin-id>.config を検証します
• channelConfigs.<channel-id>.schema は channels.<channel-id> を検証します

channels[] を宣言する非同梱 Plugin は、一致する channelConfigs エントリも宣言する必要があります。宣言がなくても OpenClaw は Plugin をロードできますが、コールドパスの設定スキーマ、セットアップ、および Control UI サーフェスは、Plugin ランタイムが実行されるまでチャンネル所有のオプション構造を把握できません。

channelConfigs.<channel-id>.commands.nativeCommandsAutoEnabled と nativeSkillsAutoEnabled では、チャンネルランタイムのロード前に実行されるコマンド設定チェック用の静的な auto デフォルトを宣言できます。同梱チャンネルは、パッケージ所有の他のチャンネルカタログメタデータとともに、package.json#openclaw.channel.commands を通じて同じデフォルトを公開することもできます。

{  "channelConfigs": {    "matrix": {      "schema": {        "type": "object",        "additionalProperties": false,        "properties": {          "homeserverUrl": { "type": "string" }        }      },      "uiHints": {        "homeserverUrl": {          "label": "Homeserver URL",          "placeholder": "https://matrix.example.com"        }      },      "label": "Matrix",      "description": "Matrix homeserver connection",      "commands": {        "nativeCommandsAutoEnabled": true,        "nativeSkillsAutoEnabled": true      },      "preferOver": ["matrix-legacy"]    }  }}

各チャンネルエントリには、次の項目を含めることができます。

別のチャンネル Plugin の置き換え

別の Plugin も提供できるチャンネル ID に対して、自分の Plugin を優先所有者とする場合は preferOver を使用します。一般的なケースとして、Plugin ID の名称変更、同梱 Plugin を置き換えるスタンドアロン Plugin、または設定の互換性のために同じチャンネル ID を維持する、メンテナンスされたフォークがあります。

{  "id": "acme-chat",  "channels": ["chat"],  "channelConfigs": {    "chat": {      "schema": {        "type": "object",        "additionalProperties": false,        "properties": {          "webhookUrl": { "type": "string" }        }      },      "preferOver": ["chat"]    }  }}

channels.chat が設定されている場合、OpenClaw はチャンネル ID と優先 Plugin ID の両方を考慮します。優先度の低い Plugin が、同梱されているかデフォルトで有効になっているという理由だけで選択されていた場合、OpenClaw は実効ランタイム設定でその Plugin を無効化し、1 つの Plugin がチャンネルとそのツールを所有するようにします。ユーザーによる明示的な選択は引き続き優先されます。ユーザーが両方の Plugin を明示的に有効化した場合（plugins.allow または実体のある plugins.entries 設定を使用）、OpenClaw は要求された Plugin セットを暗黙に変更せず、その選択を維持してチャンネルやツールの重複診断を報告します。

preferOver は、実際に同じチャンネルを提供できる Plugin ID のみに限定してください。これは汎用的な優先順位フィールドではなく、ユーザー設定キーの名前を変更するものでもありません。

modelSupport リファレンス

Plugin ランタイムのロード前に、OpenClaw が gpt-5.6-sol や claude-sonnet-4.6 のような短縮モデル ID からプロバイダー Plugin を推論する必要がある場合は、modelSupport を使用します。

{  "modelSupport": {    "modelPrefixes": ["gpt-", "o1", "o3", "o4"],    "modelPatterns": ["^computer-use-preview"]  }}

OpenClaw は次の優先順位を適用します。

• 明示的な provider/model 参照では、所有元の providers マニフェストメタデータを使用します
• modelPatterns は modelPrefixes より優先されます
• 非同梱 Plugin と同梱 Plugin が両方とも一致する場合、非同梱 Plugin が優先されます
• 残る曖昧さは、ユーザーまたは設定がプロバイダーを指定するまで無視されます

フィールド:

modelPatterns のエントリは compileSafeRegex を通じてコンパイルされ、ネストした繰り返しを含むパターン（例: (a+)+$）は拒否されます。安全性チェックに失敗したパターンは、構文的に無効な正規表現と同様に暗黙にスキップされます。パターンは単純に保ち、ネストした量指定子は避けてください。

modelCatalog リファレンス

Plugin ランタイムのロード前に、OpenClaw がプロバイダーのモデルメタデータを認識する必要がある場合は、modelCatalog を使用します。これは、固定カタログ行、プロバイダーエイリアス、抑制ルール、および検出モードに関する、マニフェスト所有の情報源です。ランタイムでの更新は引き続きプロバイダーのランタイムコードが担当しますが、ランタイムが必要になるタイミングはマニフェストがコアに通知します。

{  "providers": ["openai"],  "modelCatalog": {    "providers": {      "openai": {        "baseUrl": "https://api.openai.com/v1",        "api": "openai-responses",        "models": [          {            "id": "gpt-5.4",            "name": "GPT-5.4",            "input": ["text", "image"],            "reasoning": true,            "contextWindow": 256000,            "maxTokens": 128000,            "cost": {              "input": 1.25,              "output": 10,              "cacheRead": 0.125            },            "status": "available",            "tags": ["default"]          }        ]      }    },    "aliases": {      "azure-openai-responses": {        "provider": "openai",        "api": "azure-openai-responses"      }    },    "suppressions": [      {        "provider": "azure-openai-responses",        "model": "gpt-5.3-codex-spark",        "reason": "not available on Azure OpenAI Responses"      }    ],    "discovery": {      "openai": "static"    }  }}

トップレベルのフィールド:

aliasesは、モデルカタログの計画におけるプロバイダー所有権の検索に関与します。エイリアスのターゲットは、同じPluginが所有するトップレベルのプロバイダーでなければなりません。プロバイダーで絞り込まれたリストがエイリアスを使用する場合、OpenClawはプロバイダーランタイムを読み込まずに、所有元のマニフェストを読み取り、エイリアスのAPI／ベースURLオーバーライドを適用できます。エイリアスは絞り込まれていないカタログ一覧を展開しません。広範なリストでは、所有元の正規プロバイダー行のみが出力されます。

suppressionsは、旧プロバイダーランタイムのsuppressBuiltInModelフックを置き換えます。抑制エントリが適用されるのは、プロバイダーがそのPluginによって所有されている場合、または所有するプロバイダーをターゲットとするmodelCatalog.aliasesキーとして宣言されている場合のみです。モデル解決中にランタイム抑制フックが呼び出されることはなくなりました。

プロバイダーフィールド：

モデルフィールド：

抑制フィールド：

ランタイム専用データをmodelCatalogに含めないでください。マニフェスト行が十分に完全であり、プロバイダーで絞り込まれたリストと選択ツールがレジストリ／ランタイム検出を省略できる場合にのみstaticを使用します。マニフェスト行が一覧表示可能な有用な初期データまたは補足データであり、後から更新／キャッシュによって行を追加できる場合はrefreshableを使用します。更新可能な行だけでは信頼できる完全な情報源にはなりません。OpenClawが一覧を把握するためにプロバイダーランタイムを読み込む必要がある場合はruntimeを使用します。

modelIdNormalizationリファレンス

プロバイダーランタイムの読み込み前に実行する必要がある、低コストなプロバイダー所有のモデルID正規化にはmodelIdNormalizationを使用します。これにより、短縮モデル名、プロバイダー内の旧モデルID、プロキシプレフィックス規則などのエイリアスを、コアのモデル選択テーブルではなく所有元Pluginのマニフェストに保持できます。

{  "providers": ["anthropic", "openrouter"],  "modelIdNormalization": {    "providers": {      "anthropic": {        "aliases": {          "sonnet-4.6": "claude-sonnet-4-6"        }      },      "openrouter": {        "prefixWhenBare": "openrouter"      }    }  }}

プロバイダーフィールド：

providerEndpointsリファレンス

プロバイダーランタイムの読み込み前に汎用リクエストポリシーが把握する必要のあるエンドポイント分類には、providerEndpointsを使用します。各endpointClassの意味は引き続きコアが所有し、ホストとベースURLのメタデータはPluginマニフェストが所有します。

公式に外部化されたプロバイダーPluginはコア配布物から除外されるため、 インストールされるまでそのマニフェストは参照できません。Pluginなしでも エンドポイント分類が機能し続けるように、そのproviderEndpointsも scripts/lib/official-external-provider-catalog.jsonに複製する必要があります。 契約テストによってこの複製が検証されます。

エンドポイントフィールド：

providerRequest リファレンス

プロバイダーランタイムを読み込まずに汎用リクエストポリシーが必要とする、軽量なリクエスト互換性メタデータには providerRequest を使用します。動作固有のペイロード書き換えは、プロバイダーランタイムのフックまたは共有プロバイダーファミリーヘルパーに保持します。

{  "providerRequest": {    "providers": {      "vllm": {        "family": "vllm",        "openAICompletions": {          "supportsStreamingUsage": true        }      }    }  }}

プロバイダーフィールド:

secretProviderIntegrations リファレンス

Plugin が再利用可能な SecretRef exec プロバイダープリセットを公開できる場合は、secretProviderIntegrations を使用します。OpenClaw は Plugin ランタイムの読み込み前にこのメタデータを読み取り、Plugin の所有情報を secrets.providers.<alias>.pluginIntegration に保存し、実際のシークレット解決は SecretRef ランタイムに委ねます。プリセットは、バンドル済み Plugin と、git や ClawHub からのインストールなど、管理対象の Plugin インストールルートから検出されたインストール済み Plugin に対してのみ公開されます。

{  "secretProviderIntegrations": {    "secret-store": {      "providerAlias": "team-secrets",      "displayName": "Team secrets",      "source": "exec",      "command": "${node}",      "args": ["./bin/resolve-secrets.mjs"]    }  }}

マップのキーは統合 ID です。providerAlias を省略した場合、OpenClaw は統合 ID を SecretRef プロバイダーエイリアスとして使用します。プロバイダーエイリアスは、team-secrets や onepassword-work など、通常の SecretRef プロバイダーエイリアスのパターンに一致する必要があります。

オペレーターがプリセットを選択すると、OpenClaw は次のようなプロバイダー参照を書き込みます。

{  "secrets": {    "providers": {      "team-secrets": {        "source": "exec",        "pluginIntegration": {          "pluginId": "acme-secrets",          "integrationId": "secret-store"        }      }    }  }}

起動時または再読み込み時に、OpenClaw は現在の Plugin マニフェストメタデータを読み込み、所有元の Plugin がインストール済みかつ有効であることを確認し、マニフェストから exec コマンドを具体化して、そのプロバイダーを解決します。Plugin を無効化または削除すると、アクティブな SecretRef に対するそのプロバイダーの使用権が取り消されます。スタンドアロンの exec 設定を使用するオペレーターは、引き続き手動の command/args プロバイダーを直接記述できます。

現在サポートされているのは source: "exec" プリセットのみです。command は ${node} である必要があり、args[0] は Plugin ルートからの相対パスである ./ 形式のリゾルバースクリプトでなければなりません。OpenClaw は起動時または再読み込み時に、これを現在の Node 実行ファイルと Plugin 内スクリプトの絶対パスへ具体化します。--require、--import、--loader、--env-file、--eval、--print などの Node オプションは、マニフェストプリセットの契約には含まれません。Node 以外のコマンドが必要なオペレーターは、スタンドアロンの手動 exec プロバイダーを直接設定できます。

OpenClaw は、マニフェストプリセットの trustedDirs を Plugin ルートから導出し、${node} プリセットの場合は現在の Node 実行ファイルのディレクトリも使用します。マニフェストで指定された trustedDirs は無視されます。timeoutMs、noOutputTimeoutMs、maxOutputBytes、jsonOnly、env、passEnv、allowInsecurePath など、その他の exec プロバイダーオプションは通常の SecretRef exec プロバイダー設定にそのまま渡されます。

modelPricing リファレンス

ランタイムの読み込み前にプロバイダーがコントロールプレーンの価格設定動作を制御する必要がある場合は、modelPricing を使用します。Gateway の価格キャッシュは、プロバイダーランタイムコードをインポートせずにこのメタデータを読み取ります。

{  "providers": ["ollama", "openrouter"],  "modelPricing": {    "providers": {      "ollama": {        "external": false      },      "openrouter": {        "openRouter": {          "passthroughProviderModel": true        },        "liteLLM": false      }    }  }}

プロバイダーフィールド:

ソースフィールド:

OpenClaw プロバイダーインデックス

OpenClaw プロバイダーインデックスは、Plugin がまだインストールされていない可能性があるプロバイダー向けの、OpenClaw が所有するプレビューメタデータです。これは Plugin マニフェストの一部ではありません。インストール済み Plugin の正式な情報源は引き続き Plugin マニフェストです。プロバイダーインデックスは、プロバイダー Plugin がインストールされていない場合に、将来のインストール可能プロバイダー画面やインストール前のモデル選択画面が使用する内部フォールバック契約です。

カタログの優先順位:

1. ユーザー設定。
2. インストール済み Plugin マニフェストの modelCatalog。
3. 明示的な更新によるモデルカタログキャッシュ。
4. OpenClaw プロバイダーインデックスのプレビュー行。

プロバイダーインデックスには、シークレット、有効状態、ランタイムフック、または実際のアカウント固有のモデルデータを含めてはいけません。そのプレビューカタログでは Plugin マニフェストと同じ modelCatalog プロバイダー行の形式を使用しますが、api、baseUrl、価格設定、互換性フラグなどのランタイムアダプターフィールドをインストール済み Plugin マニフェストと意図的に同期させる場合を除き、安定した表示メタデータに限定する必要があります。実際の /models 検出を行うプロバイダーは、通常の一覧表示やオンボーディングでプロバイダー API を呼び出すのではなく、明示的なモデルカタログキャッシュ経路を通じて更新行を書き込む必要があります。

プロバイダーインデックスのエントリには、Plugin がコアから移動したか、まだインストールされていないプロバイダー向けに、インストール可能な Plugin のメタデータを含めることもできます。このメタデータはチャネルカタログのパターンを踏襲します。パッケージ名、npm インストール指定、想定される整合性情報、軽量な認証選択肢ラベルがあれば、インストール可能なセットアップオプションを表示するのに十分です。Plugin がインストールされると、そのマニフェストが優先され、そのプロバイダーのプロバイダーインデックスエントリは無視されます。

openclaw doctor --fix は、従来のトップレベルマニフェスト機能キーのうち、限定された固定セットを contracts.* に移行します。対象は speechProviders、mediaUnderstandingProviders、imageGenerationProviders、tools です。これらのキーを含め、すべての機能リストはトップレベルのマニフェストフィールドとしては読み取られなくなりました。通常のマニフェスト読み込みでは、contracts 配下にある場合のみ認識されます。

マニフェストと package.json の違い

2 つのファイルは異なる役割を担います。

メタデータをどちらに配置すべきか不明な場合は、次の規則を使用します。

• Plugin コードを読み込む前に OpenClaw が知る必要がある場合は、openclaw.plugin.json に配置します
• パッケージング、エントリーファイル、または npm のインストール動作に関する場合は、package.json に配置します

検出に影響する package.json フィールド

一部のランタイム前 Plugin メタデータは、意図的に openclaw.plugin.json ではなく、package.json の openclaw ブロック配下に置かれます。openclaw.bundle と openclaw.bundle.json は OpenClaw Plugin の契約ではありません。ネイティブ Plugin は、openclaw.plugin.json と、以下でサポートされている package.json#openclaw フィールドを使用する必要があります。

重要な例:

マニフェストメタデータは、ランタイムの読み込み前にオンボーディングへ表示するプロバイダー／チャネル／セットアップの選択肢を決定します。package.json#openclaw.install は、ユーザーがそれらの選択肢のいずれかを選んだとき、その Plugin を取得または有効化する方法をオンボーディングへ伝えます。インストールのヒントを openclaw.plugin.json へ移動しないでください。

openclaw.install.minHostVersion は、バンドルされていない Plugin ソースのインストール時およびマニフェストレジストリ読み込み時に適用されます。無効な値は拒否されます。有効でも新しすぎる値の場合、古いホストでは外部 Plugin がスキップされます。バンドルされたソース Plugin は、ホストのチェックアウトと同じバージョンであると見なされます。

openclaw.install.requiredPlatformPackages は、オプションのプラットフォーム固有エイリアスを通じて必須のネイティブバイナリを公開する npm パッケージ向けです。サポート対象の各プラットフォームエイリアスについて、修飾なしの npm パッケージ名を列挙してください。npm インストール中、OpenClaw はロックファイルの制約が現在のホストと一致する、宣言済みエイリアスのみを検証します。npm が成功を報告してもそのエイリアスが欠落している場合、OpenClaw は新しいキャッシュで一度だけ再試行し、それでもエイリアスが欠落していればインストールをロールバックします。

openclaw.compat.pluginApi は、バンドルされていない Plugin ソースのパッケージインストール時に適用されます。パッケージのビルド対象となった OpenClaw Plugin SDK／ランタイム API の下限として使用してください。Plugin パッケージがより新しい API を必要としつつ、ほかのフロー向けに低いインストールヒントを維持する場合は、minHostVersion より厳しくできます。公式 OpenClaw リリースの同期では、既存の公式 Plugin API 下限はデフォルトで OpenClaw のリリースバージョンまで引き上げられますが、パッケージが古いホストを意図的にサポートする場合、Plugin 単独のリリースでは低い下限を維持できます。パッケージバージョンだけを互換性契約として使用しないでください。peerDependencies.openclaw は引き続き npm パッケージメタデータです。OpenClaw はインストール互換性の判断に openclaw.compat.pluginApi 契約を使用します。

公式のオンデマンドインストールメタデータでは、Plugin が ClawHub で公開されている場合に clawhubSpec を使用してください。オンボーディングはこれを優先リモートソースとして扱い、インストール後に ClawHub の成果物情報を記録します。npmSpec は、まだ ClawHub へ移行していないパッケージ向けの互換性フォールバックとして残ります。

npm の正確なバージョン固定は、たとえば "npmSpec": "@wecom/wecom-openclaw-plugin@1.2.3" のように、すでに npmSpec に存在します。公式外部カタログのエントリでは、取得した npm 成果物が固定済みリリースと一致しなくなった場合に更新フローが安全側で失敗するよう、正確な仕様を expectedIntegrity と組み合わせる必要があります。対話型オンボーディングでは、互換性のため、修飾なしのパッケージ名や dist-tag を含む、信頼済みレジストリの npm 仕様を引き続き提示します。カタログ診断では、正確、可変、整合性固定済み、整合性欠落、パッケージ名不一致、無効なデフォルト選択の各ソースを区別できます。また、expectedIntegrity が存在していても、それを固定できる有効な npm ソースがない場合は警告します。expectedIntegrity が存在する場合、インストール／更新フローはそれを適用します。省略されている場合、レジストリ解決結果は整合性固定なしで記録されます。

状態、チャネル一覧、または SecretRef のスキャンで、ランタイム全体を読み込まずに設定済みアカウントを識別する必要がある場合、チャネル Plugin は openclaw.setupEntry を提供する必要があります。セットアップエントリは、チャネルメタデータに加え、セットアップで安全に使用できる設定、状態、シークレットのアダプターを公開する必要があります。ネットワーククライアント、Gateway リスナー、トランスポートランタイムはメインの拡張エントリポイントに置いてください。

ランタイムエントリポイントのフィールドは、ソースエントリポイントのフィールドに対するパッケージ境界チェックを上書きしません。たとえば、openclaw.runtimeExtensions によって、境界外へ抜ける openclaw.extensions パスを読み込み可能にすることはできません。

openclaw.install.allowInvalidConfigRecovery は意図的に限定されています。任意の壊れた設定をインストール可能にするものではありません。現在は、バンドル Plugin のパス欠落や、同じバンドル Plugin に対する古い channels.<id> エントリなど、特定の古いバンドル Plugin 更新失敗からインストールフローを復旧できるようにするだけです。無関係な設定エラーは引き続きインストールをブロックし、運用者に openclaw doctor --fix の実行を促します。

openclaw.channel.persistedAuthState は、小規模なチェッカーモジュール向けのパッケージメタデータです。

{  "openclaw": {    "channel": {      "id": "whatsapp",      "persistedAuthState": {        "specifier": "./auth-presence",        "exportName": "hasAnyWhatsAppAuth"      }    }  }}

セットアップ、Doctor、状態確認、または読み取り専用の存在確認フローで、チャネル Plugin 全体の読み込み前に低コストな認証の有無を調べる必要がある場合に使用してください。永続化された認証状態は、設定済みチャネル状態ではありません。このメタデータを Plugin の自動有効化、ランタイム依存関係の修復、またはチャネルランタイムを読み込むべきかどうかの判断に使用しないでください。対象のエクスポートは、永続化された状態のみを読み取る小さな関数にしてください。チャネルランタイム全体のバレルを経由させないでください。

openclaw.channel.configuredState は、低コストな環境変数のみの設定済みチェックに対して同じ形式を使用します。

{  "openclaw": {    "channel": {      "id": "telegram",      "configuredState": {        "specifier": "./configured-state",        "exportName": "hasTelegramConfiguredState"      }    }  }}

環境変数またはほかの小規模な非ランタイム入力から、チャネルが設定済み状態を判断できる場合に使用してください。チェックに設定全体の解決または実際のチャネルランタイムが必要な場合は、そのロジックを代わりに Plugin の config.hasConfiguredState フックへ置いてください。

検出の優先順位（Plugin ID の重複）

OpenClaw は、OpenClaw に同梱されたバンドル Plugin、グローバルインストールルート（~/.openclaw/extensions）、現在のワークスペースルート（<workspace>/.openclaw/extensions）という3つのルートと、明示的な plugins.load.paths エントリから Plugin を検出します。3つのルートはこの順序で確認されます。

2つの検出結果が同じ id を共有する場合、最も優先順位の高いマニフェストだけが保持されます。優先順位の低い重複は並行して読み込まれず、破棄されます。優先順位は高い順に次のとおりです。

1. 設定で選択済み — plugins.entries.<id> で明示的に固定されたパス
2. 追跡済みインストール記録と一致するグローバルインストール — openclaw plugin install／openclaw plugin update でインストールされ、OpenClaw のインストール追跡が同じ ID に対して認識している Plugin。ID がバンドル Plugin にも属する場合を含みます
3. バンドル済み — OpenClaw に同梱された Plugin
4. ワークスペース — 現在のワークスペースを基準に検出された Plugin
5. その他の検出候補

影響：

• ワークスペースまたはグローバルルートに追跡されずに置かれた、バンドル Plugin のフォークまたは古いコピーは、バンドルされたビルドを隠しません。
• バンドル Plugin を上書きするには、その ID に対して openclaw plugin install を実行し、追跡済みグローバルインストールの優先順位をバンドルコピーより高くするか、plugins.entries.<id> で特定のパスを固定し、設定で選択済みの優先順位によって勝たせます。
• 重複の破棄はログに記録されるため、Doctor および起動診断で破棄されたコピーを示せます。
• 設定で選択された重複上書きは、診断では明示的な上書きとして表現されますが、古いフォークや意図しない隠蔽を可視化したままにするため、引き続き警告されます。

JSON Schema の要件

• すべてのPluginはJSON Schemaを同梱する必要があります。設定を受け付けない場合も同様です。
• 空のスキーマも使用できます（例: { "type": "object", "additionalProperties": false }）。
• スキーマは実行時ではなく、設定の読み書き時に検証されます。
• 新しい設定キーを追加して同梱Pluginを拡張またはフォークする場合は、そのPluginのopenclaw.plugin.jsonにあるconfigSchemaも同時に更新してください。同梱Pluginのスキーマは厳格なため、configSchema.propertiesにmyNewKeyを追加せずにユーザー設定へplugins.entries.<id>.config.myNewKeyを追加すると、Pluginランタイムが読み込まれる前に拒否されます。

スキーマ拡張の例:

{  "configSchema": {    "type": "object",    "additionalProperties": false,    "properties": {      "myNewKey": {        "type": "string"      }    }  }}

検証の動作

• 不明なchannels.*キーは、そのチャンネルIDがPluginマニフェストで宣言されていない限り、エラーです。同じIDがplugins.allow、plugins.entries、またはplugins.installsにも存在する場合（参照されているものの、現在は検出できないPlugin）、OpenClawは代わりにこれを警告へ格下げします。
• 不明なPlugin IDを参照するplugins.entries.<id>、plugins.allow、およびplugins.denyはエラーではなく、警告（「古い設定エントリは無視されました」）になります。そのため、アップグレードやPluginの削除・名前変更によってGatewayの起動が妨げられることはありません。
• 不明なPlugin IDを参照するplugins.slots.memoryはエラーです。ただし、既知の公式外部Pluginであるmemory-lancedbについては、代わりに警告になります。
• Pluginがインストールされていても、マニフェストまたはスキーマが壊れているか存在しない場合、検証は失敗し、DoctorがPluginエラーを報告します。
• Pluginの設定が存在していてもPluginが無効になっている場合、設定は保持され、Doctorとログに警告が表示されます。

plugins.*スキーマの全内容については、設定リファレンスを参照してください。

注記

• ローカルファイルシステムから読み込む場合を含め、ネイティブOpenClaw Pluginにはマニフェストが必須です。ランタイムは引き続きPluginモジュールを別途読み込みます。マニフェストは検出と検証にのみ使用されます。
• ネイティブマニフェストはJSON5で解析されるため、最終的な値がオブジェクトである限り、コメント、末尾のカンマ、および引用符なしのキーを使用できます。
• マニフェストローダーが読み取るのは、文書化されたマニフェストフィールドのみです。独自のトップレベルキーは使用しないでください。
• Pluginで必要としない場合は、channels、providers、cliBackends、およびskillsをすべて省略できます。
• providerCatalogEntryは軽量に保ち、広範なランタイムコードをインポートしないようにしてください。リクエスト時の実行ではなく、静的なプロバイダーカタログメタデータまたは限定的な検出記述子に使用します。
• 排他的なPlugin種別はplugins.slots.*を通じて選択されます。kind: "memory"はplugins.slots.memory（デフォルトはmemory-core）、kind: "context-engine"はplugins.slots.contextEngine（デフォルトはlegacy）を使用します。
• 排他的なPlugin種別はこのマニフェストで宣言してください。ランタイムエントリのOpenClawPluginDefinition.kindは非推奨で、古いPlugin向けの互換性フォールバックとしてのみ残されています。
• 環境変数メタデータ（setup.providers[].envVars、非推奨のproviderAuthEnvVars、およびchannelEnvVars）は宣言専用です。ステータス、監査、Cron配信の検証、およびその他の読み取り専用サーフェスでは、環境変数を設定済みとして扱う前に、引き続きPluginの信頼性と実効的な有効化ポリシーが適用されます。
• プロバイダーコードを必要とするランタイムのウィザードメタデータについては、プロバイダーランタイムフックを参照してください。
• Pluginがネイティブモジュールに依存している場合は、ビルド手順とパッケージマネージャーの許可リスト要件（例: pnpmのallow-build-scriptsとpnpm rebuild <package>）を文書化してください。

関連項目