> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Plugin kurulum geçersiz kılmaları

Plugin kurulum geçersiz kılmaları, bakımcıların kurulum zamanındaki Plugin kurulumlarını
belirli bir npm paketi veya yerel npm-pack tarball dosyasına karşı test etmesini sağlar. Bunlar yalnızca E2E ve paket
doğrulaması içindir. Normal kullanıcılar Plugin kurulumlarını
[`openclaw plugins install`](/tr/cli/plugins) ile yapmalıdır.

<Warning>
  Geçersiz kılmalar, sağladığınız kaynaktan Plugin kodu çalıştırır. Bunları yalnızca
  yalıtılmış bir durum dizininde veya tek kullanımlık bir test makinesinde kullanın.
</Warning>

## Ortam

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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"
}'
```

Geçersiz kılma eşlemesi, Plugin kimliğine göre anahtarlanan JSON'dur. Değerler şunları destekler:

* Kayıt paketleri ve kesin sürümler veya etiketler için `npm:<registry-spec>`
* `npm pack` tarafından üretilen yerel tarball dosyaları için `npm-pack:<path.tgz>`

Göreli `npm-pack:` yolları geçerli çalışma dizininden çözümlenir.

## Davranış

Kurulum zamanı akışı, kimliği eşlemede görünen bir Plugin kurmayı istediğinde,
OpenClaw katalog, paketle gelen veya varsayılan npm kaynağı yerine geçersiz kılma
kaynağını kullanır. Bu, ortak kurulum zamanı Plugin yükleyicisini kullanan
ilk kurulum ve diğer akışlar için geçerlidir.

Geçersiz kılmalar yine de beklenen Plugin kimliğini zorunlu tutar. `codex` ile eşlenen
bir tarball, manifest kimliği `codex` olan bir Plugin kurmalıdır.

Geçersiz kılmalar resmi güvenilir kaynak durumunu 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. Bu değişkenleri
OpenClaw'ı başlatan güvenilir kabukta, CI işinde veya uzaktan test komutunda ayarlayın.

## Paket E2E

Paket kurulumlarının ve kurulum kayıtlarının normal OpenClaw durumunuza dokunmaması için
yalıtılmış bir durum dizini kullanın:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```

Kurulan paketi durum dizini altında doğrulayın:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```

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