Plugin のインストール上書き

Plugin インストールのオーバーライドにより、メンテナーはセットアップ時の Plugin インストールで、カタログ、バンドル済み、またはデフォルトの npm ソースの代わりに、特定の npm パッケージまたはローカルの npm-pack tarball を指定できます。これは E2E とパッケージ検証専用です。通常のユーザーは openclaw plugins install を使用して Plugin をインストールします。

環境

次の両方の変数が設定されていない限り、オーバーライドは無効です。

export OPENCLAW_ALLOW_PLUGIN_INSTALL_OVERRIDES=1export OPENCLAW_PLUGIN_INSTALL_OVERRIDES='{  "codex": "npm-pack:/tmp/openclaw-codex-2026.5.8.tgz",  "openclaw-web-search": "npm:@openclaw/web-search@2026.5.8"}'

オーバーライドマップは、Plugin ID をキーとする JSON です。値では次の形式を使用できます。

動作

セットアップ時のフローが、マップに ID が含まれる Plugin をインストールする場合、OpenClaw はカタログ、バンドル済み、またはデフォルトの npm ソースの代わりにオーバーライドソースを使用します。これは、オンボーディング、および共有のセットアップ時 Plugin インストーラーを使用するその他すべてのフローに適用されます。

• オーバーライドでも、想定される Plugin ID は引き続き強制されます。codex にマッピングされた tarball は、マニフェスト ID が codex の Plugin をインストールする必要があります。
• オーバーライドは、公式の信頼済みソースとしての状態を継承しません。通常はカタログエントリが OpenClaw 所有のパッケージを表す場合でも、オーバーライドは運用者が提供したテスト入力として扱われます。
• ワークスペースの .env ファイルでは、インストールのオーバーライドを有効にできません。両方の環境変数は、ブロック対象のワークスペース dotenv リストに含まれています。OpenClaw を起動する信頼済みシェル、CI ジョブ、またはリモートテストコマンドで設定してください。

パッケージ E2E

パッケージのインストールとインストール記録が通常の OpenClaw の状態に影響しないよう、隔離された状態ディレクトリを使用してください。

npm pack extensions/codex --pack-destination /tmp OPENCLAW_STATE_DIR="$(mktemp -d)" \OPENCLAW_ALLOW_PLUGIN_INSTALL_OVERRIDES=1 \OPENCLAW_PLUGIN_INSTALL_OVERRIDES='{"codex":"npm-pack:/tmp/openclaw-codex-2026.5.8.tgz"}' \pnpm openclaw onboard --mode local

状態ディレクトリ内にインストールされたパッケージを確認します。

find "$OPENCLAW_STATE_DIR/npm/projects" -path '*/node_modules/@openclaw/codex/package.json' -printgrep -R '"@openclaw/codex"' "$OPENCLAW_STATE_DIR/npm/projects"/*/package-lock.json

実際のプロバイダーを使用する E2E では、テストコマンドを起動する前に、信頼済みシェルまたは CI シークレットから実際の API キーを読み込んでください。キーを出力せず、取得元とキーが存在したかどうかだけを報告してください。