Plugin kurulum geçersiz kılmaları

Plugin kurulum geçersiz kılmaları, bakımcıların kurulum zamanı Plugin yüklemelerini katalog, paketle birlikte gelen veya varsayılan npm kaynağı yerine belirli bir npm paketine ya da yerel bir npm pack tar arşivine yönlendirmesine olanak tanır. Bunlar yalnızca E2E ve paket doğrulaması için vardır; normal kullanıcılar Plugin'leri openclaw plugins install ile yükler.

Ortam

Her iki değişken de ayarlanmadıkça geçersiz kılmalar devre dışıdır:

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

Geçersiz kılma eşlemesi, Plugin kimliğinin anahtar olarak kullanıldığı JSON biçimindedir. Değerler şunları destekler:

Davranış

Kurulum zamanı akışlarından biri, kimliği eşlemede bulunan bir Plugin'i yüklediğinde OpenClaw; katalog, paketle birlikte gelen veya varsayılan npm kaynağı yerine geçersiz kılma kaynağını kullanır. Bu, ilk kuruluma ve paylaşılan kurulum zamanı Plugin yükleyicisini kullanan diğer tüm akışlara uygulanır.

• Geçersiz kılmalar beklenen Plugin kimliğini uygulamaya devam eder: codex ile eşlenen bir tar arşivi, manifest kimliği codex olan bir Plugin yüklemelidir.
• Geçersiz kılmalar resmî güvenilir kaynak statüsünü devralmaz. Katalog girdisi normalde OpenClaw'a ait bir paketi temsil etse bile geçersiz kılma, operatör tarafından sağlanan test girdisi olarak değerlendirilir.
• Çalışma alanı .env dosyaları kurulum geçersiz kılmalarını etkinleştiremez; her iki ortam değişkeni de çalışma alanında engellenen dotenv listesindedir. Bunları OpenClaw'ı başlatan güvenilir kabukta, CI işinde veya uzak test komutunda ayarlayın.

Paket E2E

Paket yüklemelerinin ve yükleme kayıtlarının normal OpenClaw durumunuza dokunmaması için yalıtılmış bir durum dizini kullanın:

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

Yüklenen paketi durum dizini altında doğrulayın:

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

Canlı sağlayıcı E2E testi için test komutunu başlatmadan önce gerçek API anahtarını güvenilir bir kabuktan veya CI gizli bilgisinden yükleyin. Anahtarları yazdırmayın; yalnızca kaynağı ve anahtarın mevcut olup olmadığını bildirin.