Pakiety Plugin

OpenClaw może instalować pluginy z trzech zewnętrznych ekosystemów: Codex, Claude i Cursor. Są one nazywane pakietami — pakietami treści i metadanych, które OpenClaw mapuje na natywne funkcje, takie jak Skills, hooki i narzędzia MCP.

# Dlaczego istnieją pakiety

Wiele przydatnych pluginów jest publikowanych w formacie Codex, Claude lub Cursor. Zamiast wymagać od autorów przepisywania ich jako natywnych pluginów OpenClaw, OpenClaw wykrywa te formaty i mapuje ich obsługiwaną treść na natywny zestaw funkcji. Oznacza to, że możesz zainstalować pakiet poleceń Claude lub pakiet Skills Codex i od razu go używać.

# Zainstaluj pakiet

# 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>

openclaw plugins list
openclaw plugins inspect <id>

openclaw gateway restart

# Co OpenClaw mapuje z pakietów

Nie każda funkcja pakietu działa dziś w OpenClaw. Oto, co działa i co jest wykrywane, ale nie jest jeszcze podłączone.

# Obsługiwane obecnie

# Treść Skills

• katalogi główne Skills pakietu są ładowane jak zwykłe katalogi główne Skills OpenClaw
• katalogi główne Claude commands są traktowane jako dodatkowe katalogi główne Skills
• katalogi główne Cursor .cursor/commands są traktowane jako dodatkowe katalogi główne Skills

Oznacza to, że pliki poleceń markdown Claude działają przez standardowy loader Skills OpenClaw. Markdown poleceń Cursor działa tą samą ścieżką.

# Pakiety hooków

• katalogi główne hooków pakietu działają tylko wtedy, gdy używają standardowego układu pakietu hooków OpenClaw. Dziś jest to przede wszystkim przypadek zgodny z Codex:
  • HOOK.md
  • handler.ts lub handler.js

# MCP dla Pi

• włączone pakiety mogą dostarczać konfigurację serwera MCP
• OpenClaw scala konfigurację MCP pakietu z efektywnymi ustawieniami osadzonego Pi jako mcpServers
• OpenClaw udostępnia obsługiwane narzędzia MCP pakietu podczas tur agenta osadzonego Pi przez uruchamianie serwerów stdio lub łączenie się z serwerami HTTP
• profile narzędzi coding i messaging domyślnie zawierają narzędzia MCP pakietów; użyj tools.deny: ["bundle-mcp"], aby zrezygnować z nich dla agenta lub gateway
• lokalne ustawienia projektu Pi nadal mają zastosowanie po domyślnych ustawieniach pakietu, więc ustawienia obszaru roboczego mogą w razie potrzeby nadpisywać wpisy MCP pakietu
• katalogi narzędzi MCP pakietów są sortowane deterministycznie przed rejestracją, więc zmiany kolejności upstream listTools() nie destabilizują bloków narzędzi prompt-cache

# Transporty

Serwery MCP mogą używać transportu stdio lub HTTP:

Stdio uruchamia proces potomny:

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

HTTP łączy się z działającym serwerem MCP przez sse domyślnie albo streamable-http, gdy zostanie to zażądane:

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

• transport może być ustawiony na "streamable-http" lub "sse"; gdy zostanie pominięty, OpenClaw używa sse
• type: "http" to natywny dla CLI kształt downstream; w konfiguracji OpenClaw użyj transport: "streamable-http". openclaw mcp set i openclaw doctor --fix normalizują typowy alias.
• dozwolone są tylko schematy URL http: i https:
• wartości headers obsługują interpolację ${ENV_VAR}
• wpis serwera zawierający jednocześnie command i url jest odrzucany
• dane uwierzytelniające URL (userinfo i parametry zapytania) są redagowane z opisów narzędzi i logów
• connectionTimeoutMs nadpisuje domyślny 30-sekundowy limit czasu połączenia dla transportów stdio i HTTP

# Nazewnictwo narzędzi

OpenClaw rejestruje narzędzia MCP pakietu z nazwami bezpiecznymi dla dostawców w formie serverName__toolName. Na przykład serwer o kluczu "vigil-harbor" udostępniający narzędzie memory_search jest rejestrowany jako vigil-harbor__memory_search.

