Przejdź do głównej treści

openclaw plugins

Zarządzaj wtyczkami/rozszerzeniami Gateway (ładowanymi w procesie). Powiązane:

Polecenia

openclaw plugins list
openclaw plugins info <id>
openclaw plugins enable <id>
openclaw plugins disable <id>
openclaw plugins doctor
openclaw plugins update <id>
openclaw plugins update --all
Dołączone wtyczki są dostarczane z OpenClaw, ale startują jako wyłączone. Użyj plugins enable, aby je aktywować. Wszystkie wtyczki muszą dostarczać plik openclaw.plugin.json z osadzonym schematem JSON (configSchema, nawet jeśli pusty). Brakujące lub nieprawidłowe manifesty albo schematy uniemożliwiają załadowanie wtyczki i powodują niepowodzenie walidacji konfiguracji.

Instalacja

openclaw plugins install <path-or-spec>
Uwaga dotycząca bezpieczeństwa: traktuj instalacje wtyczek jak uruchamianie kodu. Preferuj przypięte wersje. Specyfikacje npm są wyłącznie z rejestru (nazwa pakietu + opcjonalna wersja/tag). Specyfikacje Git/URL/plik są odrzucane. Instalacje zależności są uruchamiane z --ignore-scripts dla bezpieczeństwa. Obsługiwane archiwa: .zip, .tgz, .tar.gz, .tar. Użyj --link, aby uniknąć kopiowania lokalnego katalogu (dodaje do plugins.load.paths):
openclaw plugins install -l ./my-plugin

Odinstaluj

openclaw plugins uninstall <id>
openclaw plugins uninstall <id> --dry-run
openclaw plugins uninstall <id> --keep-files
uninstall usuwa wpisy wtyczki z plugins.entries, plugins.installs, listy dozwolonych wtyczek oraz powiązane wpisy plugins.load.paths, jeśli dotyczy. W przypadku aktywnych wtyczek pamięci slot pamięci zostaje zresetowany do memory-core. Domyślnie odinstalowanie usuwa również katalog instalacyjny wtyczki w aktywnym katalogu stanu w katalogu głównym rozszerzeń ($OPENCLAW_STATE_DIR/extensions/<id>). Użyj --keep-files, aby zachować pliki na dysku. --keep-config jest obsługiwane jako przestarzały alias dla --keep-files.

Aktualizacja

openclaw plugins update <id>
openclaw plugins update --all
openclaw plugins update <id> --dry-run
Aktualizacje dotyczą wyłącznie wtyczek zainstalowanych z npm (śledzonych w plugins.installs).