Pluginleri yönet

Çoğu Plugin iş akışı birkaç komuttan oluşur: arama, yükleme, Gateway'i yeniden başlatma, doğrulama ve Plugin'e artık ihtiyacınız kalmadığında kaldırma.

# Plugin'leri listeleme

openclaw plugins list
openclaw plugins list --enabled
openclaw plugins list --verbose
openclaw plugins list --json

Betikler için --json kullanın. Plugin paketi dependencies veya optionalDependencies bildirdiğinde kayıt defteri tanılamalarını ve her Plugin'in statik dependencyStatus bilgisini içerir.

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

plugins list soğuk bir envanter kontrolüdür. OpenClaw'ın yapılandırmadan, manifestlerden ve Plugin kayıt defterinden ne keşfedebildiğini gösterir; halihazırda çalışan bir Gateway sürecinin Plugin çalışma zamanını içe aktardığını kanıtlamaz.

# Plugin'leri yükleme

# Plugin paketleri için ClawHub'da arama yapın.
openclaw plugins search "calendar"

# Yalın paket belirtimleri önce ClawHub'ı, sonra npm yedeğini dener.
openclaw plugins install <package>

# Tek bir kaynağı zorunlu kılın.
openclaw plugins install clawhub:<package>
openclaw plugins install npm:<package>

# Belirli bir sürümü veya dist-tag'i yükleyin.
openclaw plugins install clawhub:<package>@1.2.3
openclaw plugins install clawhub:<package>@beta
openclaw plugins install npm:@scope/[email protected]
openclaw plugins install npm:@openclaw/codex

# Git'ten veya yerel bir geliştirme çalışma kopyasından yükleyin.
openclaw plugins install git:github.com/acme/[email protected]
openclaw plugins install ./my-plugin
openclaw plugins install --link ./my-plugin

Plugin kodunu yükledikten sonra kanallarınızı sunan Gateway'i yeniden başlatın:

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

Plugin'in araçlar, kancalar, hizmetler, Gateway yöntemleri veya Plugin'e ait CLI komutları gibi çalışma zamanı yüzeylerini kaydettiğine dair kanıta ihtiyacınız olduğunda inspect --runtime kullanın.

# Plugin'leri güncelleme

openclaw plugins update <plugin-id>
openclaw plugins update <npm-package-or-spec>
openclaw plugins update --all

Bir Plugin @beta gibi bir npm dist-tag'inden yüklendiyse, sonraki update <plugin-id> çağrıları kaydedilen bu etiketi yeniden kullanır. Açık bir npm belirtimi geçirmek, izlenen yüklemeyi gelecekteki güncellemeler için bu belirtime geçirir.

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

İkinci komut, daha önce kesin 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, varsayılan hat npm ve ClawHub Plugin kayıtları önce eşleşen Plugin @beta yayınını dener. Bu beta yayını yoksa OpenClaw kaydedilmiş varsayılan/en son belirtime geri döner. npm Plugin'leri için OpenClaw, beta paketi mevcut olsa ancak yükleme doğrulamasında başarısız olsa da geri döner. Kesin sürümler ve @rc veya @beta gibi açık etiketler korunur.

# Plugin'leri kaldırma

openclaw plugins uninstall <plugin-id> --dry-run
openclaw plugins uninstall <plugin-id>
openclaw plugins uninstall <plugin-id> --keep-files
openclaw gateway restart

Kaldırma işlemi, geçerli olduğunda Plugin'in yapılandırma girdisini, Plugin dizin kaydını, izin/verme listesi girdilerini ve bağlı yükleme yollarını kaldırır. Yönetilen yükleme dizinleri, --keep-files geçmediğiniz sürece kaldırılır.

Nix modunda (OPENCLAW_NIX_MODE=1), Plugin yükleme, güncelleme, kaldırma, etkinleştirme ve devre dışı bırakma komutları devre dışıdır. Bunun yerine bu seçimleri yüklemenin Nix kaynağında yönetin; nix-openclaw için ajan öncelikli Hızlı Başlangıç bölümünü kullanın.

# Plugin'leri yayımlama

Harici Plugin'leri ClawHub, npmjs.com veya her ikisine yayımlayabilirsiniz.

# ClawHub'a yayımlama

ClawHub, OpenClaw Plugin'leri için birincil herkese açık keşif yüzeyidir. Kullanıcılara yüklemeden önce aranabilir meta veriler, sürüm geçmişi ve kayıt defteri tarama sonuçları sağlar.

npm i -g clawhub
clawhub login
clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
clawhub package publish your-org/[email protected]

Kullanıcılar ClawHub'dan şu şekilde yükler:

openclaw plugins install clawhub:<package>
openclaw plugins install <package>

Yalın biçim yine de önce ClawHub'ı kontrol eder.

# npmjs.com'a yayımlama

Yerel npm Plugin'leri bir Plugin manifesti ve package.json OpenClaw giriş noktası meta verileri içermelidir.

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

npm publish --access public

Kullanıcılar yalnızca npm'den şu şekilde yükler:

openclaw plugins install npm:@acme/openclaw-plugin
openclaw plugins install npm:@acme/openclaw-plugin@beta
openclaw plugins install npm:@acme/[email protected]

Aynı paket ClawHub'da da mevcutsa, npm: ClawHub aramasını atlar ve npm çözümlemesini zorunlu kılar.

# Kaynak seçimi

• ClawHub: OpenClaw'a özgü keşif, tarama özetleri, sürümler ve yükleme ipuçları istediğinizde kullanın.
• npmjs.com: Zaten JavaScript paketleri yayımlıyorsanız veya npm dist-tag/özel kayıt defteri iş akışlarına ihtiyacınız varsa kullanın.
• Git: Doğrudan bir branch, etiket veya commit'ten yüklemek istediğinizde kullanın.
• Yerel yol: Aynı makinede bir Plugin geliştirirken veya test ederken kullanın.

# İlgili

• Plugin'ler - genel bakış ve sorun giderme
• openclaw plugins - tam CLI başvurusu
• ClawHub - yayımlama ve kayıt defteri işlemleri
• Plugin oluşturma - bir Plugin paketi oluşturma
• Plugin manifesti - manifest ve paket meta verileri