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 özelliklerle eşleştirdiği içerik ve meta veri paketleridir.

Paketler neden vardır?

Birçok yararlı plugin Codex, Claude veya Cursor biçiminde yayımlanır. OpenClaw, yazarların bunları yerel OpenClaw pluginleri olarak yeniden yazmasını istemek yerine bu biçimleri algılar ve desteklenen içeriklerini yerel özellik kümesiyle eşleştirir. Bir Claude komut paketini veya Codex Skills paketini yükleyip hemen kullanabilirsiniz.

Paket yükleme

# Yerel dizinopenclaw plugins install ./my-bundle # Arşivopenclaw plugins install ./my-bundle.tgz # Claude pazaryeriopenclaw plugins marketplace list <source>openclaw plugins install <plugin> --marketplace <source>

openclaw plugins listopenclaw plugins inspect <id>

openclaw gateway restart

OpenClaw paketlerden neleri eşler?

Günümüzde her paket özelliği OpenClaw'da çalışmaz. Aşağıda çalışanlar ile algılanan ancak henüz bağlanmamış olanlar yer almaktadı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 değerlendirilir.
• Cursor .cursor/commands/ kökleri ek Skills kökleri olarak değerlendirilir.

Claude Markdown komut dosyaları ve Cursor komut Markdown'ları, normal OpenClaw Skills yükleyicisi üzerinden çalışır.

Kanca paketleri

Paket kanca kökleri yalnızca normal OpenClaw kanca paketi düzenini kullandıklarında çalışır: HOOK.md ile birlikte handler.ts veya handler.js. Günümüzde bu öncelikle Codex uyumlu durumdur.

Gömülü OpenClaw için MCP

• Etkin paketler MCP sunucu yapılandırmasına katkıda bulunabilir.
• OpenClaw, paket MCP yapılandırmasını geçerli gömülü OpenClaw ayarlarına mcpServers olarak birleştirir.
• OpenClaw, stdio sunucularını başlatarak veya HTTP sunucularına bağlanarak gömülü OpenClaw ajan dönüşleri sırasında desteklenen paket MCP araçlarını sunar.
• coding ve messaging araç profilleri varsayılan olarak paket MCP araçlarını içerir; bir ajan veya Gateway için kapsam dışında bırakmak üzere tools.deny: ["bundle-mcp"] kullanın.
• Proje yerelindeki gömülü ajan ayarları paket varsayılanlarından sonra uygulanmaya devam eder; böylece çalışma alanı ayarları gerektiğinde paket MCP girdilerini geçersiz kılabilir.
• Paket MCP araç katalogları kayıttan önce belirlenimsel olarak sıralanır; böylece üst kaynak listTools() sırası değişiklikleri istem önbelleğinin araç bloklarında gereksiz değişime yol açmaz.

Aktarımlar

MCP sunucuları stdio veya HTTP aktarımını kullanabilir.

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

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

HTTP, çalışan bir MCP sunucusuna bağlanır ve streamable-http istenmediği sürece varsayılan olarak sse kullanı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" kabul eder; belirtilmezse varsayılan değer sse olur.
• type: "http", CLI'a özgü bir alt kaynak biçimidir; OpenClaw yapılandırmasında transport: "streamable-http" kullanın. openclaw mcp set ve openclaw doctor --fix yaygın diğer adı normalleştirir.
• Yalnızca http: ve https: URL şemalarına izin verilir.
• headers değerleri ${ENV_VAR} yerleştirmesini destekler.
• Hem command hem de url içeren bir sunucu girdisi reddedilir.
• URL kimlik bilgileri (kullanıcı bilgisi ve sorgu parametreleri), araç açıklamalarında ve günlüklerde gizlenir.
• connectionTimeoutMs, hem stdio hem de HTTP aktarımları için varsayılan 30 saniyelik bağlantı zaman aşımını geçersiz kılar. İstek zaman aşımı varsayılan olarak 60 saniyedir ve requestTimeoutMs ile geçersiz kılınabilir.

