Ana içeriğe atla
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, yerel OpenClaw Plugin’leriyle aynı değildir. Yerel Plugin’ler süreç içinde çalışır ve herhangi bir yetenek kaydedebilir. Paketler ise seçici özellik eşlemesine ve daha dar bir güven sınırına sahip içerik 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

1

Bir dizinden, arşivden veya pazaryerinden yükleyin

# Local directory
openclaw plugins install ./my-bundle

# Archive
openclaw plugins install ./my-bundle.tgz

# Claude marketplace
openclaw plugins marketplace list <marketplace-name>
openclaw plugins install <plugin-name>@<marketplace-name>
2

Algılamayı doğrulayın

openclaw plugins list
openclaw plugins inspect <id>
Paketler, codex, claude veya cursor alt türüyle birlikte Format: bundle olarak görünür.
3

Yeniden başlatın ve kullanın

openclaw gateway restart
Eşlenen özellikler (Skills, kancalar, MCP araçları, LSP varsayılanları) sonraki oturumda kullanılabilir.

​
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

ÖzellikNasıl eşlenirŞunlar için geçerli
Skills içeriğiPaket Skills kökleri normal OpenClaw Skills olarak yüklenirTüm biçimler
Komutlarcommands/ ve .cursor/commands/ Skills kökleri olarak ele alınırClaude, Cursor
Kanca paketleriOpenClaw tarzı HOOK.md + handler.ts yerleşimleriCodex
MCP araçlarıPaket MCP yapılandırması gömülü OpenClaw ayarlarına birleştirilir; desteklenen stdio ve HTTP sunucuları yüklenirTüm biçimler
LSP sunucularıClaude .lsp.json ve manifest içinde bildirilen lspServers, gömülü OpenClaw LSP varsayılanlarına birleştirilirClaude
AyarlarClaude settings.json, gömülü OpenClaw varsayılanları olarak içe aktarılırClaude

​
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

İşaretçiler: .codex-plugin/plugin.jsonİsteğe bağlı içerik: skills/, hooks/, .mcp.json, .app.jsonCodex paketleri, Skills kökleri ve OpenClaw tarzı kanca paketi dizinleri (HOOK.md + handler.ts) kullandıklarında OpenClaw’a en iyi uyar.
İki algılama modu:
  • Manifest tabanlı: .claude-plugin/plugin.json
  • Manifestsiz: varsayılan Claude yerleşimi (skills/, commands/, agents/, hooks/, .mcp.json, .lsp.json, settings.json)
Claude’a özgü davranış:
  • commands/ Skills içeriği olarak ele alınır
  • settings.json, gömülü OpenClaw ayarlarına içe aktarılır (kabuk geçersiz kılma anahtarları temizlenir)
  • .mcp.json, desteklenen stdio araçlarını gömülü OpenClaw’a sunar
  • .lsp.json ile manifest içinde bildirilen lspServers yolları gömülü OpenClaw LSP varsayılanlarına yüklenir
  • hooks/hooks.json algılanır ancak yürütülmez
  • Manifest içindeki özel bileşen yolları eklemelidir (varsayılanları genişletir, onların yerine geçmez)
İşaretçiler: .cursor-plugin/plugin.jsonİsteğe bağlı içerik: skills/, .cursor/commands/, .cursor/agents/, .cursor/rules/, .cursor/hooks.json, .mcp.json
  • .cursor/commands/ Skills içeriği olarak ele alınır
  • .cursor/rules/, .cursor/agents/ ve .cursor/hooks.json yalnızca algılama amaçlıdır

​
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

openclaw plugins inspect <id> çalıştırın. Bir yetenek listelenmiş ancak bağlanmamış olarak işaretlenmişse bu bir ürün sınırıdır; bozuk yükleme değildir.
Paketin etkin olduğundan ve markdown dosyalarının algılanan bir commands/ veya skills/ kökü içinde olduğundan emin olun.
Yalnızca settings.json içindeki gömülü OpenClaw ayarları desteklenir. OpenClaw, paket ayarlarını ham yapılandırma yamaları olarak ele almaz.
hooks/hooks.json yalnızca algılama amaçlıdır. Çalıştırılabilir kancalara ihtiyacınız varsa OpenClaw kanca paketi yerleşimini kullanın veya yerel bir Plugin gönderin.

​
İlgili