Плагины OpenClaw — установка, управление, bundled-плагины, безопасность | open-claw.su

Плагины — это модульные расширения OpenClaw. Они добавляют новые каналы (Telegram, WhatsApp, Matrix), провайдеры моделей (OpenAI, Anthropic, Ollama), инструменты (веб-поиск, генерация изображений) и многое другое. В этой статье — как работают плагины, какие идут из коробки и как устанавливать новые.

Скиллы vs Плагины: в чём разница

Это частый вопрос, потому что обе системы расширяют возможности OpenClaw, но работают по-разному.

	Скиллы	Плагины
Что это	Markdown-файл с инструкциями	JS/TS-модуль с кодом
Формат	`SKILL.md`	`openclaw.plugin.json` + runtime
Сложность	Простые, декларативные	Программируемые, с SDK
Что делают	Описывают, как агенту решать задачу	Регистрируют каналы, провайдеры, инструменты
Установка	`openclaw skills install`	`openclaw plugins install`
Песочница	Агент выполняет в рамках своих прав	Работают в процессе gateway (без sandboxing)
Кто создаёт	Пользователи, no-code	Разработчики, нужен JS/TS

Скиллы — это инструкции: «когда пользователь попросит сделать X, используй инструмент Y так-то». Скилл не добавляет новые инструменты, он учит агента лучше использовать имеющиеся.

Плагины — это код: они регистрируют новые возможности в системе. Без плагина openai агент не сможет использовать GPT. Без плагина telegram не будет Telegram-канала.

Что идёт из коробки

OpenClaw поставляется с набором bundled-плагинов, которые работают без дополнительной установки:

Провайдеры моделей

Плагин	Что даёт
openai	GPT, Whisper, DALL-E, TTS, realtime voice
anthropic	Claude (текст, медиа, speech)
google	Gemini (текст, изображения, веб-поиск)
xai	Grok (текст, x_search)
qwen	Qwen (текст, медиа, видеогенерация)
mistral	Mistral (текст)
ollama	Локальные модели через Ollama
minimax	MiniMax M2.7 (текст, изображения)

Каналы

Плагин	Мессенджер
telegram	Telegram
whatsapp	WhatsApp
discord	Discord
slack	Slack
msteams	Microsoft Teams
matrix	Matrix/Element
qqbot	QQ Bot

Инструменты и сервисы

Плагин	Что даёт
brave	Brave Search (веб-поиск)
searxng	SearXNG (мета-поиск)
tavily	Tavily (поиск + extract)
exa	Exa (neural search)
perplexity	Perplexity (AI-поиск)
firecrawl	Firecrawl (скрейпинг)
elevenlabs	ElevenLabs (TTS)
microsoft	Microsoft (TTS)
voice-call	Голосовые звонки

Bundled-плагины включаются автоматически при наличии соответствующего API-ключа в конфиге. Некоторые (Telegram, WhatsApp) требуют настройки канала.

Community-плагины

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

Известные community-плагины

Плагин	Что делает
DingTalk	Канал для корпоративного мессенджера DingTalk
WeCom	Канал для WeCom (Tencent) — persistent connection, группы, Markdown
Opik	Мониторинг: экспорт трейсов агента, отслеживание поведения и затрат
Lossless Claw (LCM)	Умное управление контекстом через DAG-суммаризацию
Codex App Server Bridge	Мост между OpenClaw и Codex App Server

Как найти плагины

# Просмотр маркетплейса
openclaw plugins marketplace list clawhub

# Поиск по имени
openclaw plugins install <имя-плагина>

При установке OpenClaw сначала ищет в ClawHub, затем в npm.

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

Из ClawHub или npm

openclaw plugins install <имя-плагина>

С GitHub

openclaw plugins install owner/repo

Из локальной директории

openclaw plugins install /path/to/plugin

Полезные флаги

Флаг	Описание
`--force`	Перезаписать существующую установку
`--pin`	Зафиксировать версию npm-пакета
`--dry-run`	Показать, что будет сделано, без установки

