Zarządzanie pluginami

Interfejs Control UI obsługuje typowy proces wyszukiwania, instalowania, włączania i wyłączania. CLI zapewnia dodatkowo aktualizowanie, odinstalowywanie, konfigurację zaawansowaną oraz jawne sterowanie źródłem instalacji. Pełny opis poleceń, flag, reguł wyboru źródła i przypadków brzegowych zawiera openclaw plugins.

Typowy proces w CLI: znaleźć pakiet, zainstalować go z ClawHub, npm, git lub ścieżki lokalnej, zaczekać na automatyczne ponowne uruchomienie zarządzanego Gateway (albo uruchomić go ponownie ręcznie), a następnie zweryfikować rejestracje środowiska wykonawczego pluginu.

Korzystanie z Control UI

Otwórz Plugins w Control UI lub użyj /settings/plugins względem skonfigurowanej ścieżki bazowej Control UI. Na przykład ścieżka bazowa /openclaw używa /openclaw/settings/plugins. Strona zawiera dwie karty:

• Zainstalowane wyświetla pełny lokalny spis pogrupowany według kategorii (kanały, dostawcy modeli, pamięć, narzędzia). Każdy wiersz otwiera widok szczegółów; jego menu dodatkowych opcji (…) umożliwia włączenie lub wyłączenie pluginu, a w przypadku pluginów zainstalowanych zewnętrznie oferuje opcję Usuń. Karta zawiera również skonfigurowane serwery MCP, z tymi samymi dostępnymi z menu operacjami włączania, wyłączania i usuwania, które edytują mcp.servers w konfiguracji Gateway.
• Odkrywanie to sklep: wyróżnione pluginy dołączone do OpenClaw, oficjalne pluginy zewnętrzne oraz wyselekcjonowany katalog konektorów. Karty konektorów dodają hostowany serwer MCP jednym kliknięciem (GitHub, Notion, Linear, Sentry, Home Assistant) albo otwierają wstępnie wypełnione wyszukiwanie w ClawHub. Wpisywanie w polu wyszukiwania wysyła zapytania bezpośrednio do ClawHub i dodaje sekcję Z ClawHub z liczbą pobrań oraz odznakami weryfikacji źródła.

Dołączone pluginy nie wymagają instalowania pakietu. Ich działaniem w menu jest Włącz lub Wyłącz. Na przykład Workboard jest dołączony do OpenClaw i domyślnie wyłączony, dlatego należy wybrać Włącz, aby go uruchomić. Pluginów dołączonych nie można usuwać, a jedynie wyłączać.

Dostęp do katalogu i wyszukiwania wymaga operator.read. Instalowanie, włączanie, wyłączanie, usuwanie i zmiany serwerów MCP wymagają operator.admin. Instalację z ClawHub wykonuje Gateway, zachowując kontrole zasad zaufania, integralności i instalowania pluginów. Włączenie zainstalowanego pluginu przez administratora również rejestruje to jawne zaufanie przez dodanie wybranego pluginu do istniejącej restrykcyjnej listy plugins.allow. Jawny wpis plugins.deny pozostaje nadrzędny i należy go usunąć przed włączeniem pluginu.

Zainstalowanie lub usunięcie kodu pluginu wymaga ponownego uruchomienia Gateway. Zmiany stanu włączenia można zastosować bez ponownego uruchomienia, jeśli zainstalowany plugin i bieżące środowisko wykonawcze Gateway to obsługują; w przeciwnym razie interfejs informuje o konieczności ponownego uruchomienia. Konektory MCP korzystające z OAuth nadal wymagają jednorazowego openclaw mcp login <name> w CLI po ich dodaniu.

Control UI nie instaluje z dowolnych źródeł npm, git ani ścieżek lokalnych, nie aktualizuje pluginów ani nie udostępnia rozbudowanej konfiguracji pluginów. Do tych operacji służą opisane poniżej procesy CLI.

Wyświetlanie i wyszukiwanie pluginów

openclaw plugins listopenclaw plugins list --enabledopenclaw plugins list --verboseopenclaw plugins list --jsonopenclaw plugins search "calendar"

--json dla skryptów:

openclaw plugins list --json \  | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'

