Plugin reference

Plugin インストールのオーバーライド

Plugin インストールオーバーライドにより、メンテナーはセットアップ時の Plugin インストールを特定の npm パッケージまたはローカルの npm pack tarball に対してテストできます。これは E2E とパッケージ検証専用です。通常のユーザーは openclaw plugins install で Plugin をインストールしてください。

環境

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

export OPENCLAW_ALLOW_PLUGIN_INSTALL_OVERRIDES=1
export 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 です。値は以下をサポートします。

npm:<registry-spec>: レジストリパッケージと、正確なバージョンまたはタグ用
npm-pack:<path.tgz>: npm pack で生成されたローカル tarball 用

相対 npm-pack: パスは、現在の作業ディレクトリを基準に解決されます。

動作

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

オーバーライドでも、期待される Plugin ID は引き続き強制されます。codex にマップされた tarball は、マニフェスト ID が codex の Plugin をインストールする必要があります。

オーバーライドは、公式の信頼済みソースステータスを継承しません。カタログエントリが通常 OpenClaw 所有のパッケージを表す場合でも、オーバーライドはオペレーターが提供したテスト入力として扱われます。

ワークスペースの .env ファイルでは、インストールオーバーライドを有効にできません。これらの変数は、 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/node_modules" -maxdepth 3 -name package.json -print
grep -R '"@openclaw/codex"' "$OPENCLAW_STATE_DIR/npm/package-lock.json"

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

# 環境

# 動作

# パッケージ E2E

環境

動作

パッケージ E2E