Plugin yükleme geçersiz kılmaları, bakım sorumlularının kurulum sırasındaki Plugin yüklemelerini katalog, paketle birlikte gelen veya varsayılan npm kaynağı yerine belirli bir npm paketine ya da yerel bir npm-pack tarball arşivine yönlendirmesine olanak tanır. Bunlar yalnızca E2E ve paket doğrulaması için mevcuttur; normal kullanıcılar Plugin’leri
openclaw plugins install ile yükler.
Geçersiz kılmalar, sağladığınız kaynaktaki Plugin kodunu çalıştırır. Bunları yalnızca yalıtılmış bir durum dizininde veya tek kullanımlık bir test makinesinde kullanın.
Ortam
Her iki değişken de ayarlanmadıkça geçersiz kılmalar devre dışıdır:
Geçersiz kılma eşlemesi, anahtar olarak Plugin kimliklerini kullanan JSON biçimindedir. Değerler şunları destekler:
Davranış
Kurulum sırasındaki bir akış, 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 katılım ve paylaşılan kurulum sırası Plugin yükleyicisini kullanan diğer tüm akışlar için geçerlidir.
- Geçersiz kılmalar beklenen Plugin kimliğini yine de zorunlu tutar:
codex ile eşlenen bir tarball arşivi, manifest kimliği codex olan bir Plugin yüklemelidir.
- Geçersiz kılmalar, resmî 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ı yükleme geçersiz kılmalarını etkinleştiremez; her iki ortam değişkeni de engellenen çalışma alanı 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:
Yüklenen paketi durum dizini altında doğrulayın:
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. 