docs/docs/pl/cli/plugins.md

read_when	sidebarTitle	summary	title	x-i18n
Chcesz zainstalować Pluginy Gateway lub kompatybilne pakiety albo zarządzać nimi Chcesz debugować błędy ładowania Plugin	Plugins	Dokumentacja referencyjna CLI dla `openclaw plugins` (list, install, marketplace, uninstall, enable/disable, doctor)	Pluginy	generated_at model provider source_hash source_path workflow 2026-05-05T01:44:37Z gpt-5.5 openai 24d274f33213231eaed48ac848a9266802a2179ba0311ab18462ad783219095a cli/plugins.md 16

Zarządzaj pluginami Gateway, pakietami hooków i zgodnymi pakietami.

Przewodnik dla użytkowników końcowych dotyczący instalowania, włączania i rozwiązywania problemów z pluginami. Szybkie przykłady instalowania, wyświetlania listy, aktualizowania, odinstalowywania i publikowania. Model zgodności pakietów. Pola manifestu i schemat konfiguracji. Utwardzanie zabezpieczeń dla instalacji pluginów.

Polecenia

openclaw plugins list
openclaw plugins list --enabled
openclaw plugins list --verbose
openclaw plugins list --json
openclaw plugins search <query>
openclaw plugins search <query> --limit 20
openclaw plugins search <query> --json
openclaw plugins install <path-or-spec>
openclaw plugins inspect <id>
openclaw plugins inspect <id> --runtime
openclaw plugins inspect <id> --json
openclaw plugins inspect --all
openclaw plugins info <id>
openclaw plugins enable <id>
openclaw plugins disable <id>
openclaw plugins registry
openclaw plugins registry --refresh
openclaw plugins uninstall <id>
openclaw plugins doctor
openclaw plugins update <id-or-npm-spec>
openclaw plugins update --all
openclaw plugins marketplace list <marketplace>
openclaw plugins marketplace list <marketplace> --json

Aby zbadać powolną instalację, inspekcję, odinstalowanie lub odświeżenie rejestru, uruchom polecenie z OPENCLAW_PLUGIN_LIFECYCLE_TRACE=1. Ślad zapisuje czasy faz do stderr i pozostawia dane wyjściowe JSON możliwe do parsowania. Zobacz Debugowanie.

Pluginy dołączone są dostarczane z OpenClaw. Niektóre są domyślnie włączone (na przykład dołączeni dostawcy modeli, dołączeni dostawcy mowy i dołączony plugin przeglądarki); inne wymagają `plugins enable`.

Natywne pluginy OpenClaw muszą dostarczać openclaw.plugin.json z wbudowanym JSON Schema (configSchema, nawet jeśli jest pusty). Zgodne pakiety używają zamiast tego własnych manifestów pakietów.

plugins list pokazuje Format: openclaw albo Format: bundle. Szczegółowe dane wyjściowe listy/informacji pokazują także podtyp pakietu (codex, claude albo cursor) oraz wykryte możliwości pakietu.

Instalacja

openclaw plugins search "calendar"                   # search ClawHub plugins
openclaw plugins install <package>                      # npm by default
openclaw plugins install clawhub:<package>              # ClawHub only
openclaw plugins install npm:<package>                  # npm only
openclaw plugins install git:github.com/<owner>/<repo>  # git repo
openclaw plugins install git:github.com/<owner>/<repo>@<ref>
openclaw plugins install <package> --force              # overwrite existing install
openclaw plugins install <package> --pin                # pin version
openclaw plugins install <package> --dangerously-force-unsafe-install
openclaw plugins install <path>                         # local path
openclaw plugins install <plugin>@<marketplace>         # marketplace
openclaw plugins install <plugin> --marketplace <name>  # marketplace (explicit)
openclaw plugins install <plugin> --marketplace https://github.com/<owner>/<repo>

Same nazwy pakietów instalują z npm domyślnie podczas przejścia startowego. Użyj `clawhub:` dla ClawHub. Traktuj instalacje pluginów jak uruchamianie kodu. Preferuj przypięte wersje.

plugins search wysyła zapytanie do ClawHub o pakiety pluginów możliwe do zainstalowania i wypisuje nazwy pakietów gotowe do instalacji. Wyszukuje pakiety code-plugin i bundle-plugin, a nie Skills. Użyj openclaw skills search dla ClawHub skills.

