Pluginleri yönet

Control UI, yaygın keşfetme, yükleme, etkinleştirme ve devre dışı bırakma iş akışını kapsar. CLI; güncelleme, kaldırma, gelişmiş yapılandırma ve açık yükleme kaynağı denetimleri ekler. Komut sözleşmesinin, bayrakların, kaynak seçimi kurallarının ve uç durumların tamamı için openclaw plugins bölümüne bakın.

Tipik CLI iş akışı: Bir paket bulun, ClawHub, npm, git veya yerel bir yoldan yükleyin, yönetilen Gateway'in otomatik olarak yeniden başlatılmasını bekleyin (ya da elle yeniden başlatın), ardından Plugin'in çalışma zamanı kayıtlarını doğrulayın.

Control UI'ı kullanma

Control UI'da Pluginler bölümünü açın veya yapılandırılmış Control UI temel yoluna göre /settings/plugins yolunu kullanın. Örneğin, /openclaw temel yolu /openclaw/settings/plugins yolunu kullanır. Sayfada iki sekme vardır:

• Yüklü sekmesi, kategoriye göre gruplandırılmış tam yerel envanteri gösterir (kanallar, model sağlayıcıları, bellek, araçlar). Her satır bir ayrıntı görünümü açar; taşma (…) menüsü Plugin'i etkinleştirir veya devre dışı bırakır ve harici olarak yüklenen Pluginler için Kaldır seçeneğini sunar. Sekme ayrıca yapılandırılmış MCP sunucularını, Gateway yapılandırmasındaki mcp.servers öğesini düzenleyen aynı menü tabanlı etkinleştirme, devre dışı bırakma ve kaldırma eylemleriyle listeler.
• Keşfet sekmesi mağazadır: OpenClaw ile birlikte gelen öne çıkan Pluginler, resmî harici Pluginler ve seçilmiş bir bağlayıcı koleksiyonu. Bağlayıcı kartları tek tıklamayla barındırılan bir MCP sunucusu ekler (GitHub, Notion, Linear, Sentry, Home Assistant) veya önceden doldurulmuş bir ClawHub aramasına yönlendirir. Arama kutusuna yazıldığında ClawHub satır içinde sorgulanır ve indirme sayılarıyla kaynak doğrulama rozetlerini içeren bir ClawHub'dan bölümü eklenir.

Dâhil edilen Pluginler için paket yüklemeye gerek yoktur. Menü eylemleri Etkinleştir veya Devre Dışı Bırak şeklindedir. Örneğin Workboard, OpenClaw ile birlikte gelir ve varsayılan olarak devre dışıdır; açmak için Etkinleştir seçeneğini belirleyin. Birlikte gelen Pluginler kaldırılamaz, yalnızca devre dışı bırakılabilir.

Katalog ve arama erişimi operator.read gerektirir. Yükleme, etkinleştirme, devre dışı bırakma, kaldırma ve MCP sunucusu değişiklikleri operator.admin gerektirir. ClawHub yüklemesi Gateway tarafından gerçekleştirilir ve güven, bütünlük ve Plugin yükleme politikası denetimlerini korur. Yüklü bir Plugin'in yönetici olarak etkinleştirilmesi, seçilen Plugin'i mevcut kısıtlayıcı plugins.allow listesine ekleyerek bu açık güveni de kaydeder. Açık bir plugins.deny girdisi belirleyici olmaya devam eder ve Plugin etkinleştirilmeden önce kaldırılmalıdır.

Plugin kodunun yüklenmesi veya kaldırılması Gateway'in yeniden başlatılmasını gerektirir. Yüklü Plugin ve mevcut Gateway çalışma zamanı destekliyorsa etkinleştirme değişiklikleri yeniden başlatma olmadan uygulanabilir; aksi hâlde UI, yeniden başlatmanın gerekli olduğunu bildirir. OAuth destekli MCP bağlayıcıları eklendikten sonra yine de CLI'dan tek seferlik openclaw mcp login <name> gerektirir.

Control UI; rastgele npm, git veya yerel yol kaynaklarından yükleme yapmaz, Pluginleri güncellemez ya da kapsamlı Plugin yapılandırmasını sunmaz. Bu işlemler için aşağıdaki CLI iş akışlarını kullanın.

Pluginleri listeleme ve arama

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

Betikler için --json:

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 kalıcı Plugin kayıt defterinden keşfedebildiği öğeleri gösterir. Hâlihazırda çalışan bir Gateway'in Plugin çalışma zamanını içe aktardığını kanıtlamaz. JSON çıktısı, kayıt defteri tanılamalarını ve her Plugin'in dependencyStatus durumunu (bildirilen dependencies/optionalDependencies öğelerinin diskte çözümlenip çözümlenmediğini) içerir.

plugins search, yüklenebilir Plugin paketleri için ClawHub'ı sorgular ve her sonuç için bir yükleme ipucu (openclaw plugins install clawhub:<package>) yazdırır.

Pluginleri etkinleştirme ve devre dışı bırakma

openclaw plugins enable <plugin-id>openclaw plugins disable <plugin-id>

Yüklü dosyalara dokunmadan bir Plugin'in yapılandırma girdisini değiştirir. Birlikte gelen bazı Pluginler (birlikte gelen model/konuşma sağlayıcıları ve birlikte gelen tarayıcı Plugin'i) varsayılan olarak etkindir; diğerleri yüklemeden sonra enable gerektirir.

Pluginleri yükleme

