Pluginleri yönet

Bu sayfayı yaygın Plugin yönetimi komutları için kullanın. Kapsamlı komut sözleşmesi, bayraklar, kaynak seçimi kuralları ve uç durumlar için bkz. openclaw plugins.

Çoğu kurulum iş akışı şöyledir:

1. bir paket bulun
2. paketi ClawHub, npm, git veya yerel bir yoldan kurun
3. yönetilen Gateway'in otomatik yeniden başlamasına izin verin ya da yönetilmiyorsa elle yeniden başlatın
4. Plugin'in çalışma zamanı kayıtlarını doğrulayın

Pluginleri listeleme ve arama

openclaw plugins listopenclaw plugins list --enabledopenclaw plugins list --verboseopenclaw plugins list --jsonopenclaw plugins search "calendar"

Betikler için --json kullanın:

openclaw plugins list --json \  | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'

plugins list soğuk bir envanter denetimidir. OpenClaw'ın yapılandırma, manifestler ve Plugin kayıt defterinden neleri keşfedebildiğini gösterir; zaten çalışan bir Gateway'in Plugin çalışma zamanını içe aktardığını kanıtlamaz. JSON çıktısı, Plugin paketi dependencies veya optionalDependencies bildirdiğinde kayıt defteri tanılamalarını ve her Plugin'in statik dependencyStatus değerini içerir.

plugins search, kurulabilir Plugin paketleri için ClawHub'ı sorgular ve openclaw plugins install clawhub:<package> gibi kurulum ipuçlarını yazdırır.

Pluginleri kurma

# Search ClawHub for plugin packages.openclaw plugins search "calendar" # Install from ClawHub.openclaw plugins install clawhub:<package>openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@beta # Install from npm.openclaw plugins install npm:<package>openclaw plugins install npm:@scope/openclaw-plugin@1.2.3openclaw plugins install npm:@openclaw/codex # Install from a local npm pack artifact.openclaw plugins install npm-pack:<path.tgz> # Install from git or a local development checkout.openclaw plugins install git:github.com/acme/openclaw-plugin@v1.0.0openclaw plugins install ./my-pluginopenclaw plugins install --link ./my-plugin

Çıplak paket belirtimleri, lansman geçişi sırasında npm'den kurulur. Belirleyici kaynak seçimi gerektiğinde clawhub:, npm:, git: veya npm-pack: kullanın. Çıplak ad resmi bir Plugin kimliğiyle eşleşirse OpenClaw katalog girdisini doğrudan kurabilir.

--force seçeneğini yalnızca mevcut bir kurulum hedefinin üzerine yazmayı bilinçli olarak istediğinizde kullanın. İzlenen npm, ClawHub veya hook-pack kurulumlarının rutin yükseltmeleri için openclaw plugins update kullanın.

Yeniden başlatma ve inceleme

Plugin kodunu kurduktan, güncelledikten veya kaldırdıktan sonra, yapılandırma yeniden yüklemesi etkin olan çalışan yönetilen Gateway otomatik olarak yeniden başlar. Gateway yönetilmiyorsa veya yeniden yükleme devre dışıysa, canlı çalışma zamanı yüzeylerini denetlemeden önce kendiniz yeniden başlatın:

openclaw gateway restartopenclaw plugins inspect <plugin-id> --runtime --json

Plugin'in araçlar, hook'lar, servisler, Gateway yöntemleri, HTTP rotaları veya Plugin'e ait CLI komutları gibi çalışma zamanı yüzeylerini kaydettiğine dair kanıt gerektiğinde inspect --runtime kullanın. Düz inspect ve list, soğuk manifest, yapılandırma ve kayıt defteri denetimleridir.

Pluginleri güncelleme

openclaw plugins update <plugin-id>openclaw plugins update <npm-package-or-spec>openclaw plugins update --allopenclaw plugins update <plugin-id> --dry-run

Bir Plugin kimliği verdiğinizde OpenClaw izlenen kurulum belirtimini yeniden kullanır. @beta gibi saklanan dist-tag'ler ve tam sabitlenmiş sürümler, sonraki update <plugin-id> çalıştırmalarında kullanılmaya devam eder.

