Pakiety Pluginów

OpenClaw może instalować pluginy z trzech zewnętrznych ekosystemów: Codex, Claude i Cursor. Są one nazywane pakietami — zestawami treści i metadanych, które OpenClaw odwzorowuje 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 odwzorowuje obsługiwaną przez nie zawartość na natywny zestaw funkcji. Możesz zainstalować pakiet poleceń Claude lub pakiet Skills Codex i od razu zacząć z niego korzystać.

Instalowanie pakietu

# Katalog lokalnyopenclaw plugins install ./my-bundle # Archiwumopenclaw plugins install ./my-bundle.tgz # Marketplace Claudeopenclaw plugins marketplace list <source>openclaw plugins install <plugin> --marketplace <source>

openclaw plugins listopenclaw plugins inspect <id>

openclaw gateway restart

Co OpenClaw odwzorowuje z pakietów

Obecnie nie każda funkcja pakietu działa w OpenClaw. Poniżej przedstawiono funkcje, które działają, oraz te, które są wykrywane, ale nie zostały jeszcze podłączone.

Obecnie obsługiwane

Zawartość Skills

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

Pliki poleceń Markdown Claude i pliki poleceń Markdown Cursor działają za pośrednictwem zwykłego modułu ładującego Skills OpenClaw.

Pakiety hooków

Katalogi główne hooków pakietu działają tylko wtedy, gdy używają zwykłego układu pakietu hooków OpenClaw: HOOK.md oraz handler.ts lub handler.js. Obecnie dotyczy to przede wszystkim przypadku zgodnego z Codex.

MCP dla osadzonego OpenClaw

• Włączone pakiety mogą dostarczać konfigurację serwerów MCP.
• OpenClaw scala konfigurację MCP pakietu z obowiązującymi ustawieniami osadzonego OpenClaw jako mcpServers.
• OpenClaw udostępnia obsługiwane narzędzia MCP pakietu podczas tur agenta osadzonego OpenClaw, uruchamiając serwery stdio lub łącząc się z serwerami HTTP.
• Profile narzędzi coding i messaging domyślnie obejmują narzędzia MCP pakietów; użyj tools.deny: ["bundle-mcp"], aby wyłączyć je dla agenta lub Gateway.
• Lokalne ustawienia osadzonego agenta dla projektu nadal są stosowane po wartościach domyślnych pakietu, dzięki czemu ustawienia przestrzeni roboczej mogą w razie potrzeby nadpisywać wpisy MCP pakietu.
• Katalogi narzędzi MCP pakietów są sortowane deterministycznie przed rejestracją, dlatego zmiany kolejności zwracanej przez nadrzędne listTools() nie powodują ciągłych zmian bloków narzędzi w pamięci podręcznej promptów.

Transporty

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

Transport stdio uruchamia proces potomny:

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

Transport HTTP łączy się z działającym serwerem MCP, domyślnie używając sse, chyba że zażądano streamable-http:

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

• transport przyjmuje "streamable-http" lub "sse"; w razie pominięcia domyślnie używane jest sse.
• type: "http" jest natywną dla CLI postacią używaną przez systemy niższego poziomu; w konfiguracji OpenClaw użyj transport: "streamable-http". Polecenia openclaw mcp set i openclaw doctor --fix normalizują ten popularny 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 w adresach URL (informacje o użytkowniku i parametry zapytania) są redagowane w opisach narzędzi i dziennikach.
• connectionTimeoutMs zastępuje domyślny 30-sekundowy limit czasu połączenia zarówno dla transportu stdio, jak i HTTP. Domyślny limit czasu żądania wynosi 60 sekund i można go zastąpić za pomocą requestTimeoutMs.

Nazewnictwo narzędzi

OpenClaw rejestruje narzędzia MCP pakietów pod nazwami bezpiecznymi dla dostawców, w postaci serverName__toolName. Na przykład serwer o kluczu "vigil-harbor", który udostępnia narzędzie memory_search, jest rejestrowany jako vigil-harbor__memory_search.

