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

В Control UI реализован типовой рабочий процесс поиска, установки, включения и отключения плагинов. CLI также поддерживает обновление, удаление, расширенную настройку и явное управление источником установки. Полное описание команд, флагов, правил выбора источника и особых случаев см. в разделе openclaw plugins.

Типовой рабочий процесс в CLI: найти пакет, установить его из ClawHub, npm, git или по локальному пути, дождаться автоматического перезапуска управляемого Gateway (либо перезапустить его вручную), а затем проверить регистрации плагина в среде выполнения.

Использование Control UI

Откройте Плагины в Control UI или используйте /settings/plugins относительно настроенного базового пути Control UI. Например, для базового пути /openclaw используется /openclaw/settings/plugins. На странице есть две вкладки:

• Установленные — полный список локальных объектов, сгруппированных по категориям (каналы, поставщики моделей, память, инструменты). Каждая строка открывает подробное представление; меню дополнительных действий (…) позволяет включить или отключить плагин, а для установленных извне плагинов также предлагает действие Удалить. На вкладке также перечислены настроенные серверы MCP с такими же доступными через меню действиями включения, отключения и удаления, изменяющими mcp.servers в конфигурации Gateway.
• Обзор — магазин с избранными плагинами, входящими в OpenClaw, официальными внешними плагинами и подобранной коллекцией коннекторов. Карточки коннекторов либо добавляют размещённый сервер MCP одним нажатием (GitHub, Notion, Linear, Sentry, Home Assistant), либо открывают поиск в ClawHub с предварительно заполненным запросом. При вводе в поле поиска выполняется встроенный запрос к ClawHub, а также добавляется раздел Из ClawHub с количеством скачиваний и значками проверки источника.

Входящие в комплект плагины не требуют установки пакета. В их меню доступно действие Включить или Отключить. Например, Workboard входит в OpenClaw и по умолчанию отключён, поэтому для его активации выберите Включить. Встроенные плагины нельзя удалить — их можно только отключить.

Для доступа к каталогу и поиску требуется operator.read. Для установки, включения, отключения, удаления и изменения серверов MCP требуется operator.admin. Установка из ClawHub выполняется Gateway с сохранением проверок доверия, целостности и политики установки плагинов. Включение установленного плагина администратором также фиксирует явное доверие: выбранный плагин добавляется в существующий ограничивающий список plugins.allow. Явная запись plugins.deny остаётся приоритетной, и перед включением плагина её необходимо удалить.

После установки или удаления кода плагина требуется перезапуск Gateway. Изменения состояния включения можно применить без перезапуска, если установленный плагин и текущая среда выполнения Gateway это поддерживают; в противном случае UI сообщает о необходимости перезапуска. Для коннекторов MCP на основе OAuth после добавления всё равно требуется однократно выполнить openclaw mcp login <name> в CLI.

Control UI не устанавливает плагины из произвольных источников npm, git или локальных путей, не обновляет плагины и не предоставляет расширенную настройку плагинов. Для этих операций используйте описанные ниже рабочие процессы CLI.

Просмотр и поиск плагинов

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 может обнаружить по конфигурации, манифестам и сохранённому реестру плагинов. Эта проверка не подтверждает, что уже запущенный Gateway импортировал среду выполнения плагина. Вывод JSON содержит диагностику реестра и значение dependencyStatus каждого плагина (разрешаются ли объявленные dependencies/optionalDependencies на диске).

plugins search запрашивает в ClawHub доступные для установки пакеты плагинов и выводит для каждого результата подсказку по установке (openclaw plugins install clawhub:<package>).

Включение и отключение плагинов

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

Переключает запись плагина в конфигурации, не затрагивая установленные файлы. Некоторые встроенные плагины (встроенные поставщики моделей и синтеза речи, встроенный плагин браузера) включены по умолчанию; для остальных после установки требуется enable.

Установка плагинов

# Поиск пакетов плагинов в ClawHub.openclaw plugins search "calendar" # Установка из ClawHub.openclaw plugins install clawhub:<package>openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@beta # Установка из npm.openclaw plugins install npm:<package>openclaw plugins install npm:@scope/[email protected]openclaw plugins install npm:@openclaw/codex # Установка из локального артефакта npm-pack.openclaw plugins install npm-pack:<path.tgz> # Установка из git или локальной рабочей копии для разработки.openclaw plugins install git:github.com/acme/[email protected]openclaw plugins install ./my-pluginopenclaw plugins install --link ./my-plugin

Во время переходного периода запуска спецификации пакетов без префикса устанавливаются из npm, если имя не совпадает с идентификатором встроенного или официального плагина — в таком случае OpenClaw вместо этого использует соответствующую локальную или официальную копию. Для детерминированного выбора источника используйте clawhub:, npm:, git: или npm-pack:. Пакеты из встроенного и официального каталогов OpenClaw считаются доверенными наряду с пакетами ClawHub. Для новых произвольных источников npm, git, локальных путей или архивов, npm-pack: либо маркетплейсов при неинтерактивной установке требуется --force после проверки источника и подтверждения доверия к нему.

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

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

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

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

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

Обновление плагинов

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

При передаче идентификатора плагина повторно используется его отслеживаемая спецификация установки: сохранённые dist-теги (@beta) и точно закреплённые версии переносятся в последующие запуски update <plugin-id>.

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

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

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

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

Точные правила резервного выбора и закрепления версий см. в разделе openclaw plugins.

Удаление плагинов

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

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

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

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

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

Публикация плагинов

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

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]

Перед публикацией нативные плагины npm должны содержать манифест плагина (openclaw.plugin.json) и метаданные 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]

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

• Публикация в ClawHub описывает владельцев, области, выпуски, проверку, валидацию пакетов и передачу пакетов.
• Создание плагинов показывает полную структуру пакета плагина (включая openclaw.plugin.json) и рабочий процесс первой публикации.
• Манифест плагина определяет поля нативного манифеста плагина.

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

Связанные разделы

• Плагины — установка, настройка, перезапуск и устранение неполадок
• openclaw plugins — полный справочник CLI
• Плагины сообщества — общедоступный поиск и публикация в ClawHub
• ClawHub — операции CLI с реестром
• Создание плагинов — создание пакета плагина
• Манифест плагина — манифест и метаданные пакета