Pakiety Pluginów

​

Dlaczego istnieją pakiety

​

Instalowanie pakietu

# Katalog lokalny
openclaw plugins install ./my-bundle

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

# Marketplace Claude
openclaw plugins marketplace list <source>
openclaw plugins install <plugin> --marketplace <source>

openclaw plugins list
openclaw plugins inspect <id>

openclaw gateway restart

​

Co OpenClaw odwzorowuje z pakietów

​

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.

​

Pakiety hooków

​

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

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

{
  "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

• 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

• 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

• 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

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

​

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

• 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.

​

Rozwiązywanie problemów

​

Powiązane

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