• Znaki spoza zakresu A-Za-z0-9_- są zastępowane znakiem -.
• Fragmenty, które zaczynałyby się od znaku niebędącego literą, otrzymują prefiks będący literą, dlatego numeryczne klucze serwerów, takie jak 12306, stają się bezpiecznymi dla dostawców prefiksami narzędzi.
• Prefiksy serwerów są ograniczone do 30 znaków.
• Pełne nazwy narzędzi są ograniczone do 64 znaków.
• W przypadku pustych nazw serwerów używana jest nazwa zastępcza mcp.
• Kolizje oczyszczonych nazw są rozróżniane za pomocą sufiksów liczbowych.
• Ostateczna kolejność udostępnionych narzędzi jest deterministyczna według bezpiecznej nazwy, co utrzymuje stabilność pamięci podręcznej podczas kolejnych tur osadzonego agenta.
• Filtrowanie profili traktuje każde narzędzie z jednego serwera MCP pakietu jako należące do pluginu bundle-mcp, dzięki czemu listy dozwolonych i zabronionych elementów profilu mogą odwoływać się do poszczególnych udostępnionych nazw narzędzi albo do klucza pluginu bundle-mcp.

Ustawienia osadzonego OpenClaw

Plik settings.json Claude jest importowany jako domyślne ustawienia osadzonego OpenClaw, gdy pakiet jest włączony. Przed ich zastosowaniem OpenClaw oczyszcza klucze nadpisujące powłokę:

• shellPath
• shellCommandPrefix

LSP osadzonego OpenClaw

• Włączone pakiety Claude mogą dostarczać konfigurację serwerów LSP.
• OpenClaw ładuje .lsp.json oraz wszystkie ścieżki lspServers zadeklarowane w manifeście.
• Konfiguracja LSP pakietu jest scalana z obowiązującymi wartościami domyślnymi LSP osadzonego OpenClaw.
• Obecnie można uruchamiać tylko obsługiwane serwery LSP wykorzystujące stdio; nieobsługiwane transporty nadal są widoczne w openclaw plugins inspect <id>.

Wykrywane, ale niewykonywane

Poniższe elementy są rozpoznawane i wyświetlane w diagnostyce, ale OpenClaw ich nie uruchamia:

• agents, automatyzacja hooks/hooks.json i outputStyles Claude
• .cursor/agents, .cursor/hooks.json i .cursor/rules Cursor
• Metadane .app.json Codex wykraczające poza raportowanie możliwości

Formaty pakietów

Kolejność wykrywania

OpenClaw najpierw sprawdza format natywnego pluginu:

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

Jeśli katalog zawiera oba formaty, OpenClaw używa ścieżki natywnej. Zapobiega to częściowej instalacji pakietów obsługujących dwa formaty jako pakietów.

Zależności środowiska uruchomieniowego i czyszczenie

• Zgodne pakiety innych firm nie otrzymują podczas uruchamiania naprawy za pomocą npm install. Należy je instalować przez openclaw plugins install; powinny zawierać wszystko, czego potrzebują, w katalogu zainstalowanego pluginu.
• Dołączone pluginy należące do OpenClaw są dostarczane w lekkiej postaci w rdzeniu albo można je pobrać za pomocą instalatora pluginów. Podczas uruchamiania Gateway nigdy nie uruchamia dla nich menedżera pakietów.
• openclaw doctor --fix usuwa nieaktualne rekordy instalacji lokalnych dołączonych pluginów i może odzyskać pluginy dostępne do pobrania, których brakuje w lokalnym indeksie pluginów, jeśli konfiguracja nadal się do nich odwołuje.

Bezpieczeństwo

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

• OpenClaw nie ładuje dowolnych modułów środowiska uruchomieniowego pakietu wewnątrz procesu.
• Ścieżki Skills i pakietów hooków muszą pozostawać wewnątrz katalogu głównego pluginu (są sprawdzane pod kątem granic).
• Pliki ustawień są odczytywane z zastosowaniem tych samych kontroli 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 innych firm jako zaufaną zawartość w zakresie funkcji, które udostępniają.

Rozwiązywanie problemów

Powiązane

• Instalowanie i konfigurowanie pluginów
• Tworzenie pluginów — tworzenie natywnego pluginu
• Manifest pluginu — schemat natywnego manifestu