OpenClaw: установка и подключение моделей через Relay
OpenClaw это открытый персональный ассистент, который подключается к мессенджерам вроде Slack, Discord и Telegram (а также Feishu и WeChat) и расширяется навыками. Сама модель в него не встроена: нужен провайдер, и Relay подключается к OpenClaw как обычный совместимый адрес. Ниже установка, шаги мастера с точными ответами, настройка ключа с лимитом и то, что стоит знать о безопасности агента, которому разрешили трогать систему.
Коротко
OpenClaw ставится одной командой, дальше мастер
openclaw onboard --install-daemonпроводит по настройке.Relay вводится как Custom Provider: адрес
https://relay-llm.ru/v1, ключ из консоли и тип OpenAI-compatible, для моделей Claude нужен Anthropic-compatible.Агент делает много запросов подряд, поэтому заведите для него отдельный ключ с суточным лимитом.
Ассистента с доступом к системе держите подальше от рабочих данных, а чужие навыки сначала читайте.
Установка
Перед подключением Relay обновите OpenClaw до последней версии: на старых версиях возможны проблемы совместимости, предупреждает страница интеграции.
Руководство Relay предлагает скрипт установки с сайта OpenClaw: один для Linux и macOS (запускается в bash), другой для Windows (PowerShell). Скрипт такого вида исполняет скачанный код целиком. Не хотите так рисковать, поставьте через npm: по сведениям нашего источника на 29 октября 2026, этот путь тоже поддерживается, нужен Node.js версии 24.16 или новее.
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemonПосле первой установки мастер настройки запускается сам. Если OpenClaw уже стоял, вернуться в него можно второй командой из блока выше.
По описанию в документации проекта (мы опираемся на сведения источника на 29 октября 2026), после мастера Gateway можно оставить работать фоновой службой. Для этого и для диагностики есть команды:
openclaw gateway install
openclaw gateway status
openclaw doctorПервая ставит службу, вторая показывает состояние, третья ищет проблемы в конфигурации.
Подключение Relay в мастере
Ответы мастера на странице Relay
- Подтвердите режим
На вопрос про personal-by-default и lock-down для общего использования ответьте Yes. В Setup mode выберите QuickStart.
- Выберите провайдера
В Model/auth provider выберите More, введите
custom, чтобы отфильтровать список, и выберите Custom Provider («Any OpenAI or Anthropic compatible endpoint»). - Укажите адрес и ключ
В API Base URL введите
https://relay-llm.ru/v1. На вопрос о способе передачи ключа выберите Paste API key now и вставьте ключ из консоли Relay. - Выберите тип и модель
В Endpoint compatibility задайте тип по семейству модели (таблица ниже). В Model ID введите идентификатор из каталога, например
claude-haiku-5.5. - Дождитесь проверки
Когда появится Verification successful, Relay подключён. Если мастер спросит API Compatibility, выберите openai. Остальные каналы и навыки можно настроить позже.
| Семейство | Тип в мастере | Примеры идентификаторов |
|---|---|---|
| GPT | OpenAI-compatible | gpt-6.1-sol, gpt-6-astra, gpt-5.6-luna |
| Gemini | OpenAI-compatible | gemini-3.1-pro |
| DeepSeek | OpenAI-compatible | deepseek-v4.1-flash |
| GLM и Grok | OpenAI-compatible | glm-5.3, grok-4.5 |
| Claude | Anthropic-compatible | claude-haiku-5.5, claude-opus-5 |
Для Anthropic-compatible варианта адрес другой: клиентам Anthropic Relay предлагает базовый адрес https://relay-llm.ru без /v1 (формат Messages). Полный список идентификаторов приведён на странице OpenClaw в разделе интеграций, актуальные отдаёт метод GET /v1/models.
Для первой проверки хватит недорогой модели: на странице интеграции в примере стоит claude-haiku-5.5. Когда связка заработает, смените модель, снова пройдя мастер с другим Model ID, и сравните расход на одном и том же поручении. Так видно, за какие задачи сильная модель стоит своих токенов.
Работать с ассистентом можно тремя способами:
openclaw dashboard
openclaw tui
openclaw terminalПервая команда открывает веб-интерфейс, вторая терминальный интерфейс, третья общение прямо в терминале.
OpenClaw или кодовый агент
OpenClaw задуман как ассистент в чатах: он живёт рядом с мессенджерами и расширяется навыками. Для работы с кодом в терминале ближе клиенты вроде Claude Code или OpenCode: они читают проект, правят файлы и запускают тесты. Подключаются они тем же ключом Relay, инструкции лежат в разделе интеграций. Выбирайте по задаче: ассистент для сообщений и поручений одно, агент для репозитория другое.
Отдельный ключ и лимит расхода
Ассистент, который следит за чатами и вызывает инструменты, расходует токены не так, как человек в окне чата. По документации Relay, одно действие в агентном клиенте легко превращается в несколько обращений к модели, а контекст растёт вместе с историей. Биллинг учитывает каждый реальный вызов.
Поэтому создайте в консоли ключ только для OpenClaw. Для ключа задаются суточный лимит расходов, лимит запросов в минуту и список разрешённых моделей. Остаток баланса и лимитов видно одним запросом:
curl https://relay-llm.ru/v1/key \
-H "Authorization: Bearer $RELAY_API_KEY"Если подозреваете, что ключ утёк, отключите или удалите его в консоли: по странице безопасности отключённый ключ перестаёт приниматься в течение минуты. Чтобы снизить расход, начинайте новый диалог, когда старый контекст не нужен, и берите модель поменьше для простых задач.
Безопасность агента с доступом к системе
Агент, которому разрешили читать файлы и запускать команды, способен навредить данным и по собственной ошибке, и по чужой подсказке в полученном сообщении. По документации проекта (опять же сведения источника на 29 октября 2026) один Gateway рассчитан на единый круг доверия: делить его с посторонними людьми нельзя. Пока вы не включили песочницу, инструменты основной сессии работают прямо на вашем компьютере. Команда openclaw security audit сверяет конфигурацию с рекомендациями.
Отдельная тема: навыки из каталога ClawHub. The Hacker News 2 февраля 2026 года писал, что специалисты Koi Security просмотрели 2857 навыков и отметили вредоносными 341 из них. Практический вывод простой: файлы навыка читают до установки, а самого агента запускают там, где нет ваших ключей и рабочих документов. Подойдёт отдельная машина, виртуальная машина или отдельная учётная запись.
Если что-то не работает
| Симптом | Что проверить |
|---|---|
| Ответ 401 | ключ скопирован целиком, не отключён и не удалён |
Ответ 404 с кодом model_not_found | идентификатор совпадает с каталогом до символа |
| Ответ 402 | на балансе закончились деньги, пополните его |
| Списание не совпадает с ожиданием | сверьте модель, токены и кэш в записи журнала запросов |
Если запрос завершился ошибкой, сохраните его идентификатор и время и пришлите в поддержку вместо ключа и текста запроса. Проблемы с биллингом разобраны в разделе про оплату.
Как подключить Relay к OpenClaw?
Запустите openclaw onboard --install-daemon, выберите QuickStart, затем More, custom и Custom Provider. Укажите адрес https://relay-llm.ru/v1, вставьте ключ из консоли, выберите тип совместимости и введите идентификатор модели.
Почему для Claude другой тип совместимости?
Модели Claude вызываются по протоколу Anthropic, а GPT, Gemini, DeepSeek, GLM и Grok по протоколу OpenAI. В мастере для этого два варианта: Anthropic-compatible и OpenAI-compatible.
Безопасно ли давать OpenClaw доступ к компьютеру?
Только при осторожной настройке. Запускайте его отдельно от рабочих данных, ставьте навыки после чтения, а для расходов выдайте отдельный ключ с лимитом.