К содержимому
Блог

OpenClaw: установка и подключение моделей через Relay

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 или новее.

bash
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

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

По описанию в документации проекта (мы опираемся на сведения источника на 29 октября 2026), после мастера Gateway можно оставить работать фоновой службой. Для этого и для диагностики есть команды:

bash
openclaw gateway install
openclaw gateway status
openclaw doctor

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

Подключение Relay в мастере

Ответы мастера на странице Relay

  1. Подтвердите режим

    На вопрос про personal-by-default и lock-down для общего использования ответьте Yes. В Setup mode выберите QuickStart.

  2. Выберите провайдера

    В Model/auth provider выберите More, введите custom, чтобы отфильтровать список, и выберите Custom Provider («Any OpenAI or Anthropic compatible endpoint»).

  3. Укажите адрес и ключ

    В API Base URL введите https://relay-llm.ru/v1. На вопрос о способе передачи ключа выберите Paste API key now и вставьте ключ из консоли Relay.

  4. Выберите тип и модель

    В Endpoint compatibility задайте тип по семейству модели (таблица ниже). В Model ID введите идентификатор из каталога, например claude-haiku-5.5.

  5. Дождитесь проверки

    Когда появится Verification successful, Relay подключён. Если мастер спросит API Compatibility, выберите openai. Остальные каналы и навыки можно настроить позже.

СемействоТип в мастереПримеры идентификаторов
GPTOpenAI-compatiblegpt-6.1-sol, gpt-6-astra, gpt-5.6-luna
GeminiOpenAI-compatiblegemini-3.1-pro
DeepSeekOpenAI-compatibledeepseek-v4.1-flash
GLM и GrokOpenAI-compatibleglm-5.3, grok-4.5
ClaudeAnthropic-compatibleclaude-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, и сравните расход на одном и том же поручении. Так видно, за какие задачи сильная модель стоит своих токенов.

Каталог моделей

GPT-6.1 Sol0,12 $ за 1 млн входных токенов

Работать с ассистентом можно тремя способами:

bash
openclaw dashboard
openclaw tui
openclaw terminal

Первая команда открывает веб-интерфейс, вторая терминальный интерфейс, третья общение прямо в терминале.

OpenClaw или кодовый агент

OpenClaw задуман как ассистент в чатах: он живёт рядом с мессенджерами и расширяется навыками. Для работы с кодом в терминале ближе клиенты вроде Claude Code или OpenCode: они читают проект, правят файлы и запускают тесты. Подключаются они тем же ключом Relay, инструкции лежат в разделе интеграций. Выбирайте по задаче: ассистент для сообщений и поручений одно, агент для репозитория другое.

Отдельный ключ и лимит расхода

Ассистент, который следит за чатами и вызывает инструменты, расходует токены не так, как человек в окне чата. По документации Relay, одно действие в агентном клиенте легко превращается в несколько обращений к модели, а контекст растёт вместе с историей. Биллинг учитывает каждый реальный вызов.

Поэтому создайте в консоли ключ только для OpenClaw. Для ключа задаются суточный лимит расходов, лимит запросов в минуту и список разрешённых моделей. Остаток баланса и лимитов видно одним запросом:

bash
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 доступ к компьютеру?

Только при осторожной настройке. Запускайте его отдельно от рабочих данных, ставьте навыки после чтения, а для расходов выдайте отдельный ключ с лимитом.

Создать аккаунт

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.