Plugin paketleri

OpenClaw, üç harici ekosistemden Plugin yükleyebilir: Codex, Claude ve Cursor. Bunlara paketler denir; OpenClaw'ın Skills, kancalar ve MCP araçları gibi yerel özelliklere eşlediği içerik ve meta veri paketleridir.

Paketler neden var?

Birçok kullanışlı Plugin, Codex, Claude veya Cursor biçiminde yayımlanır. OpenClaw, yazarlardan bunları yerel OpenClaw Plugin'leri olarak yeniden yazmalarını istemek yerine, bu biçimleri algılar ve desteklenen içeriklerini yerel özellik kümesine eşler. Bu, bir Claude komut paketini veya Codex Skills paketini yükleyip hemen kullanabileceğiniz anlamına gelir.

Paket yükleme

# Local directoryopenclaw plugins install ./my-bundle # Archiveopenclaw plugins install ./my-bundle.tgz # Claude marketplaceopenclaw plugins marketplace list <marketplace-name>openclaw plugins install <plugin-name>@<marketplace-name>

openclaw plugins listopenclaw plugins inspect <id>

openclaw gateway restart

OpenClaw paketlerden neleri eşler?

Bugün her paket özelliği OpenClaw içinde çalışmaz. Aşağıda çalışanlar ve algılanıp henüz bağlanmamış olanlar yer alır.

Şu anda desteklenenler

Skills içeriği

• paket Skills kökleri normal OpenClaw Skills kökleri olarak yüklenir
• Claude commands kökleri ek Skills kökleri olarak ele alınır
• Cursor .cursor/commands kökleri ek Skills kökleri olarak ele alınır

Bu, Claude markdown komut dosyalarının normal OpenClaw Skills yükleyicisi üzerinden çalıştığı anlamına gelir. Cursor komut markdown'ı da aynı yol üzerinden çalışır.

Kanca paketleri

• paket kanca kökleri yalnızca normal OpenClaw kanca paketi yerleşimini kullandıklarında çalışır. Bugün bu öncelikle Codex uyumlu durumdur:
  • HOOK.md
  • handler.ts veya handler.js

Gömülü OpenClaw için MCP

• etkin paketler MCP sunucu yapılandırması katkısında bulunabilir
• OpenClaw, paket MCP yapılandırmasını etkin gömülü OpenClaw ayarlarına mcpServers olarak birleştirir
• OpenClaw, gömülü OpenClaw ajan dönüşleri sırasında desteklenen paket MCP araçlarını stdio sunucuları başlatarak veya HTTP sunucularına bağlanarak sunar
• coding ve messaging araç profilleri varsayılan olarak paket MCP araçlarını içerir; bir ajan veya Gateway için devre dışı bırakmak üzere tools.deny: ["bundle-mcp"] kullanın
• proje yerelindeki gömülü ajan ayarları paket varsayılanlarından sonra hâlâ uygulanır; bu nedenle çalışma alanı ayarları gerektiğinde paket MCP girdilerini geçersiz kılabilir
• paket MCP araç katalogları kayıttan önce deterministik olarak sıralanır; böylece yukarı akış listTools() sıralama değişiklikleri prompt önbelleği araç bloklarını sürekli değiştirmez

Aktarımlar

MCP sunucuları stdio veya HTTP aktarımı kullanabilir:

Stdio bir alt süreç başlatır:

{  "mcp": {    "servers": {      "my-server": {        "command": "node",        "args": ["server.js"],        "env": { "PORT": "3000" }      }    }  }}

HTTP varsayılan olarak sse üzerinden, istendiğinde ise streamable-http ile çalışan bir MCP sunucusuna bağlanır:

{  "mcp": {    "servers": {      "my-server": {        "url": "http://localhost:3100/mcp",        "transport": "streamable-http",        "headers": {          "Authorization": "Bearer ${MY_SECRET_TOKEN}"        },        "connectionTimeoutMs": 30000      }    }  }}

• transport, "streamable-http" veya "sse" olarak ayarlanabilir; atlandığında OpenClaw sse kullanır
• type: "http" CLI yerel bir alt akış şeklidir; OpenClaw yapılandırmasında transport: "streamable-http" kullanın. openclaw mcp set ve openclaw doctor --fix yaygın takma adı normalleştirir.
• yalnızca http: ve https: URL şemalarına izin verilir
• headers değerleri ${ENV_VAR} ara değerlemesini destekler
• hem command hem de url içeren bir sunucu girdisi reddedilir
• URL kimlik bilgileri (userinfo ve sorgu parametreleri), araç açıklamalarından ve günlüklerden çıkarılır
• connectionTimeoutMs, hem stdio hem de HTTP aktarımları için varsayılan 30 saniyelik bağlantı zaman aşımını geçersiz kılar

Araç adlandırma

