Penimpaan instalasi Plugin

Penggantian instalasi Plugin memungkinkan pengelola mengarahkan instalasi plugin saat penyiapan ke paket npm tertentu atau tarball lokal hasil npm pack, alih-alih sumber katalog, bawaan, atau npm default. Penggantian ini hanya tersedia untuk E2E dan validasi paket; pengguna biasa menginstal plugin dengan openclaw plugins install.

Lingkungan

Penggantian dinonaktifkan kecuali kedua variabel ditetapkan:

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"}'

Peta penggantian adalah JSON dengan id plugin sebagai kunci. Nilainya mendukung:

Perilaku

Saat alur penyiapan menginstal plugin yang id-nya tercantum dalam peta, OpenClaw menggunakan sumber penggantian alih-alih sumber katalog, bawaan, atau npm default. Ini berlaku untuk orientasi awal dan alur lain yang menggunakan penginstal plugin bersama saat penyiapan.

• Penggantian tetap memberlakukan id plugin yang diharapkan: tarball yang dipetakan ke codex harus menginstal plugin dengan id manifes codex.
• Penggantian tidak mewarisi status sumber tepercaya resmi. Bahkan ketika entri katalog biasanya mewakili paket milik OpenClaw, penggantian diperlakukan sebagai masukan pengujian yang disediakan operator.
• Berkas .env ruang kerja tidak dapat mengaktifkan penggantian instalasi; kedua variabel lingkungan tercantum dalam daftar blokir dotenv ruang kerja. Tetapkan keduanya di shell tepercaya, tugas CI, atau perintah pengujian jarak jauh yang meluncurkan OpenClaw.

E2E Paket

Gunakan direktori status yang terisolasi agar instalasi paket dan catatan instalasi tidak menyentuh status OpenClaw normal Anda:

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

Verifikasi paket yang diinstal di dalam direktori status:

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

Untuk E2E penyedia langsung, muat kunci API sebenarnya dari shell tepercaya atau rahasia CI sebelum menjalankan perintah pengujian. Jangan cetak kunci; laporkan hanya sumbernya dan apakah kunci tersebut tersedia.