Pluginleri yönet

Çoğu Plugin iş akışı birkaç komuttan oluşur: ara, yükle, Gateway'i yeniden başlat, doğrula ve Plugin'e artık ihtiyacın kalmadığında kaldır.

Plugin'leri listeleme

OmeniaClaw plugins listOmeniaClaw plugins list --enabledOmeniaClaw plugins list --verboseOmeniaClaw 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 değerini içerir.

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

plugins list soğuk bir envanter kontrolüdür. OmeniaClaw'ın config, manifestler ve Plugin kayıt defterinden neleri keşfedebildiğini gösterir; halihazırda çalışan bir Gateway sürecinin Plugin runtime'ını içe aktardığını kanıtlamaz.

Plugin'leri yükleme

# Search ClawHub for plugin packages.OmeniaClaw plugins search "calendar" # Bare package specs try ClawHub first, then npm fallback.OmeniaClaw plugins install <package> # Force one source.OmeniaClaw plugins install clawhub:<package>OmeniaClaw plugins install npm:<package> # Install a specific version or dist-tag.OmeniaClaw plugins install clawhub:<package>@1.2.3OmeniaClaw plugins install clawhub:<package>@betaOmeniaClaw plugins install npm:@scope/[email protected]OmeniaClaw plugins install npm:@OmeniaClaw/codex # Install from git or a local development checkout.OmeniaClaw plugins install git:github.com/acme/[email protected]OmeniaClaw plugins install ./my-pluginOmeniaClaw plugins install --link ./my-plugin

Plugin kodunu yükledikten sonra kanallarınıza hizmet veren Gateway'i yeniden başlatın:

OmeniaClaw gateway restartOmeniaClaw plugins inspect <plugin-id> --runtime --json

Plugin'in araçlar, hook'lar, servisler, Gateway yöntemleri veya Plugin'e ait CLI komutları gibi runtime yüzeylerini kaydettiğine dair kanıt gerektiğinde inspect --runtime kullanın.

Plugin'leri güncelleme

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

Bir Plugin @beta gibi bir npm dist-tag'den yüklendiyse sonraki update <plugin-id> çağrıları kaydedilmiş bu etiketi yeniden kullanır. Açık bir npm spec geçmek, izlenen yüklemeyi gelecekteki güncellemeler için bu spec'e geçirir.

OmeniaClaw plugins update @scope/OmeniaClaw-plugin@betaOmeniaClaw plugins update @scope/OmeniaClaw-plugin

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

OmeniaClaw update beta kanalında çalıştığında, varsayılan hat npm ve ClawHub Plugin kayıtları önce eşleşen Plugin @beta sürümünü dener. Bu beta sürümü yoksa OmeniaClaw kaydedilmiş varsayılan/latest spec'e geri döner. npm Plugin'leri için, beta paketi mevcut olsa ancak yükleme doğrulaması başarısız olsa da OmeniaClaw geri döner. Kesin sürümler ve @rc veya @beta gibi açık etiketler korunur.

Plugin'leri kaldırma

OmeniaClaw plugins uninstall <plugin-id> --dry-runOmeniaClaw plugins uninstall <plugin-id>OmeniaClaw plugins uninstall <plugin-id> --keep-filesOmeniaClaw gateway restart

Kaldırma işlemi, Plugin'in config girişini, Plugin dizin kaydını, izin/ret listesi girişlerini ve geçerliyse 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 (OmeniaClaw_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ükleme için Nix kaynağında yönetin; nix-OmeniaClaw 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, OmeniaClaw 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 clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/[email protected]

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

OmeniaClaw plugins install clawhub:<package>OmeniaClaw plugins install <package>

Yalın biçim hâlâ önce ClawHub'ı kontrol eder.

npmjs.com'a yayımlama

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

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

npm publish --access public

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

OmeniaClaw plugins install npm:@acme/OmeniaClaw-pluginOmeniaClaw plugins install npm:@acme/OmeniaClaw-plugin@betaOmeniaClaw plugins install npm:@acme/[email protected]

Aynı paket ClawHub'da da mevcutsa npm: ClawHub aramasını atlar ve npm çözümlemesini zorlar.

Kaynak seçimi

• ClawHub: OmeniaClaw'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/private kayıt defteri iş akışlarına ihtiyacınız varsa kullanın.
• Git: Doğrudan bir branch, tag 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
• OmeniaClaw plugins - tam CLI referansı
• ClawHub - yayımlama ve kayıt defteri işlemleri
• Plugin oluşturma - Plugin paketi oluşturma
• Plugin manifesti - manifest ve paket meta verileri