После установки перезапустите gateway:

openclaw gateway restart

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

Просмотр установленных

# Все плагины
openclaw plugins list

# Только включённые
openclaw plugins list --enabled

# Подробная информация
openclaw plugins list --verbose

# JSON-формат (для скриптов)
openclaw plugins list --json

Информация о плагине

openclaw plugins inspect <id>

# Все плагины в виде таблицы
openclaw plugins inspect --all

Включение / отключение

openclaw plugins enable <id>
openclaw plugins disable <id>

Обновление

# Конкретный плагин
openclaw plugins update <id>

# Все плагины
openclaw plugins update --all

# Предпросмотр
openclaw plugins update --all --dry-run

Удаление

openclaw plugins uninstall <id>

# Предпросмотр
openclaw plugins uninstall <id> --dry-run

# Удалить из конфига, но оставить файлы
openclaw plugins uninstall <id> --keep-files

Диагностика

openclaw plugins doctor

Проверяет ошибки загрузки, устаревшие конфигурации, конфликты.

Конфигурация

Плагины настраиваются в ~/.openclaw/openclaw.json в секции plugins:

{
  plugins: {
    enabled: true,  // мастер-переключатель
    allow: ["voice-call"],  // белый список
    deny: ["untrusted-plugin"],  // чёрный список (приоритетнее allow)
    entries: {
      "voice-call": {
        enabled: true,
        config: {
          provider: "twilio"
        }
      }
    }
  }
}

Приоритет загрузки

Явные пути в plugins.load.paths
Workspace-плагины (директория проекта)
Global extensions (~/.openclaw/extensions/)
Bundled-плагины (из пакета OpenClaw)

Правила включения

Bundled-плагины — включены по умолчанию (если есть API-ключ)
Workspace-плагины — отключены по умолчанию (нужно явное allow или enabled: true)
deny всегда приоритетнее allow

Exclusive slots

Некоторые категории допускают только один активный плагин:

{
  plugins: {
    slots: {
      memory: "memory-core",     // только один плагин памяти
      contextEngine: "my-engine" // только один контекстный движок
    }
  }
}

Хуки плагинов

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

before_dispatch

Срабатывает при получении входящего сообщения. Плагин получает метаданные сообщения и может решить, как его обработать. Ответы проходят через стандартный путь доставки с поддержкой TTS и маршрутизации.

before_tool_call

Срабатывает перед выполнением инструмента. Ключевая возможность — requireApproval: плагин может поставить действие на паузу и запросить подтверждение у пользователя через кнопки в Telegram, Discord или команду /approve.

before_agent_reply

Срабатывает перед отправкой ответа LLM. Плагин может подставить синтетический ответ без вызова модели — полезно для шаблонных ответов или inline-действий.

Совместимость с внешними экосистемами

OpenClaw умеет устанавливать плагины из трёх внешних экосистем:

Codex — плагины Codex CLI
Claude — плагины Claude Code
Cursor — плагины Cursor

Они маппятся на нативные возможности OpenClaw. Установка — через стандартный openclaw plugins install.

Безопасность

Плагины работают без песочницы

Нативные плагины выполняются в процессе gateway — они имеют тот же уровень доступа, что и ядро OpenClaw. Устанавливайте только плагины из доверенных источников.

Fail-closed установка

С версии 2026.3.31 плагины с обнаруженным опасным кодом (critical findings) блокируются при установке. Для обхода (на свой риск):

openclaw plugins install <package> --dangerously-force-unsafe-install

Workspace-плагины отключены по умолчанию

Плагины, обнаруженные в workspace (директории проекта), не загружаются автоматически. Это защита от вредоносных плагинов в клонированных репозиториях.

Полезные ссылки

Документация: Plugins — официальный гайд
Plugin CLI — справка по командам
Community Plugins — каталог community-плагинов
Скиллы OpenClaw — гайд по скиллам
Control UI — управление плагинами из браузера
Веб-поиск — провайдеры поиска (bundled-плагины)