plugins list to kontrola spisu w stanie zimnym: pokazuje, co OpenClaw może wykryć na podstawie konfiguracji, manifestów i utrwalonego rejestru pluginów. Nie dowodzi, że już uruchomiony Gateway zaimportował środowisko wykonawcze pluginu. Dane wyjściowe JSON zawierają diagnostykę rejestru oraz dependencyStatus każdego pluginu (czy zadeklarowane dependencies/optionalDependencies można odnaleźć na dysku).

plugins search wysyła zapytanie do ClawHub o możliwe do zainstalowania pakiety pluginów i wyświetla wskazówkę instalacji (openclaw plugins install clawhub:<package>) przy każdym wyniku.

Włączanie i wyłączanie pluginów

openclaw plugins enable <plugin-id>openclaw plugins disable <plugin-id>

Przełącza wpis konfiguracji pluginu bez modyfikowania zainstalowanych plików. Niektóre dołączone pluginy (dołączeni dostawcy modeli/mowy oraz dołączony plugin przeglądarki) są domyślnie włączone; inne wymagają enable po instalacji.

Instalowanie pluginów

# Wyszukaj pakiety pluginów w ClawHub.openclaw plugins search "calendar" # Zainstaluj z ClawHub.openclaw plugins install clawhub:<package>openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@beta # Zainstaluj z npm.openclaw plugins install npm:<package>openclaw plugins install npm:@scope/[email protected]openclaw plugins install npm:@openclaw/codex # Zainstaluj z lokalnego artefaktu npm-pack.openclaw plugins install npm-pack:<path.tgz> # Zainstaluj z git lub lokalnej kopii roboczej używanej do programowania.openclaw plugins install git:github.com/acme/[email protected]openclaw plugins install ./my-pluginopenclaw plugins install --link ./my-plugin

Specyfikacje pakietów bez prefiksu są instalowane z npm podczas przejścia uruchomieniowego, chyba że nazwa odpowiada identyfikatorowi dołączonego lub oficjalnego pluginu — wtedy OpenClaw używa zamiast tego kopii lokalnej/oficjalnej. Aby deterministycznie wybrać źródło, należy użyć clawhub:, npm:, git: lub npm-pack:. Pakiety z dołączonego i oficjalnego katalogu OpenClaw są uznawane za zaufane na równi z pakietami ClawHub. Nowe, dowolne źródła npm, git, lokalne ścieżki/archiwa, npm-pack: lub źródła marketplace wymagają --force w instalacjach nieinteraktywnych po sprawdzeniu źródła i uznaniu go za zaufane.

--force potwierdza źródło inne niż ClawHub bez wyświetlania monitu i w razie potrzeby zastępuje istniejący cel instalacji. Do rutynowych aktualizacji śledzonej instalacji npm, ClawHub lub hook-pack należy zamiast tego użyć openclaw plugins update. W przypadku --link opcja --force jedynie potwierdza źródło; powiązany katalog nie jest kopiowany ani zastępowany.

Ponowne uruchamianie i sprawdzanie

Uruchomiony zarządzany Gateway z włączonym przeładowywaniem konfiguracji automatycznie uruchamia się ponownie po zainstalowaniu, zaktualizowaniu lub odinstalowaniu kodu pluginu. Jeśli Gateway nie jest zarządzany lub przeładowywanie jest wyłączone, przed sprawdzeniem aktywnych powierzchni środowiska wykonawczego należy uruchomić go ponownie ręcznie:

openclaw gateway restartopenclaw plugins inspect <plugin-id> --runtime --json

inspect --runtime ładuje moduł pluginu i dowodzi, że zarejestrował on powierzchnie środowiska wykonawczego (narzędzia, hooki, usługi, metody Gateway, trasy HTTP, polecenia CLI należące do pluginu). Zwykłe inspect i list wykonują jedynie kontrole manifestu, konfiguracji i rejestru w stanie zimnym.

Aktualizowanie pluginów

openclaw plugins update <plugin-id>openclaw plugins update <npm-package-or-spec>openclaw plugins update --allopenclaw plugins update <plugin-id> --dry-run

Przekazanie identyfikatora pluginu powoduje ponowne użycie jego śledzonej specyfikacji instalacji: zapisane znaczniki dist-tag (@beta) oraz dokładnie przypięte wersje są zachowywane podczas kolejnych uruchomień update <plugin-id>.