Araç adlandırma

OpenClaw, paket MCP araçlarını serverName__toolName biçiminde sağlayıcı açısından güvenli adlarla kaydeder. Örneğin, memory_search aracını sunan ve "vigil-harbor" anahtarıyla tanımlanan 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çalara harf öneki eklenir; böylece 12306 gibi sayısal sunucu anahtarları sağlayıcı açısından güvenli araç öneklerine dönüşür.
• Sunucu önekleri en fazla 30 karakter olabilir.
• Tam araç adları en fazla 64 karakter olabilir.
• Boş sunucu adları için mcp kullanılır.
• Çakışan temizlenmiş adlar sayısal son eklerle birbirinden ayrılır.
• Sunulan nihai araç sırası güvenli ada göre belirlenimseldir ve yinelenen gömülü ajan dönüşlerinde önbellek kararlılığını korur.
• Profil filtreleme, bir paket MCP sunucusundaki her aracı bundle-mcp tarafından sahip olunan bir plugin olarak değerlendirir; böylece profil izin/verme listeleri tek tek sunulan araç adlarına veya bundle-mcp plugin anahtarına başvurabilir.

Gömülü OpenClaw ayarları

Paket etkinleştirildiğinde Claude settings.json, varsayılan gömülü OpenClaw ayarları olarak içe aktarılır. OpenClaw, uygulamadan önce kabuk geçersiz kılma anahtarlarını temizler:

• shellPath
• shellCommandPrefix

Gömülü OpenClaw LSP

• Etkin Claude paketleri LSP sunucu yapılandırmasına katkıda bulunabilir.
• OpenClaw, .lsp.json ile manifestte bildirilen tüm lspServers yollarını yükler.
• Paket LSP yapılandırması, geçerli gömülü OpenClaw LSP varsayılanlarıyla birleştirilir.
• Günümüzde 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 ancak çalıştırılmayanlar

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

• Claude agents, hooks/hooks.json otomasyonu, outputStyles
• Cursor .cursor/agents, .cursor/hooks.json, .cursor/rules
• Yetenek raporlamasının ötesindeki Codex .app.json meta verileri

Paket biçimleri

Algılama önceliği

OpenClaw önce yerel plugin biçimini denetler:

1. openclaw.plugin.json veya openclaw.extensions içeren geçerli bir package.json - yerel plugin olarak değerlendirilir
2. Paket işaretleyicileri (.codex-plugin/, .claude-plugin/ veya varsayılan Claude/Cursor düzeni) - paket olarak değerlendirilir

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

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

• Üçüncü taraf uyumlu paketlere başlangıçta npm install onarımı uygulanmaz. Bunlar, openclaw plugins install üzerinden yüklenmeli ve ihtiyaç duydukları her şeyi yüklü plugin dizininde sağlamalıdır.
• OpenClaw'a ait paketlenmiş pluginler ya çekirdekte hafif biçimde sunulur ya da plugin yükleyicisi üzerinden indirilebilir. Gateway başlangıcı bunlar için hiçbir zaman paket yöneticisi çalıştırmaz.
• openclaw doctor --fix, eski yerel paketlenmiş plugin yükleme kayıtlarını kaldırır ve yapılandırma hâlâ bunlara başvuruyorsa yerel plugin dizininde bulunmayan indirilebilir pluginleri kurtarabilir.

Güvenlik

Paketlerin güven sınırı yerel pluginlere göre daha dardır:

• OpenClaw, rastgele paket çalışma zamanı modüllerini işlem içinde yüklemez.
• Skills ve kanca paketi yolları plugin kökü içinde kalmalıdır (sınır denetimli).
• Ayar dosyaları aynı sınır denetimleriyle 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 sundukları özellikler açısından yine de güvenilir içerik olarak değerlendirmelisiniz.

Sorun giderme

İlgili

• Pluginleri Yükleme ve Yapılandırma
• Plugin Oluşturma - yerel bir plugin oluşturun
• Plugin Manifesti - yerel manifest şeması