Скиллы, плагины и MCP в OpenClaw: как расширить агента и что это стоит
Агент из коробки умеет отвечать на вопросы, читать файлы и выполнять команды в терминале. Интересное начинается, когда к нему подключают то, что нужно именно вам: заметки в Obsidian, умный дом, распознавание голоса, поиск получше DuckDuckGo. Быстро выясняется, что половина таких сценариев упирается в ключ стороннего сервиса, который российской картой не оплатить.
В статье — три механизма расширения OpenClaw, команды установки, рабочие сценарии и расчёт стоимости сборки из нескольких платных зависимостей.
Коротко:
- скилл — markdown-инструкция, плагин — код со скиллами и провайдерами, MCP-сервер — внешний процесс со своими инструментами;
- скилл ставится одной командой: из ClawHub, из Git или из локальной папки;
- порядок из шести уровней папок решает, какой скилл победит при совпадении имени;
- профиль tools.profile может блокировать команду — это настройка, а не поломка;
- чужой скилл стоит проверять командой verify и читать исходник до установки;
- синтез речи, распознавание голоса и расширенный поиск обычно требуют платного ключа.
Скилл, плагин и MCP: в чём разница
Скилл — markdown-инструкция для агента, плагин — код с собственными скиллами и провайдерами, MCP-сервер — внешний процесс со своими инструментами.
Скилл — папка с файлом SKILL.md: YAML-фронтматтер с именем и описанием, дальше обычный markdown-текст, объясняющий, как и когда пользоваться уже существующими у агента инструментами. Сам по себе скилл ничего не умеет, он работает поверх того, что у агента уже есть.
Плагин — расширение с собственным кодом: добавляет каналы связи, провайдеров моделей, инструменты рантайма и заодно может нести свои скиллы, перечисленные в манифесте openclaw.plugin.json.
MCP-сервер — отдельный процесс вне агента, отдающий инструменты по протоколу Model Context Protocol: постоянно работающий сервис, локальный или удалённый по HTTP.
На практике: не хватает workflow — берите скилл, нужен новый канал связи — плагин, нужна внешняя система с собственным протоколом — MCP.
Три механизма расширения решают разные задачи: скилл — сценарий работы, плагин — новый код, MCP-сервер — связь с внешней системой.
Как поставить скилл
Скилл ставится одной командой: из ClawHub, из Git-репозитория или из локальной папки.
ClawHub — официальный публичный реестр, установка по формату @owner/slug. Из Git — по ссылке git:owner/repo@ref, файл SKILL.md должен лежать в корне репозитория. Локальный скилл ставится путём до папки, флаг --as задаёт своё имя вместо указанного в манифесте.
--global устанавливает скилл в общую папку, видимую всем локальным агентам. verify перед установкой запрашивает у ClawHub карточку доверия и завершится с ошибкой при непройденной проверке.
Часть скиллов и встроенных провайдеров сразу требует платного ключа: у синтеза речи через ElevenLabs — ELEVENLABS_API_KEY, у распознавания через Deepgram — DEEPGRAM_API_KEY. Оба включены по умолчанию, нужен только рабочий ключ, что прописано в манифесте, в блоке metadata.openclaw.requires.env. Российская карта для его оплаты обычно не подходит.
Где скиллы лежат и почему один перекрывает другой
Шесть уровней папок решают, какой скилл сработает, если два называются одинаково.
- <workspace>/skills
- <workspace>/.agents/skills
- ~/.agents/skills
- <state-dir>/skills
- встроенные скиллы
- skills.load.extraDirs и скиллы, подключённые плагинами
Приоритет читается сверху вниз: скилл из рабочего пространства побеждает установленный глобально через --global, даже если глобальная версия новее. Отсюда типовая путаница — вы обновили скилл update --all --global, а агент пользуется старой локальной копией с тем же именем. Прежде чем искать поломку, проверьте, нет ли дубликата выше по списку.
Тот же порядок работает и в обратную сторону: положив свою версию чужого скилла в /skills, вы временно переопределяете установленный, не трогая исходник.
Плагины и профили инструментов
Плагины ставятся и включаются отдельными командами, а доступные агенту инструменты ограничивает профиль tools.profile.
Плагин добавляет агенту канал связи, провайдера модели или инструменты рантайма и заодно приносит свои скиллы. Ставится как пакет: из ClawHub, npm или Git-репозитория с веткой или тегом.
Отдельно работает tools.profile — какие инструменты вообще доступны агенту:
- minimal — только проверка состояния сессии;
- messaging — узкий набор для чат-ботов;
- coding — по умолчанию: репозиторий, файлы, командная строка, среда выполнения;
- full — снимает все ограничения.
Если агент отвечает unknown command 'browser' — это не поломка, а следствие plugins.allow: список разрешённых плагинов исключает браузер для этого профиля. Решение — расширить plugins.allow или переключить агента на профиль full.
MCP: когда нужен внешний сервер
MCP-сервер нужен, когда агенту требуется постоянное соединение с внешней системой, у которой уже есть собственный протокол инструментов.
В отличие от скилла MCP-сервер — работающий процесс: локальный, запущенный командой вроде npx, или удалённый по HTTP. Он сам объявляет список инструментов, видимых агенту после подключения.
add принимает флаги для локального процесса — --command, --arg, --env, --cwd — либо для удалённого HTTP-сервера — --url, --transport, --header, --auth oauth. После подключения list и show <имя> показывают, какие инструменты сервер отдал агенту.
Что реально подключают: рабочие сценарии
К OpenClaw подключают заметки, умный дом, автоматизацию и генерацию изображений — все три механизма используются вперемешку.
Obsidian. Скилл работает напрямую с markdown-файлами хранилища через obsidian-cli, изменения сразу видны в самом Obsidian. Публичный скилл есть в ClawHub, ставится install по @owner/slug. Платного сервиса не требует.
Home Assistant. Home Assistant отдаёт REST и WebSocket API, скилл переводит естественный язык в вызовы — включить свет, проверить датчик, запустить сценарий. Нужен долгоживущий токен Home Assistant. Точный слаг скилла стоит проверить прямо в каталоге ClawHub перед установкой — реестр обновляется, и название пакета может смениться.
n8n. Чаще связка, а не готовый скилл: n8n поднимает вебхук, агент обращается к нему как к HTTP-инструменту или через подключённый MCP-сервер. Единого официального пакета для этого сценария на момент проверки нет — интеграция каждый раз собирается вручную, через вебхук или MCP.
Браузер. Встроенный инструмент, а не скилл: изолированный профиль Chromium под гейтвеем, доступность зависит от tools.profile, платного сервиса не требует.
Память. Тоже встроена, хранится markdown-файлами — MEMORY.md для устойчивых фактов, дневные логи в memory/YYYY-MM-DD.md. Читается через memory_search и memory_get, ключ не нужен.
ComfyUI. Публичные скиллы превращают собранный workflow в вызываемую команду. Платный сервис не обязателен, но нужен собственный сервер с видеокартой.
Часть сценариев — Obsidian, память, браузер — не стоит ни рубля сверх самого агента. Деньги нужны там, где задача упирается в облачный сервис: озвучку, распознавание речи или поиск лучше базового.
Три отдельных платежа за сборку обходятся дороже одного перевода на ту же сумму — разница уходит в комиссию.
Сколько стоит собрать полезную сборку
У сборки из нескольких скиллов почти всегда несколько разных счетов, и это можно свести к одному расчёту.
Допустим, нужны три платных сервиса под три скилла: ElevenLabs на $5 для озвучки, Deepgram на $10 для распознавания голоса и поисковый API на $20 для качественного web_search. По курсу на 13 августа 2026 года (доллар 96 ₽) и комиссии лесенкой с сайта:
- $5 → 480 ₽, до 999 ₽ — комиссия фиксированная 350 ₽, к оплате 830 ₽;
- $10 → 960 ₽, тоже до 999 ₽ — ещё 350 ₽, к оплате 1 310 ₽;
- $20 → 1 920 ₽, диапазон 1 000–2 999 ₽ — комиссия 32% (614 ₽), к оплате 2 534 ₽.
Тремя платежами сборка обойдётся в 4 674 ₽. Одним переводом на $35 (3 360 ₽) сумма попадает в диапазон 3 000–4 999 ₽ с комиссией 27% (907 ₽), итого 4 267 ₽. Экономия — 407 ₽, почти десятая часть суммы, поэтому мелкие пополнения по отдельности обычно невыгодны.
Тот же принцип — с предоплаченной картой: одна карта с нужным балансом закрывает все три сервиса вместо отдельного способа оплаты под каждый.
Безопасность: что проверять до установки
Скилл — это инструкция для агента, у которого уже есть доступ к файлам и командной строке, и это стоит держать в голове до установки, а не после.
Перед установкой чужого скилла стоит прогнать openclaw skills verify @owner/ — команда запрашивает у ClawHub карточку доверия и завершится с ошибкой при непройденной проверке. Это не гарантия, а первый фильтр: дальше стоит прочитать SKILL.md и посмотреть секцию requires в манифесте — какие бинарники и переменные окружения он запрашивает. Если это явно лишнее для задачи, повод насторожиться.
Флаг --global стоит использовать осторожно: он открывает скилл всем локальным агентам, а не только тестовому пространству. Для непроверенных скиллов разумнее временно понижать профиль.
Частые вопросы
Чем скилл отличается от плагина?
Скилл — markdown-инструкция, которая учит агента пользоваться уже существующими инструментами. Плагин — код, добавляющий каналы связи, провайдеров и инструменты, и заодно способный нести свои скиллы через openclaw.plugin.json.
Что такое MCP-сервер простыми словами?
Отдельный процесс, локальный или удалённый по HTTP, отдающий агенту свои инструменты по протоколу Model Context Protocol — не текст-инструкция, а сервис.
Где взять готовые скиллы?
Основной источник — реестр ClawHub, установка командой openclaw skills install @owner/. Ставятся и из Git-репозитория, и из локальной папки.
Почему установленный скилл не работает?
Чаще всего дело в порядке загрузки: локальная копия в /skills перекрывает обновлённую глобальную версию с тем же именем.
Нужен ли платный ключ для скиллов?
Не всегда: заметки, память и браузер ключа не требуют. Синтез речи, распознавание голоса и расширенный поиск обычно завязаны на платный API.
Можно ли подключить OpenClaw к Home Assistant?
Да, через скилл, обращающийся к REST и WebSocket API по долгоживущему токену — платного стороннего сервиса связка не требует.
Безопасно ли ставить чужие скиллы?
Стоит прогнать openclaw skills verify и прочитать SKILL.md — обычный markdown, не исполняемый код. Непроверенные скиллы разумнее ставить не глобально и с урезанным профилем.
Порядок действий: выбрать сценарий, проверить скилл командой verify, поставить его, выдать ключ там, где он нужен, и проверить результат в работе. Отдельный ключ почти всегда означает отдельный платёж, и именно на этом шаге чаще всего встаёт российская карта.
Список сервисов на сайте «Оплата Забугор» не закрытый. Если нужного сервиса для вашего скилла в нём пока нет — это не препятствие: напишите, что именно нужно оплатить, и мы посчитаем стоимость и оплатим.