Plugin インストールオーバーライドを使うと、メンテナーはセットアップ時の Plugin インストールで、カタログ、バンドル済み、またはデフォルトの npm ソースではなく、
特定の npm パッケージまたはローカルの npm-pack tarball を指定できます。これは E2E とパッケージ検証
専用です。通常のユーザーは
openclaw plugins install で Plugin をインストールします。
オーバーライドは、指定したソースから 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"
}'
| プレフィックス | ソース |
|---|
npm:<registry-spec> | レジストリパッケージ、厳密なバージョン、またはタグ |
npm-pack:<path.tgz> | npm pack で生成されたローカル tarball。相対パスは現在の作業ディレクトリから解決されます |
- オーバーライドでも、想定される Plugin id は引き続き強制されます。
codex にマップされた tarball は、
manifest id が codex の Plugin をインストールする必要があります。
- オーバーライドは、公式の信頼済みソースの状態を継承しません。通常は
カタログエントリが OpenClaw 所有パッケージを表す場合でも、オーバーライドは
オペレーター指定のテスト入力として扱われます。
- ワークスペースの
.env ファイルではインストールオーバーライドを有効化できません。両方の env vars は
ブロックされたワークスペース 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' -print
grep -R '"@openclaw/codex"' "$OPENCLAW_STATE_DIR/npm/projects"/*/package-lock.json