# Plugin paketleri için ClawHub'da arama yapın.openclaw plugins search "calendar" # ClawHub'dan yükleyin.openclaw plugins install clawhub:<package>openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@beta # npm'den yükleyin.openclaw plugins install npm:<package>openclaw plugins install npm:@scope/[email protected]openclaw plugins install npm:@openclaw/codex # Yerel bir npm-pack yapısından yükleyin.openclaw plugins install npm-pack:<path.tgz> # 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-pluginopenclaw plugins install --link ./my-plugin

Çıplak paket belirtimleri, geçiş başlatılırken npm'den yüklenir; ancak ad, birlikte gelen veya resmî bir Plugin kimliğiyle eşleşirse OpenClaw bunun yerine ilgili yerel/resmî kopyayı kullanır. Belirleyici kaynak seçimi için clawhub:, npm:, git: veya npm-pack: kullanın. OpenClaw'ın birlikte gelen ve resmî katalog paketlerine ClawHub paketleriyle birlikte güvenilir. Rastgele yeni npm, git, yerel yol/arşiv, npm-pack: veya pazar yeri kaynakları, kaynağı inceleyip güvendikten sonra etkileşimsiz yüklemelerde --force gerektirir.

--force, ClawHub dışındaki bir kaynağı istem göstermeden onaylar ve gerektiğinde mevcut yükleme hedefinin üzerine yazar. İzlenen bir npm, ClawHub veya hook-pack yüklemesinin rutin yükseltmeleri için bunun yerine openclaw plugins update kullanın. --link ile --force yalnızca kaynağı onaylar; bağlantılı dizin kopyalanmaz veya üzerine yazılmaz.

Yeniden başlatma ve inceleme

Yapılandırma yeniden yüklemesi etkin olan, çalışır durumdaki yönetilen bir Gateway; Plugin kodu yüklendikten, güncellendikten veya kaldırıldıktan sonra otomatik olarak yeniden başlatılır. 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

inspect --runtime, Plugin modülünü yükler ve çalışma zamanı yüzeylerini (araçlar, kancalar, hizmetler, Gateway yöntemleri, HTTP rotaları, Plugin'e ait CLI komutları) kaydettiğini kanıtlar. Düz inspect ve list yalnızca soğuk manifest/yapılandırma/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 iletildiğinde izlenen yükleme belirtimi yeniden kullanılır: saklanan dist-tag'ler (@beta) ve tam olarak sabitlenmiş sürümler, sonraki update <plugin-id> çalıştırmalarına aktarılır.

openclaw plugins update --all, toplu bakım yoludur. Sıradan izlenen yükleme belirtimlerine yine uyar; ancak güvenilir resmî OpenClaw Plugin kayıtları eski, tam bir resmî pakete sabitlenmek yerine geçerli resmî katalog hedefiyle eşitlenir; update.channel, beta olduğunda bu eşitleme beta sürüm hattını tercih eder. Tam veya etiketli bir resmî belirtimi değiştirmeden korumak için hedefli bir update <plugin-id> kullanın.

npm yüklemelerinde, izlenen kaydı değiştirmek için açık bir paket belirtimi iletin:

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

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

Tam geri dönüş ve sabitleme kuralları için openclaw plugins bölümüne bakın.

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 dizini kaydını, izin/verme listesi girdilerini ve uygun olduğunda bağlantılı plugins.load.paths girdilerini kaldırır. --keep-files iletmediğiniz sürece yönetilen yükleme dizini kaldırılır. Kaldırma işlemi Plugin kaynağını değiştirdiğinde çalışır durumdaki yönetilen Gateway otomatik olarak yeniden başlatılır.

Nix modunda (OPENCLAW_NIX_MODE=1) Plugin yükleme, güncelleme, kaldırma, etkinleştirme ve devre dışı bırakma işlemlerinin tümü devre dışıdır; bu seçimleri yüklemenin Nix kaynağında yönetin.

Kaynak seçme

Yönetilen yerel yol yüklemeleri Plugin dizinleri veya arşivleri olmalıdır. Bağımsız Plugin dosyalarını plugins install ile yüklemek yerine plugins.load.paths içine yerleştirin.

Pluginleri yayımlama

ClawHub, OpenClaw Pluginleri için birincil herkese açık keşif yüzeyidir. Kullanıcıların yüklemeden önce Plugin meta verilerini, sürüm geçmişini, kayıt defteri tarama sonuçlarını ve yükleme ipuçlarını bulmasını istiyorsanız 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/[email protected]

Yerel npm Pluginleri yayımlanmadan önce bir Plugin manifesti (openclaw.plugin.json) ve package.json 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/[email protected]

Bu sayfayı yayımlama başvurusu olarak kullanmak yerine yayımlama sözleşmesinin tamamı için şu sayfaları kullanın:

• ClawHub'da yayımlama; sahipleri, kapsamları, sürümleri, incelemeyi, paket doğrulamayı ve paket aktarımını açıklar.
• Plugin oluşturma, tam Plugin paket yapısını (openclaw.plugin.json dâhil) ve ilk yayımlama iş akışını gösterir.
• Plugin manifesti, yerel Plugin manifesti alanlarını tanımlar.

Aynı paket hem ClawHub'da hem npm'de varsa tek bir kaynağı zorunlu kılmak için açık clawhub: veya npm: ön ekini kullanın.

İlgili

• Pluginler - yükleme, yapılandırma, yeniden başlatma ve sorun giderme
• openclaw plugins - tam CLI başvurusu
• Topluluk Pluginleri - herkese açık keşif ve ClawHub'da yayımlama
• ClawHub - kayıt defteri CLI işlemleri
• Plugin oluşturma - Plugin paketi oluşturma
• Plugin manifesti - manifest ve paket meta verileri