Команды CLI

plugins

Управление плагинами/расширениями шлюза (загружаемыми внутри процесса). Связанные темы:

Система плагинов: Плагины
Манифест и схема плагина: Манифест плагина
Усиление безопасности: Безопасность

Команды

openclaw plugins list
openclaw plugins info <id>
openclaw plugins enable <id>
openclaw plugins disable <id>
openclaw plugins uninstall <id>
openclaw plugins doctor
openclaw plugins update <id>
openclaw plugins update --all

Встроенные плагины поставляются с OpenClaw, но изначально отключены. Используйте plugins enable для их активации. Все плагины должны содержать файл openclaw.plugin.json со встроенной JSON-схемой (configSchema, даже если она пуста). Отсутствующие или невалидные манифесты или схемы препятствуют загрузке плагина и приводят к сбою проверки конфигурации.

Установка

openclaw plugins install <path-or-spec>
openclaw plugins install <npm-spec> --pin

Примечание по безопасности: относитесь к установке плагинов как к запуску кода. Предпочитайте закрепленные версии. Спецификации Npm работают только с реестром (имя пакета + опционально точная версия или дистрибутивный тег). Спецификации Git, URL, файлов и диапазоны semver отклоняются. Установка зависимостей выполняется с флагом --ignore-scripts для безопасности. "Голые" спецификации и @latest остаются на стабильном треке. Если npm разрешает любую из них в пререлиз, OpenClaw останавливается и просит вас явно согласиться, указав пререлизный тег, например @beta/@rc, или точную пререлизную версию, например @1.2.3-beta.4. Если "голая" спецификация установки совпадает с идентификатором встроенного плагина (например, diffs), OpenClaw устанавливает встроенный плагин напрямую. Чтобы установить npm-пакет с таким же именем, используйте явную спецификацию с областью видимости (например, @scope/diffs). Поддерживаемые архивы: .zip, .tgz, .tar.gz, .tar. Используйте --link, чтобы избежать копирования локальной директории (добавляет в plugins.load.paths):

openclaw plugins install -l ./my-plugin

Используйте --pin при установке из npm, чтобы сохранить разрешенную точную спецификацию (name@version) в plugins.installs, сохраняя при этом поведение по умолчанию без закрепления.

Удаление

openclaw plugins uninstall <id>
openclaw plugins uninstall <id> --dry-run
openclaw plugins uninstall <id> --keep-files

uninstall удаляет записи о плагинах из plugins.entries, plugins.installs, списка разрешенных плагинов и связанных записей plugins.load.paths, где это применимо. Для активных плагинов памяти слот памяти сбрасывается на memory-core. По умолчанию удаление также стирает директорию установки плагина в корне расширений активного состояния ($OPENCLAW_STATE_DIR/extensions/<id>). Используйте --keep-files, чтобы оставить файлы на диске. --keep-config поддерживается как устаревший аналог --keep-files.

Обновление

openclaw plugins update <id>
openclaw plugins update --all
openclaw plugins update <id> --dry-run

Обновления применяются только к плагинам, установленным из npm (отслеживаемым в plugins.installs). Когда сохраненный хеш целостности существует и хеш полученного артефакта изменяется, OpenClaw выводит предупреждение и запрашивает подтверждение перед продолжением. Используйте глобальный флаг --yes, чтобы обойти запросы в CI/неинтерактивных запусках.

pairing qr