Управление плагинами

Используйте эту страницу для распространенных команд управления Plugin. Полный контракт команд, флаги, правила выбора источника и пограничные случаи см. в openclaw plugins.

Большинство рабочих процессов установки выглядят так:

1. найдите пакет
2. установите его из ClawHub, npm, git или локального пути
3. позвольте управляемому Gateway автоматически перезапуститься или перезапустите его вручную, если он не управляется
4. проверьте runtime-регистрации Plugin

Список и поиск Plugin

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

Используйте --json для скриптов:

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

plugins list — это холодная проверка инвентаря. Она показывает, что OpenClaw может обнаружить из конфигурации, манифестов и реестра Plugin; она не доказывает, что уже запущенный Gateway импортировал runtime Plugin. Вывод JSON включает диагностику реестра и статический dependencyStatus каждого Plugin, когда пакет Plugin объявляет dependencies или optionalDependencies.

plugins search запрашивает ClawHub для устанавливаемых пакетов Plugin и выводит подсказки по установке, например openclaw plugins install clawhub:<package>.

Установка Plugin

# Search ClawHub for plugin packages.openclaw plugins search "calendar" # Install from ClawHub.openclaw plugins install clawhub:<package>openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@beta # Install from npm.openclaw plugins install npm:<package>openclaw plugins install npm:@scope/openclaw-plugin@1.2.3openclaw plugins install npm:@openclaw/codex # Install from a local npm pack artifact.openclaw plugins install npm-pack:<path.tgz> # Install from git or a local development checkout.openclaw plugins install git:github.com/acme/openclaw-plugin@v1.0.0openclaw plugins install ./my-pluginopenclaw plugins install --link ./my-plugin

Голые спецификации пакетов во время launch cutover устанавливаются из npm. Используйте clawhub:, npm:, git: или npm-pack:, когда вам нужен детерминированный выбор источника. Если голое имя совпадает с идентификатором официального Plugin, OpenClaw может установить запись каталога напрямую.

Используйте --force только когда вы намеренно хотите перезаписать существующую цель установки. Для обычных обновлений отслеживаемых установок npm, ClawHub или hook-pack используйте openclaw plugins update.

Перезапуск и проверка

После установки, обновления или удаления кода Plugin запущенный управляемый Gateway с включенной перезагрузкой конфигурации перезапускается автоматически. Если Gateway не управляется или перезагрузка отключена, перезапустите его самостоятельно перед проверкой живых runtime-поверхностей:

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

Используйте inspect --runtime, когда вам нужно доказательство, что Plugin зарегистрировал runtime-поверхности, такие как инструменты, hooks, сервисы, методы Gateway, HTTP-маршруты или принадлежащие Plugin команды CLI. Обычные inspect и list — это холодные проверки манифеста, конфигурации и реестра.

Обновление Plugin

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

Когда вы передаете идентификатор Plugin, OpenClaw повторно использует отслеживаемую спецификацию установки. Сохраненные dist-tags, такие как @beta, и точные закрепленные версии продолжают использоваться при последующих запусках update <plugin-id>.

openclaw plugins update --all — это путь массового обслуживания. Он по-прежнему учитывает обычные отслеживаемые спецификации установки, но доверенные официальные записи Plugin OpenClaw могут синхронизироваться с текущей целью официального каталога вместо того, чтобы оставаться на устаревшем точном официальном пакете. Если update.channel установлен в beta, такая массовая официальная синхронизация использует контекст beta-канала. Используйте целевой update <plugin-id>, когда намеренно хотите оставить точную или помеченную официальную спецификацию без изменений.

Для установок npm можно передать явную спецификацию пакета, чтобы переключить отслеживаемую запись:

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

Вторая команда возвращает Plugin к стандартной release-линии реестра, если ранее он был закреплен на точной версии или теге.

Когда openclaw update выполняется на beta-канале, записи Plugin могут предпочитать соответствующие выпуски @beta. Точные правила fallback и закрепления см. в openclaw plugins.

Удаление Plugin

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

Удаление удаляет запись конфигурации Plugin, сохраненную индексную запись Plugin, записи списков разрешений/запретов и связанные пути загрузки, где применимо. Управляемые каталоги установки удаляются, если вы не передаете --keep-files. Запущенный управляемый Gateway автоматически перезапускается, когда удаление меняет источник Plugin.

В режиме Nix (OPENCLAW_NIX_MODE=1) команды установки, обновления, удаления, включения и отключения Plugin отключены. Управляйте этими вариантами в Nix-источнике установки.

Выбор источника

Управляемые установки из локального пути должны быть каталогами или архивами Plugin. Помещайте отдельные файлы Plugin в plugins.load.paths вместо их установки через plugins install.

Публикация Plugin

ClawHub — основная публичная поверхность обнаружения для Plugin OpenClaw. Публикуйте там, когда хотите, чтобы пользователи находили метаданные Plugin, историю версий, результаты сканирования реестра и подсказки по установке до установки.

npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/your-plugin@v1.0.0

Нативные npm Plugin должны включать манифест Plugin и метаданные пакета перед публикацией:

{  "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/openclaw-plugin@1.0.0

Используйте эти страницы как полный контракт публикации, а не считайте эту страницу справочником по публикации:

• Публикация ClawHub объясняет владельцев, scopes, релизы, review, проверку пакетов и передачу пакетов.
• Создание Plugin показывает форму пакета Plugin и первый workflow публикации.
• Манифест Plugin определяет поля манифеста нативного Plugin.

Если один и тот же пакет доступен и в ClawHub, и в npm, используйте явный префикс clawhub: или npm:, когда нужно принудительно выбрать один источник.

Связанные материалы

• Plugins - установка, настройка, перезапуск и устранение неполадок
• openclaw plugins - полный справочник CLI
• Community plugins - публичное обнаружение и публикация в ClawHub
• ClawHub - операции CLI реестра
• Создание Plugin - создание пакета Plugin
• Манифест Plugin - манифест и метаданные пакета