• znaki spoza A-Za-z0-9_- są zastępowane przez -
• prefiksy serwerów są ograniczone do 30 znaków
• pełne nazwy narzędzi są ograniczone do 64 znaków
• puste nazwy serwerów używają wartości zapasowej mcp
• kolidujące oczyszczone nazwy są rozróżniane za pomocą sufiksów numerycznych
• końcowa kolejność udostępnianych narzędzi jest deterministyczna według bezpiecznej nazwy, aby powtarzane tury Pi pozostawały stabilne dla cache
• filtrowanie profili traktuje wszystkie narzędzia z jednego serwera MCP pakietu jako należące do pluginu bundle-mcp, więc listy dozwolone i listy blokowane profilu mogą zawierać albo pojedyncze udostępnione nazwy narzędzi, albo klucz pluginu bundle-mcp

# Ustawienia osadzonego Pi

• Claude settings.json jest importowany jako domyślne ustawienia osadzonego Pi, gdy pakiet jest włączony
• OpenClaw oczyszcza klucze nadpisywania powłoki przed ich zastosowaniem

Oczyszczone klucze:

• shellPath
• shellCommandPrefix

# LSP osadzonego Pi

• włączone pakiety Claude mogą dostarczać konfigurację serwera LSP
• OpenClaw ładuje .lsp.json oraz wszelkie ścieżki lspServers zadeklarowane w manifeście
• konfiguracja LSP pakietu jest scalana z efektywnymi domyślnymi ustawieniami LSP osadzonego Pi
• dziś uruchamialne są tylko obsługiwane serwery LSP oparte na stdio; nieobsługiwane transporty nadal pojawiają się w openclaw plugins inspect <id>

# Wykrywane, ale niewykonywane

Te elementy są rozpoznawane i pokazywane w diagnostyce, ale OpenClaw ich nie uruchamia:

• Claude agents, automatyzacja hooks.json, outputStyles
• Cursor .cursor/agents, .cursor/hooks.json, .cursor/rules
• Metadane inline/aplikacji Codex poza raportowaniem możliwości

# Formaty pakietów

# Pierwszeństwo wykrywania

OpenClaw najpierw sprawdza natywny format pluginu:

1. openclaw.plugin.json lub prawidłowy package.json z openclaw.extensions — traktowane jako natywny plugin
2. Markery pakietów (.codex-plugin/, .claude-plugin/ lub domyślny układ Claude/Cursor) — traktowane jako pakiet

Jeśli katalog zawiera oba, OpenClaw używa ścieżki natywnej. Zapobiega to częściowej instalacji pakietów w dwóch formatach jako pakietów.

# Zależności środowiska uruchomieniowego i czyszczenie

• Zgodne pakiety firm trzecich nie otrzymują naprawy startowej npm install. Powinny być instalowane przez openclaw plugins install i dostarczać wszystko, czego potrzebują, w zainstalowanym katalogu pluginu.
• Pluginy pakietowe należące do OpenClaw są albo dostarczane w lekkiej postaci w core, albo pobierane przez instalator pluginów. Uruchomienie Gateway nigdy nie uruchamia dla nich menedżera pakietów.
• openclaw doctor --fix usuwa starsze katalogi etapowanych zależności i może odzyskać pobieralne pluginy, których brakuje w lokalnym indeksie pluginów, gdy konfiguracja się do nich odwołuje.

# Bezpieczeństwo

Pakiety mają węższą granicę zaufania niż natywne pluginy:

• OpenClaw nie ładuje dowolnych modułów uruchomieniowych pakietu w procesie
• Ścieżki Skills i pakietów hooków muszą pozostać wewnątrz katalogu głównego pluginu (sprawdzane względem granic)
• Pliki ustawień są odczytywane z tymi samymi kontrolami granic
• Obsługiwane serwery MCP stdio mogą być uruchamiane jako podprocesy

Dzięki temu pakiety są domyślnie bezpieczniejsze, ale nadal należy traktować pakiety firm trzecich jako zaufaną treść dla funkcji, które faktycznie udostępniają.

# Rozwiązywanie problemów

# Powiązane

• Instalowanie i konfigurowanie pluginów
• Tworzenie pluginów — utwórz natywny plugin
• Manifest pluginu — natywny schemat manifestu