OpenClaw 2026.10.3: как ставить и обновлять плагины

Коротко

openclaw plugins install ставит плагин из ClawHub, npm, git или локального пути. При работающем Gateway изменения применяются без перезапуска.
Перед установкой OpenClaw сверяет openclaw.compat.pluginApi и openclaw.install.minHostVersion с вашей сборкой. Для неппинованных npm-версий берётся самый новый совместимый пакет.
openclaw plugins update повторяет выбранный источник и применяет починки Doctor.
Сторонние npm-, git-, архивные и локальные источники требуют --force в неинтерактивном режиме. --force не обходит security.installPolicy и хук before_install.

Сверено с документацией OpenClaw 2026.10.3, 15 октября 2026.

Плагины в OpenClaw расширяют Gateway каналами, провайдерами моделей, инструментами и навыками. Поставить их можно командой openclaw plugins install, обновить через plugins update. Ниже по шагам: выбор источника, проверка совместимости и типичные ошибки.

Установка: источники и локаторы

Сначала найдите плагин в ClawHub — это основной каталог для поиска плагинов. Затем выберите источник. Для продакшена берите пины, чтобы получить воспроизводимую сборку.

openclaw plugins search "calendar"
openclaw plugins install clawhub:<package>
openclaw plugins install npm:<package>
openclaw plugins install git:github.com/<owner>/<repo>@<ref>
openclaw plugins install ./my-plugin
openclaw plugins install --link ./my-plugin

ClawHub и встроенный каталог OpenClaw считаются доверенными источниками. Новые произвольные npm-, git-, архивные и локальные источники требуют --force в неинтерактивном режиме после вашего ревью. Голый @openclaw/*, совпадающий со встроенным плагином, возьмёт встроенную копию. Используйте npm:@openclaw/<plugin>@<version>, чтобы явно запросить внешний пакет.

Включение и применение без перезапуска

После установки настройте параметры плагина в plugins.entries.<id>.config и включите его. Если задан plugins.allow, id плагина должен попасть в этот список. install сам добавляет его туда и убирает из plugins.deny. При работающем Gateway команды install, enable и update применяются без перезапуска.

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

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

Проверка версии и совместимости

OpenClaw сверяет заявленные плагином openclaw.compat.pluginApi и openclaw.install.minHostVersion с вашей сборкой ещё до установки. Для неппинованных npm-спецификаций и @latest берётся самый новый совместимый пакет. Если текущий @latest не подходит, сканируются более старые стабильные версии. Точные версии и явные теги вроде @beta остаются привязанными и падают при несовместимости.

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

openclaw plugins doctor
openclaw plugins list
openclaw update status

Обновление и пины

update повторяет источник, выбранный при установке, и не требует повторного подтверждения источника. Совместимые официальные npm-плагины OpenClaw с селектором bare или latest следуют релизной когорте вашего хоста. Явная версия или тег в команде побеждают. Перед активацией замены применяются починки Doctor, поэтому настройки вроде вебхука сохраняются.

openclaw plugins update <ids-or-npm-specs...>
openclaw plugins update --all
openclaw plugins install <package> --pin
openclaw plugins install npm:@openclaw/discord@2026.5.20

Если финализация обновления упала, в отчёте сначала идёт исходная причина, а сбои отката идут отдельным диагностическим контекстом. Уже откаченный или зафиксированный инсталл повторно не применяется.

Частые ошибки

--force не обходит security.installPolicy и хук before_install. Предупреждения политики всё равно надо подтверждать через --acknowledge-install-policy-warning или Install anyway в Control UI.
Плагин включён в plugins.entries, но не загружается. Проверьте plugins.allow: это белый список. Инструменты плагина вне него остаются недоступны даже при tools.allow с "*".
Связанный локально плагин (--link) не получает доверие официального пакета. Каналы с требованием доверенного состояния блокируют его на старте, и doctor покажет причину.
В режиме Nix (OPENCLAW_NIX_MODE=1) команды install, update, uninstall, enable, disable отказываются работать. Правьте programs.openclaw.config в Nix-источнике и пересобирайте.
Плагин установлен, но хук молчит. inspect без --runtime проверяет только манифест. Прогоните реальное событие или вызов инструмента на работающем Gateway.