openclaw plugins update --all toplu bakım yoludur. Sıradan izlenen kurulum belirtimlerine yine saygı duyar, ancak güvenilir resmi OpenClaw Plugin kayıtları eski bir tam resmi pakette kalmak yerine geçerli resmi katalog hedefine eşitlenebilir. update.channel değeri beta olarak ayarlanmışsa bu toplu resmi eşitleme beta kanal bağlamını kullanır. Tam veya etiketli bir resmi belirtimi bilinçli olarak değiştirmeden tutmak istediğinizde hedefli update <plugin-id> kullanın.

npm kurulumları için izlenen kaydı değiştirmek üzere açık bir paket belirtimi verebilirsiniz:

openclaw plugins update @scope/openclaw-plugin@betaopenclaw plugins update @scope/openclaw-plugin

İkinci komut, daha önce tam bir sürüme veya etikete sabitlenmiş bir Plugin'i kayıt defterinin varsayılan yayın hattına geri taşır.

openclaw update beta kanalında çalıştığında, Plugin kayıtları eşleşen @beta yayınlarını tercih edebilir. Tam geri dönüş ve sabitleme kuralları için bkz. openclaw plugins.

Pluginleri kaldırma

openclaw plugins uninstall <plugin-id> --dry-runopenclaw plugins uninstall <plugin-id>openclaw plugins uninstall <plugin-id> --keep-files

Kaldırma işlemi, Plugin'in yapılandırma girdisini, kalıcı Plugin dizin kaydını, izin/ret listesi girdilerini ve uygulanabiliyorsa bağlı yükleme yollarını kaldırır. --keep-files vermediğiniz sürece yönetilen kurulum dizinleri kaldırılır. Kaldırma işlemi Plugin kaynağını değiştirdiğinde çalışan yönetilen Gateway otomatik olarak yeniden başlar.

Nix modunda (OPENCLAW_NIX_MODE=1), Plugin kurma, güncelleme, kaldırma, etkinleştirme ve devre dışı bırakma komutları devre dışıdır. Bunun yerine bu seçimleri kurulumun Nix kaynağında yönetin.

Kaynak seçme

Yönetilen yerel yol kurulumları Plugin dizinleri veya arşivler olmalıdır. Bağımsız Plugin dosyalarını plugins install ile kurmak yerine plugins.load.paths içine koyun.

Pluginleri yayımlama

ClawHub, OpenClaw Pluginleri için birincil genel keşif yüzeyidir. Kullanıcıların kurulum yapmadan önce Plugin meta verilerini, sürüm geçmişini, kayıt defteri tarama sonuçlarını ve kurulum ipuçlarını bulmasını istediğinizde burada yayımlayın.

npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/your-plugin@v1.0.0

Yerel npm Pluginleri, yayımlanmadan önce bir Plugin manifesti ve paket meta verileri içermelidir:

{  "name": "@acme/openclaw-plugin",  "version": "1.0.0",  "type": "module",  "openclaw": {    "extensions": ["./dist/index.js"]  }}

npm publish --access publicopenclaw plugins install npm:@acme/openclaw-pluginopenclaw plugins install npm:@acme/openclaw-plugin@betaopenclaw plugins install npm:@acme/openclaw-plugin@1.0.0

Bu sayfayı yayımlama referansı olarak ele almak yerine, tam yayımlama sözleşmesi için şu sayfaları kullanın:

• ClawHub yayımlama, sahipleri, kapsamları, yayınları, incelemeyi, paket doğrulamayı ve paket aktarımını açıklar.
• Plugin oluşturma, Plugin paket şeklini ve ilk yayımlama iş akışını gösterir.
• Plugin manifesti, yerel Plugin manifest alanlarını tanımlar.

Aynı paket hem ClawHub hem de npm üzerinde mevcutsa, tek bir kaynağı zorlamak gerektiğinde açık clawhub: veya npm: önekini kullanın.

İlgili

• Pluginler - kurma, yapılandırma, yeniden başlatma ve sorun giderme
• openclaw plugins - tam CLI referansı
• Topluluk Pluginleri - genel keşif ve ClawHub yayımlama
• ClawHub - kayıt defteri CLI işlemleri
• Plugin oluşturma - bir Plugin paketi oluşturma
• Plugin manifesti - manifest ve paket meta verileri