ClawHub jest podstawową powierzchnią dystrybucji i odkrywania większości pluginów. Npm pozostaje obsługiwaną ścieżką awaryjną i ścieżką instalacji bezpośredniej. Pakiety pluginów `@openclaw/*` należące do OpenClaw są ponownie publikowane w npm; zobacz bieżącą listę na [npmjs.com/org/openclaw](https://www.npmjs.com/org/openclaw) albo w [inwentarzu pluginów](/pl/plugins/plugin-inventory). Stabilne instalacje używają `latest`. Instalacje i aktualizacje z kanału beta preferują npm `beta` dist-tag, gdy ten tag jest dostępny, a następnie wracają do `latest`. Jeśli Twoja sekcja `plugins` opiera się na jednoplikowym `$include`, `plugins install/update/enable/disable/uninstall` zapisują do tego dołączonego pliku i pozostawiają `openclaw.json` bez zmian. Dołączenia główne, tablice dołączeń i dołączenia z nadrzędnymi ustawieniami obok kończą się bezpieczną odmową zamiast spłaszczania. Zobacz [Dołączenia konfiguracji](/pl/gateway/configuration), aby poznać obsługiwane kształty.

Jeśli konfiguracja jest nieprawidłowa podczas instalacji, `plugins install` zwykle kończy się bezpieczną odmową i informuje, aby najpierw uruchomić `openclaw doctor --fix`. Podczas uruchamiania Gateway i przeładowania na gorąco nieprawidłowa konfiguracja pluginów kończy się bezpieczną odmową jak każda inna nieprawidłowa konfiguracja; `openclaw doctor --fix` może poddać kwarantannie nieprawidłowy wpis pluginu. Jedynym udokumentowanym wyjątkiem w czasie instalacji jest wąska ścieżka odzyskiwania dołączonych pluginów dla pluginów, które jawnie włączają `openclaw.install.allowInvalidConfigRecovery`.

`--force` ponownie używa istniejącego celu instalacji i nadpisuje już zainstalowany plugin lub pakiet hooków w miejscu. Użyj tego, gdy celowo ponownie instalujesz ten sam identyfikator z nowej ścieżki lokalnej, archiwum, pakietu ClawHub albo artefaktu npm. Do rutynowych uaktualnień już śledzonego pluginu npm preferuj `openclaw plugins update `.

Jeśli uruchomisz `plugins install` dla identyfikatora pluginu, który jest już zainstalowany, OpenClaw zatrzyma się i wskaże `plugins update <id-or-npm-spec>` dla normalnego uaktualnienia albo `plugins install <package> --force`, gdy rzeczywiście chcesz nadpisać bieżącą instalację z innego źródła.

`--pin` dotyczy tylko instalacji npm. Nie jest obsługiwane z instalacjami `git:`; użyj jawnego ref git, takiego jak `git:github.com/acme/plugin@v1.2.3`, gdy chcesz przypięte źródło. Nie jest obsługiwane z `--marketplace`, ponieważ instalacje marketplace utrwalają metadane źródła marketplace zamiast specyfikacji npm. `--dangerously-force-unsafe-install` to opcja awaryjna na wypadek fałszywych alarmów w wbudowanym skanerze niebezpiecznego kodu. Pozwala kontynuować instalację nawet wtedy, gdy wbudowany skaner zgłasza ustalenia `critical`, ale **nie** omija blokad polityki hooka pluginu `before_install` i **nie** omija niepowodzeń skanowania.

Ta flaga CLI dotyczy przepływów instalacji/aktualizacji pluginów. Instalacje zależności Skills obsługiwane przez Gateway używają odpowiadającego nadpisania żądania `dangerouslyForceUnsafeInstall`, natomiast `openclaw skills install` pozostaje osobnym przepływem pobierania/instalacji Skills z ClawHub.

Jeśli plugin opublikowany przez Ciebie w ClawHub jest blokowany przez skan rejestru, użyj kroków dla wydawcy w [ClawHub](/pl/tools/clawhub).

`plugins install` jest także powierzchnią instalacji pakietów hooków, które ujawniają `openclaw.hooks` w `package.json`. Używaj `openclaw hooks` do filtrowanej widoczności hooków i włączania poszczególnych hooków, a nie do instalacji pakietów.

Specyfikacje npm są **wyłącznie rejestrowe** (nazwa pakietu + opcjonalna **dokładna wersja** albo **dist-tag**). Specyfikacje Git/URL/plików i zakresy semver są odrzucane. Instalacje zależności uruchamiają się lokalnie dla projektu z `--ignore-scripts` dla bezpieczeństwa, nawet gdy Twoja powłoka ma globalne ustawienia instalacji npm.

Użyj `npm:<package>`, gdy chcesz jawnie wskazać rozwiązywanie npm. Same specyfikacje pakietów także instalują bezpośrednio z npm podczas przejścia startowego.

Same specyfikacje i `@latest` pozostają na stabilnej ścieżce. Datowane wersje poprawek OpenClaw, takie jak `2026.5.3-1`, są stabilnymi wydaniami dla tego sprawdzenia. Jeśli npm rozwiąże którąkolwiek z nich do wersji przedpremierowej, OpenClaw zatrzyma się i poprosi o jawne wyrażenie zgody za pomocą tagu przedpremierowego, takiego jak `@beta`/`@rc`, albo dokładnej wersji przedpremierowej, takiej jak `@1.2.3-beta.4`.

Jeśli sama specyfikacja instalacji pasuje do oficjalnego identyfikatora pluginu (na przykład `diffs`), OpenClaw instaluje wpis katalogu bezpośrednio. Aby zainstalować pakiet npm o tej samej nazwie, użyj jawnej specyfikacji ze scope (na przykład `@scope/diffs`).

Użyj `git:`, aby instalować bezpośrednio z repozytorium git. Obsługiwane formy obejmują `git:github.com/owner/repo`, `git:owner/repo`, pełne adresy URL klonowania `https://`, `ssh://`, `git://`, `file://` i `git@host:owner/repo.git`. Dodaj `@` albo `#`, aby przed instalacją sprawdzić branch, tag albo commit.

Instalacje Git klonują do katalogu tymczasowego, sprawdzają żądany ref, jeśli jest obecny, a następnie używają normalnego instalatora katalogu pluginu. Oznacza to, że walidacja manifestu, skanowanie niebezpiecznego kodu, praca instalacyjna menedżera pakietów i rekordy instalacji zachowują się jak instalacje npm. Zarejestrowane instalacje git zawierają źródłowy URL/ref oraz rozwiązany commit, aby `openclaw plugins update` mógł później ponownie rozwiązać źródło.

Po instalacji z git użyj `openclaw plugins inspect <id> --runtime --json`, aby zweryfikować rejestracje runtime, takie jak metody gateway i polecenia CLI. Jeśli plugin zarejestrował korzeń CLI za pomocą `api.registerCli`, wykonaj to polecenie bezpośrednio przez główne CLI OpenClaw, na przykład `openclaw demo-plugin ping`.

Obsługiwane archiwa: `.zip`, `.tgz`, `.tar.gz`, `.tar`. Archiwa natywnych pluginów OpenClaw muszą zawierać prawidłowy `openclaw.plugin.json` w wyodrębnionym katalogu głównym pluginu; archiwa, które zawierają tylko `package.json`, są odrzucane, zanim OpenClaw zapisze rekordy instalacji.

Instalacje marketplace Claude są także obsługiwane.

Instalacje ClawHub używają jawnego lokalizatora clawhub:<package>:

openclaw plugins install clawhub:openclaw-codex-app-server
openclaw plugins install clawhub:openclaw-codex-app-server@1.2.3

Same specyfikacje pluginów bezpieczne dla npm instalują z npm domyślnie podczas przejścia startowego:

openclaw plugins install openclaw-codex-app-server

Użyj npm:, aby jawnie wymusić rozwiązywanie tylko przez npm:

openclaw plugins install npm:openclaw-codex-app-server
openclaw plugins install npm:@scope/plugin-name@1.0.1

OpenClaw sprawdza reklamowaną zgodność API pluginu / minimalną zgodność gateway przed instalacją. Gdy wybrana wersja ClawHub publikuje artefakt ClawPack, OpenClaw pobiera wersjonowany npm-pack .tgz, weryfikuje nagłówek digest ClawHub i digest artefaktu, a następnie instaluje go przez normalną ścieżkę archiwum. Starsze wersje ClawHub bez metadanych ClawPack nadal instalują przez starszą ścieżkę weryfikacji archiwum pakietu. Zarejestrowane instalacje zachowują metadane źródła ClawHub, rodzaj artefaktu, integralność npm, shasum npm, nazwę tarballa i fakty digest ClawPack do późniejszych aktualizacji. Niewersjonowane instalacje ClawHub zachowują niewersjonowaną zarejestrowaną specyfikację, aby openclaw plugins update mógł śledzić nowsze wydania ClawHub; jawne selektory wersji albo tagów, takie jak clawhub:pkg@1.2.3 i clawhub:pkg@beta, pozostają przypięte do tego selektora.

Skrót marketplace

Użyj skrótu plugin@marketplace, gdy nazwa marketplace istnieje w lokalnej pamięci podręcznej rejestru Claude w ~/.claude/plugins/known_marketplaces.json:

openclaw plugins marketplace list <marketplace-name>
openclaw plugins install <plugin-name>@<marketplace-name>

Użyj --marketplace, gdy chcesz jawnie przekazać źródło marketplace:

openclaw plugins install <plugin-name> --marketplace <marketplace-name>
openclaw plugins install <plugin-name> --marketplace <owner/repo>
openclaw plugins install <plugin-name> --marketplace https://github.com/<owner>/<repo>
openclaw plugins install <plugin-name> --marketplace ./my-marketplace

- znana nazwa marketplace Claude z `~/.claude/plugins/known_marketplaces.json` - lokalny katalog główny marketplace lub ścieżka `marketplace.json` - skrót repozytorium GitHub, taki jak `owner/repo` - URL repozytorium GitHub, taki jak `https://github.com/owner/repo` - URL git W przypadku zdalnych marketplace ładowanych z GitHub lub git wpisy pluginów muszą pozostać wewnątrz sklonowanego repozytorium marketplace. OpenClaw akceptuje względne źródła ścieżek z tego repozytorium i odrzuca źródła pluginów HTTP(S), ścieżki bezwzględne, git, GitHub oraz inne źródła niebędące ścieżkami ze zdalnych manifestów.

W przypadku lokalnych ścieżek i archiwów OpenClaw automatycznie wykrywa:

• natywne pluginy OpenClaw (openclaw.plugin.json)
• pakiety zgodne z Codex (.codex-plugin/plugin.json)
• pakiety zgodne z Claude (.claude-plugin/plugin.json lub domyślny układ komponentów Claude)
• pakiety zgodne z Cursor (.cursor-plugin/plugin.json)

Zgodne pakiety instalują się w normalnym katalogu głównym pluginów i uczestniczą w tym samym przepływie list/info/enable/disable. Obecnie obsługiwane są Skills pakietów, command-skills Claude, domyślne ustawienia Claude `settings.json`, domyślne ustawienia Claude `.lsp.json` / zadeklarowane w manifeście `lspServers`, command-skills Cursor oraz zgodne katalogi hooków Codex; inne wykryte możliwości pakietów są pokazywane w diagnostyce/info, ale nie są jeszcze podłączone do wykonywania w runtime.

Lista

openclaw plugins list
openclaw plugins list --enabled
openclaw plugins list --verbose
openclaw plugins list --json
openclaw plugins search <query>
openclaw plugins search <query> --limit 20
openclaw plugins search <query> --json

Pokaż tylko włączone pluginy. Przełącz z widoku tabeli na szczegółowe wiersze dla każdego pluginu z metadanymi źródła/pochodzenia/wersji/aktywacji. Inwentarz czytelny maszynowo oraz diagnostyka rejestru i stan instalacji zależności pakietów. `plugins list` najpierw odczytuje utrwalony lokalny rejestr pluginów, z zapasowym wariantem wyprowadzanym wyłącznie z manifestu, gdy rejestru brakuje lub jest nieprawidłowy. Jest przydatne do sprawdzania, czy plugin jest zainstalowany, włączony i widoczny dla planowania zimnego startu, ale nie jest sondą runtime działającego już procesu Gateway. Po zmianie kodu pluginu, włączenia, polityki hooków lub `plugins.load.paths` uruchom ponownie Gateway obsługujący kanał, zanim oczekujesz uruchomienia nowego kodu `register(api)` lub hooków. W przypadku wdrożeń zdalnych/kontenerowych sprawdź, czy ponownie uruchamiasz rzeczywisty proces podrzędny `openclaw gateway run`, a nie tylko proces opakowujący.

plugins list --json zawiera dependencyStatus każdego pluginu z package.json dependencies i optionalDependencies. OpenClaw sprawdza, czy te nazwy pakietów są obecne na normalnej ścieżce wyszukiwania Node node_modules pluginu; nie importuje kodu runtime pluginu, nie uruchamia menedżera pakietów ani nie naprawia brakujących zależności.

plugins search to zdalne wyszukiwanie w katalogu ClawHub. Nie sprawdza lokalnego stanu, nie modyfikuje konfiguracji, nie instaluje pakietów ani nie ładuje kodu runtime pluginu. Wyniki wyszukiwania obejmują nazwę pakietu ClawHub, rodzinę, kanał, wersję, podsumowanie oraz wskazówkę instalacji, taką jak openclaw plugins install clawhub:<package>.

Do pracy z dołączonym pluginem wewnątrz spakowanego obrazu Docker zamontuj katalog źródłowy pluginu przez bind-mount nad odpowiadającą mu spakowaną ścieżką źródłową, taką jak /app/extensions/synology-chat. OpenClaw wykryje tę zamontowaną nakładkę źródła przed /app/dist/extensions/synology-chat; zwykły skopiowany katalog źródłowy pozostaje nieaktywny, więc normalne spakowane instalacje nadal używają skompilowanego dist.

Do debugowania hooków runtime:

• openclaw plugins inspect <id> --runtime --json pokazuje zarejestrowane hooki i diagnostykę z przebiegu inspekcji z załadowanym modułem. Inspekcja runtime nigdy nie instaluje zależności; użyj openclaw doctor --fix, aby wyczyścić starszy stan zależności lub odzyskać brakujące pluginy do pobrania, do których odwołuje się konfiguracja.
• openclaw gateway status --deep --require-rpc potwierdza osiągalny Gateway, wskazówki usługi/procesu, ścieżkę konfiguracji i kondycję RPC.
• Niedołączone hooki konwersacji (llm_input, llm_output, before_agent_finalize, agent_end) wymagają plugins.entries.<id>.hooks.allowConversationAccess=true.

Użyj --link, aby uniknąć kopiowania lokalnego katalogu (dodaje do plugins.load.paths):

openclaw plugins install -l ./my-plugin

`--force` nie jest obsługiwane z `--link`, ponieważ instalacje połączone ponownie używają ścieżki źródłowej zamiast kopiować ją na zarządzany cel instalacji.

Użyj --pin przy instalacjach npm, aby zapisać rozwiązaną dokładną specyfikację (name@version) w zarządzanym indeksie pluginów, zachowując domyślne zachowanie bez przypięcia.

Indeks pluginów

Metadane instalacji pluginów są stanem zarządzanym maszynowo, a nie konfiguracją użytkownika. Instalacje i aktualizacje zapisują je do plugins/installs.json w aktywnym katalogu stanu OpenClaw. Jego mapa najwyższego poziomu installRecords jest trwałym źródłem metadanych instalacji, w tym rekordów uszkodzonych lub brakujących manifestów pluginów. Tablica plugins jest cache zimnego rejestru wyprowadzanym z manifestów. Plik zawiera ostrzeżenie, aby go nie edytować, i jest używany przez openclaw plugins update, odinstalowywanie, diagnostykę oraz zimny rejestr pluginów.

Gdy OpenClaw widzi dostarczone starsze rekordy plugins.installs w konfiguracji, przenosi je do indeksu pluginów i usuwa klucz konfiguracji; jeśli którykolwiek zapis się nie powiedzie, rekordy konfiguracji zostają zachowane, aby metadane instalacji nie zostały utracone.

Odinstalowanie

openclaw plugins uninstall <id>
openclaw plugins uninstall <id> --dry-run
openclaw plugins uninstall <id> --keep-files

uninstall usuwa rekordy pluginów z plugins.entries, utrwalonego indeksu pluginów, wpisów listy allow/deny pluginów oraz połączonych wpisów plugins.load.paths, gdy ma to zastosowanie. O ile nie ustawiono --keep-files, odinstalowanie usuwa też śledzony zarządzany katalog instalacji, gdy znajduje się on w katalogu głównym rozszerzeń pluginów OpenClaw. W przypadku pluginów active memory slot pamięci resetuje się do memory-core.

`--keep-config` jest obsługiwane jako przestarzały alias `--keep-files`.

Aktualizacja

openclaw plugins update <id-or-npm-spec>
openclaw plugins update --all
openclaw plugins update <id-or-npm-spec> --dry-run
openclaw plugins update @openclaw/voice-call
openclaw plugins update openclaw-codex-app-server --dangerously-force-unsafe-install

Aktualizacje dotyczą śledzonych instalacji pluginów w zarządzanym indeksie pluginów oraz śledzonych instalacji hook-pack w hooks.internal.installs.

Gdy podajesz identyfikator pluginu, OpenClaw ponownie używa zapisanej specyfikacji instalacji dla tego pluginu. Oznacza to, że wcześniej zapisane dist-tags, takie jak `@beta`, oraz dokładnie przypięte wersje nadal będą używane w późniejszych uruchomieniach `update `.

W przypadku instalacji npm możesz też podać jawną specyfikację pakietu npm z dist-tag lub dokładną wersją. OpenClaw rozwiązuje tę nazwę pakietu z powrotem do śledzonego rekordu pluginu, aktualizuje ten zainstalowany plugin i zapisuje nową specyfikację npm do przyszłych aktualizacji opartych na identyfikatorze.

Podanie nazwy pakietu npm bez wersji lub tagu również rozwiązuje ją z powrotem do śledzonego rekordu pluginu. Użyj tego, gdy plugin był przypięty do dokładnej wersji i chcesz przenieść go z powrotem na domyślną linię wydań rejestru.

`openclaw plugins update` ponownie używa śledzonej specyfikacji pluginu, chyba że podasz nową specyfikację. `openclaw update` dodatkowo zna aktywny kanał aktualizacji OpenClaw: na kanale beta rekordy pluginów npm i ClawHub z domyślnej linii próbują najpierw `@beta`, a następnie wracają do zapisanej specyfikacji default/latest, jeśli wydanie beta pluginu nie istnieje. Dokładne wersje i jawne tagi pozostają przypięte do tego selektora. Przed aktualizacją npm na żywo OpenClaw sprawdza zainstalowaną wersję pakietu względem metadanych rejestru npm. Jeśli zainstalowana wersja i zapisana tożsamość artefaktu już odpowiadają rozwiązanemu celowi, aktualizacja zostaje pominięta bez pobierania, ponownej instalacji ani przepisywania `openclaw.json`.

Gdy istnieje zapisany hash integralności, a hash pobranego artefaktu się zmienia, OpenClaw traktuje to jako dryf artefaktu npm. Interaktywne polecenie `openclaw plugins update` wypisuje oczekiwany i rzeczywisty hash oraz prosi o potwierdzenie przed kontynuacją. Nieinteraktywne helpery aktualizacji zamykają się błędem, chyba że wywołujący poda jawną politykę kontynuacji.

`--dangerously-force-unsafe-install` jest też dostępne w `plugins update` jako awaryjne obejście fałszywych alarmów wbudowanego skanowania niebezpiecznego kodu podczas aktualizacji pluginów. Nadal nie omija blokad polityki pluginu `before_install` ani blokowania po niepowodzeniu skanowania i dotyczy tylko aktualizacji pluginów, nie aktualizacji hook-pack.

Inspekcja

openclaw plugins inspect <id>
openclaw plugins inspect <id> --runtime
openclaw plugins inspect <id> --json

Inspekcja pokazuje tożsamość, stan ładowania, źródło, możliwości manifestu, flagi polityk, diagnostykę, metadane instalacji, możliwości pakietu oraz wykrytą obsługę serwera MCP lub LSP, domyślnie bez importowania runtime pluginu. Dodaj --runtime, aby załadować moduł pluginu i uwzględnić zarejestrowane hooki, narzędzia, polecenia, usługi, metody gateway i trasy HTTP. Inspekcja runtime zgłasza brakujące zależności pluginu bezpośrednio; instalacje i naprawy pozostają w openclaw plugins install, openclaw plugins update oraz openclaw doctor --fix.

Polecenia CLI należące do pluginu są instalowane jako główne grupy poleceń openclaw. Gdy inspect --runtime pokaże polecenie pod cliCommands, uruchom je jako openclaw <command> ...; na przykład plugin rejestrujący demo-git można zweryfikować przez openclaw demo-git ping.

Każdy plugin jest klasyfikowany według tego, co faktycznie rejestruje w runtime:

• plain-capability — jeden typ możliwości (np. plugin wyłącznie providera)
• hybrid-capability — wiele typów możliwości (np. tekst + mowa + obrazy)
• hook-only — tylko hooki, bez możliwości ani powierzchni
• non-capability — narzędzia/polecenia/usługi, ale bez możliwości

Zobacz Kształty pluginów, aby dowiedzieć się więcej o modelu możliwości.

Flaga `--json` wypisuje raport czytelny maszynowo, odpowiedni do skryptów i audytu. `inspect --all` renderuje tabelę dla całej floty z kolumnami kształtu, rodzajów możliwości, uwag o zgodności, możliwości pakietów oraz podsumowania hooków. `info` jest aliasem `inspect`.

Doctor

openclaw plugins doctor

doctor zgłasza błędy ładowania pluginów, diagnostykę manifestu/wykrywania oraz uwagi o zgodności. Gdy wszystko jest czyste, wypisuje No plugin issues detected.

Jeśli skonfigurowany plugin jest obecny na dysku, ale zablokowany przez kontrole bezpieczeństwa ścieżek loadera, walidacja konfiguracji zachowuje wpis pluginu i zgłasza go jako present but blocked. Napraw poprzedzającą diagnostykę zablokowanego pluginu, taką jak własność ścieżki lub uprawnienia world-writable, zamiast usuwać konfigurację plugins.entries.<id> lub plugins.allow.

W przypadku niepowodzeń kształtu modułu, takich jak brak eksportów register/activate, uruchom ponownie z OPENCLAW_PLUGIN_LOAD_DEBUG=1, aby uwzględnić kompaktowe podsumowanie kształtu eksportów w wyjściu diagnostycznym.

Rejestr

openclaw plugins registry
openclaw plugins registry --refresh
openclaw plugins registry --json

Lokalny rejestr pluginów jest utrwalonym zimnym modelem odczytu OpenClaw dla tożsamości zainstalowanych pluginów, włączenia, metadanych źródła i własności wkładu. Normalny start, wyszukiwanie właściciela providera, klasyfikacja konfiguracji kanału i inwentarz pluginów mogą go odczytywać bez importowania modułów runtime pluginów.

Użyj plugins registry, aby sprawdzić, czy utrwalony rejestr jest obecny, aktualny lub nieaktualny. Użyj --refresh, aby odbudować go z utrwalonego indeksu Plugin, zasad konfiguracji oraz metadanych manifestu/pakietu. To ścieżka naprawy, a nie ścieżka aktywacji w czasie działania.

openclaw doctor --fix naprawia także sąsiadujące z rejestrem przesunięcia zarządzanego npm: jeśli osierocony lub odzyskany pakiet @openclaw/* pod zarządzanym korzeniem npm Plugin przesłania dołączony Plugin, doctor usuwa ten nieaktualny pakiet i odbudowuje rejestr, aby uruchamianie było walidowane względem dołączonego manifestu.

`OPENCLAW_DISABLE_PERSISTED_PLUGIN_REGISTRY=1` to przestarzały awaryjny przełącznik zgodności na wypadek błędów odczytu rejestru. Preferuj `plugins registry --refresh` albo `openclaw doctor --fix`; awaryjny mechanizm przez zmienną środowiskową służy tylko do ratunkowego odzyskania uruchamiania podczas wdrażania migracji.

Marketplace

openclaw plugins marketplace list <source>
openclaw plugins marketplace list <source> --json

Lista Marketplace akceptuje lokalną ścieżkę marketplace, ścieżkę marketplace.json, skrót GitHub w stylu owner/repo, URL repozytorium GitHub albo URL git. --json wypisuje rozpoznaną etykietę źródła oraz sparsowany manifest marketplace i wpisy Plugin.

Powiązane

• Tworzenie Plugin
• Dokumentacja CLI
• Społecznościowe Plugin