openclaw plugins update --all to ścieżka zbiorczej konserwacji. Nadal respektuje zwykłe śledzone specyfikacje instalacji, ale rekordy zaufanych oficjalnych pluginów OpenClaw są synchronizowane z bieżącym celem oficjalnego katalogu, zamiast pozostawać przypięte do nieaktualnego, dokładnie określonego oficjalnego pakietu; gdy update.channel ma wartość beta, synchronizacja preferuje linię wydań beta. Aby zachować dokładną lub oznaczoną specyfikację oficjalną bez zmian, należy użyć ukierunkowanego update <plugin-id>.

W przypadku instalacji npm należy przekazać jawną specyfikację pakietu, aby zmienić śledzony rekord:

openclaw plugins update @scope/openclaw-plugin@betaopenclaw plugins update @scope/openclaw-plugin

Drugie polecenie przenosi plugin z powrotem do domyślnej linii wydań rejestru, jeśli wcześniej był przypięty do dokładnej wersji lub znacznika.

Dokładne reguły mechanizmu awaryjnego i przypinania zawiera openclaw plugins.

Odinstalowywanie pluginów

openclaw plugins uninstall <plugin-id> --dry-runopenclaw plugins uninstall <plugin-id>openclaw plugins uninstall <plugin-id> --keep-files

Odinstalowanie usuwa wpis konfiguracji pluginu, utrwalony rekord indeksu pluginów, wpisy list zezwalających/odmawiających oraz powiązane wpisy plugins.load.paths, jeśli mają zastosowanie. Zarządzany katalog instalacyjny jest usuwany, chyba że zostanie przekazane --keep-files. Uruchomiony zarządzany Gateway automatycznie uruchamia się ponownie, gdy odinstalowanie zmienia źródło pluginu.

W trybie Nix (OPENCLAW_NIX_MODE=1) instalowanie, aktualizowanie, odinstalowywanie, włączanie i wyłączanie pluginów jest wyłączone; tymi ustawieniami należy zarządzać w źródle Nix danej instalacji.

Wybieranie źródła

Zarządzane instalacje ze ścieżek lokalnych muszą wskazywać katalogi pluginów lub archiwa. Samodzielne pliki pluginów należy umieszczać w plugins.load.paths, zamiast instalować je za pomocą plugins install.

Publikowanie pluginów

ClawHub jest główną publiczną powierzchnią wyszukiwania pluginów OpenClaw. Należy publikować w nim, jeśli użytkownicy mają znajdować metadane pluginu, historię wersji, wyniki skanowania rejestru oraz wskazówki instalacji przed zainstalowaniem.

npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/[email protected]

Natywne pluginy npm przed publikacją muszą zawierać manifest pluginu (openclaw.plugin.json) oraz metadane package.json:

{  "name": "@acme/openclaw-plugin",  "version": "1.0.0",  "type": "module",  "openclaw": {    "extensions": ["./dist/index.js"]  }}

npm publish --access publicopenclaw plugins install npm:@acme/openclaw-pluginopenclaw plugins install npm:@acme/openclaw-plugin@betaopenclaw plugins install npm:@acme/[email protected]

Pełny opis umowy publikowania znajduje się na poniższych stronach; ta strona nie powinna służyć jako dokumentacja referencyjna publikowania:

• Publikowanie w ClawHub wyjaśnia właścicieli, zakresy, wydania, przegląd, walidację pakietów i przenoszenie pakietów.
• Tworzenie pluginów przedstawia pełną strukturę pakietu pluginu (w tym openclaw.plugin.json) oraz proces pierwszej publikacji.
• Manifest pluginu definiuje pola natywnego manifestu pluginu.

Jeśli ten sam pakiet jest dostępny zarówno w ClawHub, jak i npm, należy użyć jawnego prefiksu clawhub: lub npm:, aby wymusić jedno źródło.

Powiązane

• Pluginy — instalowanie, konfigurowanie, ponowne uruchamianie i rozwiązywanie problemów
• openclaw plugins — pełna dokumentacja CLI
• Pluginy społeczności — publiczne wyszukiwanie i publikowanie w ClawHub
• ClawHub — operacje CLI rejestru
• Tworzenie pluginów — tworzenie pakietu pluginu
• Manifest pluginu — manifest i metadane pakietu