OpenClaw, paket MCP araçlarını serverName__toolName biçiminde sağlayıcı güvenli adlarla kaydeder. Örneğin, "vigil-harbor" anahtarına sahip ve memory_search aracını sunan bir sunucu vigil-harbor__memory_search olarak kaydedilir.

• A-Za-z0-9_- dışındaki karakterler - ile değiştirilir
• harf olmayan bir karakterle başlayacak parçalar harf öneki alır; böylece 12306 gibi sayısal sunucu anahtarları sağlayıcı güvenli araç öneklerine dönüşür
• sunucu önekleri 30 karakterle sınırlıdır
• tam araç adları 64 karakterle sınırlıdır
• boş sunucu adları mcp değerine geri döner
• çakışan temizlenmiş adlar sayısal soneklerle ayırt edilir
• son sunulan araç sırası, tekrarlanan gömülü ajan dönüşlerini önbellek açısından kararlı tutmak için güvenli ada göre deterministiktir
• profil filtreleme, bir paket MCP sunucusundaki tüm araçları bundle-mcp tarafından Plugin sahipliğinde kabul eder; bu nedenle profil izin listeleri ve engelleme listeleri tek tek sunulan araç adlarını veya bundle-mcp Plugin anahtarını içerebilir

Gömülü OpenClaw ayarları

• Claude settings.json, paket etkin olduğunda varsayılan gömülü OpenClaw ayarları olarak içe aktarılır
• OpenClaw, kabuk geçersiz kılma anahtarlarını uygulamadan önce temizler

Temizlenen anahtarlar:

• shellPath
• shellCommandPrefix

Gömülü OpenClaw LSP

• etkin Claude paketleri LSP sunucu yapılandırması katkısında bulunabilir
• OpenClaw, .lsp.json ile manifest içinde bildirilen tüm lspServers yollarını yükler
• paket LSP yapılandırması, etkin gömülü OpenClaw LSP varsayılanlarına birleştirilir
• bugün yalnızca desteklenen stdio tabanlı LSP sunucuları çalıştırılabilir; desteklenmeyen aktarımlar yine de openclaw plugins inspect <id> içinde görünür

Algılanan ama yürütülmeyenler

Bunlar tanınır ve tanılamalarda gösterilir, ancak OpenClaw bunları çalıştırmaz:

• Claude agents, hooks.json otomasyonu, outputStyles
• Cursor .cursor/agents, .cursor/hooks.json, .cursor/rules
• Yetenek raporlamasının ötesindeki Codex satır içi/uygulama meta verileri

Paket biçimleri

Algılama önceliği

OpenClaw önce yerel Plugin biçimini kontrol eder:

1. openclaw.plugin.json veya openclaw.extensions içeren geçerli package.json — yerel Plugin olarak ele alınır
2. Paket işaretçileri (.codex-plugin/, .claude-plugin/ veya varsayılan Claude/Cursor yerleşimi) — paket olarak ele alınır

Bir dizin ikisini de içeriyorsa OpenClaw yerel yolu kullanır. Bu, çift biçimli paketlerin kısmen paket olarak yüklenmesini engeller.

Çalışma zamanı bağımlılıkları ve temizlik

• Üçüncü taraf uyumlu paketler başlangıçta npm install onarımı almaz. Bunlar openclaw plugins install üzerinden yüklenmeli ve ihtiyaç duydukları her şeyi yüklü Plugin dizininde sağlamalıdır.
• OpenClaw sahipliğindeki paketlenmiş Plugin'ler ya çekirdekte hafif olarak gönderilir ya da Plugin yükleyicisi üzerinden indirilebilir. Gateway başlangıcı bunlar için asla paket yöneticisi çalıştırmaz.
• openclaw doctor --fix, eski aşamalandırılmış bağımlılık dizinlerini kaldırır ve yapılandırma bunlara başvurduğunda yerel Plugin dizininde eksik olan indirilebilir Plugin'leri kurtarabilir.

Güvenlik

Paketlerin güven sınırı yerel Plugin'lere göre daha dardır:

• OpenClaw, rastgele paket çalışma zamanı modüllerini süreç içinde yüklemez
• Skills ve kanca paketi yolları Plugin kökü içinde kalmalıdır (sınır kontrolü yapılır)
• Ayar dosyaları aynı sınır kontrolleriyle okunur
• Desteklenen stdio MCP sunucuları alt süreçler olarak başlatılabilir

Bu, paketleri varsayılan olarak daha güvenli kılar; ancak üçüncü taraf paketleri yine de sundukları özellikler için güvenilir içerik olarak değerlendirmelisiniz.

Sorun giderme

İlgili

• Plugin'leri Yükleme ve Yapılandırma
• Plugin Oluşturma — yerel bir Plugin oluşturun
• Plugin Manifesti — yerel manifest şeması