Skip to main content
Plugin インストールのオーバーライドを使用すると、メンテナーはセットアップ時の Plugin インストールで、カタログ、バンドル、またはデフォルトの npm ソースではなく、特定の npm パッケージやローカルの npm-pack tarball を指定できます。これは E2E とパッケージ検証専用です。通常のユーザーは openclaw plugins install を使用して Plugin をインストールします。
オーバーライドは、指定したソースの Plugin コードを実行します。隔離された状態ディレクトリまたは使い捨てのテストマシンでのみ使用してください。

​
環境

次の両方の変数が設定されていない場合、オーバーライドは無効です。
オーバーライドマップは、Plugin ID をキーとする JSON です。値では次の形式を使用できます。

​
動作

セットアップ時のフローで、マップに ID が含まれる Plugin をインストールすると、OpenClaw はカタログ、バンドル、またはデフォルトの npm ソースではなく、オーバーライドソースを使用します。これはオンボーディングと、共有のセットアップ時 Plugin インストーラーを使用するその他すべてのフローに適用されます。
  • オーバーライドでも、想定される Plugin ID は引き続き検証されます。codex にマッピングされた tarball は、マニフェスト ID が codex である Plugin をインストールする必要があります。
  • オーバーライドは、公式の信頼済みソースのステータスを継承しません。通常はカタログエントリが OpenClaw 所有のパッケージを表す場合でも、オーバーライドはオペレーターが指定したテスト入力として扱われます。
  • ワークスペースの .env ファイルでは、インストールオーバーライドを有効にできません。両方の環境変数は、ワークスペースの dotenv ブロックリストに含まれています。OpenClaw を起動する信頼済みシェル、CI ジョブ、またはリモートテストコマンドで設定してください。

​
パッケージ E2E

パッケージのインストールとインストール記録が通常の OpenClaw の状態に影響しないように、隔離された状態ディレクトリを使用してください。
状態ディレクトリ内にインストールされたパッケージを確認します。
ライブプロバイダーの E2E では、テストコマンドを起動する前に、信頼済みシェルまたは CI シークレットから実際の API キーを読み込んでください。キーは出力せず、ソースとキーが存在したかどうかのみを報告してください。