Как подключить OpenClaw к RuAPI

OpenClaw — личный AI-ассистент, который вы запускаете на собственных устройствах: доступ через Telegram, WhatsApp, Discord, Signal, iMessage и другие каналы. Он поддерживает разные провайдеры моделей — RuAPI подключается через Anthropic-совместимый или OpenAI-совместимый протокол.

Предварительные требования

Аккаунт RuAPI и API-ключ

Консоль → API-ключи → Создать ключ. См. API-ключи и безопасность.

Node.js ≥ 24.16

OpenClaw требует Node.js 24.16 или новее (рекомендуется Node 26). Проверьте:

node --version

Установка: nodejs.org.

Операционная система

macOS и Linux работают из коробки. На Windows используйте WSL2.

Установка OpenClaw

npm install -g openclaw@latest

Если у вас npm 11.16 или новее и установка останавливается с ошибкой из-за скриптов — добавьте флаг: npm install -g openclaw@latest --allow-scripts=openclaw. Проверка:

openclaw --version

Настройка RuAPI

OpenClaw использует SDK Anthropic, поэтому проще всего задать ANTHROPIC_BASE_URL и ANTHROPIC_API_KEY как переменные окружения и выбрать модель в ~/.openclaw/openclaw.json.

Способ 1: env + конфиг (рекомендуется)

Запустите onboarding, чтобы создалась директория

openclaw onboard

Пройдите мастер. Когда спросят «выберите провайдера» — выберите что угодно (например, Anthropic API key) и впишите ключ-заглушку. Это нужно, чтобы создались ~/.openclaw/ и начальная конфигурация.

Отредактируйте openclaw.json

Откройте ~/.openclaw/openclaw.json (создайте, если нет) и пропишите:

{
  env: {
    ANTHROPIC_BASE_URL: "https://www.ruapi.ai",
    ANTHROPIC_API_KEY: "sk-ваш-ключ-RuAPI",
  },
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-sonnet-5" },
    },
  },
}

Не добавляйте /v1 к ANTHROPIC_BASE_URL.

Перезапустите gateway

Если установлен как демон:

openclaw onboard --install-daemon

Или перезапустите вручную:

openclaw gateway restart

Способ 2: переменные окружения в shell

Если конфиг трогать не хочется — пропишите переменные в shell:

macOS / Linux
WSL2

Добавьте в ~/.zshrc или ~/.bashrc:

export ANTHROPIC_BASE_URL="https://www.ruapi.ai"
export ANTHROPIC_API_KEY="sk-ваш-ключ"

Затем source файл или откройте новый терминал.

Аналогично — редактируйте ~/.bashrc внутри WSL.

В openclaw.json всё равно нужно прописать agents.defaults.model, иначе OpenClaw будет спрашивать модель при каждом запуске.

Первый запрос

Откройте чат прямо в терминале и попросите поздороваться одним предложением по-русски:

openclaw chat

Или откройте веб-панель командой openclaw dashboard и напишите сообщение там. В ответ должно прийти сообщение, а в Консоли RuAPI → Журнал запросов — соответствующий вызов выбранной вами модели Claude. Когда подключите Telegram / Discord и др., сообщения оттуда тоже пойдут через RuAPI.

Выбор другой модели

Отредактируйте ~/.openclaw/openclaw.json:

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-8" },
    },
  },
}

OpenClaw использует именование <provider>/<model-id>. Часто используемые:

ID модели	Назначение
`anthropic/claude-sonnet-5`	Основная рабочая лошадка
`anthropic/claude-opus-4-8`	Тяжёлые задачи
`anthropic/claude-haiku-4-5-20251001`	Быстро и дёшево

Полный список — на странице цен.

Решение проблем

401 Unauthorized

ANTHROPIC_API_KEY должен быть ключом RuAPI (sk-...), а не официальным ключом Anthropic.
В Консоли RuAPI → API-ключи проверьте, что ключ активен и что модель входит в «Доступные модели» ключа (если список задан).

Модель не найдена (503) или 404

ID модели должен начинаться с anthropic/, например anthropic/claude-sonnet-5.
Не добавляйте /v1 к ANTHROPIC_BASE_URL.

openclaw onboard зависает

Проверьте сеть: curl -I https://www.ruapi.ai.
Прервите onboarding (Ctrl+C), отредактируйте ~/.openclaw/openclaw.json вручную — при следующем запуске будет использован этот файл.

Несколько провайдеров для отказоустойчивости

models.providers в OpenClaw поддерживает fallback-цепочки. Сначала добейтесь работы RuAPI как единственного провайдера, затем добавляйте fallback по конфигурации OpenClaw.

Использовать OpenAI-совместимый протокол вместо Anthropic

Объявите кастомного провайдера в openclaw.json:

{
  models: {
    providers: {
      ruapi: {
        api: "openai",
        baseUrl: "https://www.ruapi.ai/v1",
        apiKey: "sk-ваш-ключ",
        models: ["gpt-5.4", "gpt-5.4-mini"],
      },
    },
  },
  agents: {
    defaults: { model: { primary: "ruapi/gpt-5.4" } },
  },
}

Продвинутое: подключение каналов

Основная ценность OpenClaw — «общаться с Claude через мессенджер». После того как RuAPI настроен, подключайте Telegram / Discord / Signal по документации каналов OpenClaw — модельные вызовы автоматически пойдут через RuAPI.

Начало работы

Руководства

Справочник API

Гайды по моделям

Интеграции

Возможности

Рецепты

Юридическая информация

Как подключить OpenClaw к RuAPI

Предварительные требования

Установка OpenClaw

Настройка RuAPI

Способ 1: env + конфиг (рекомендуется)

Способ 2: переменные окружения в shell

Первый запрос

Выбор другой модели

Решение проблем

Продвинутое: подключение каналов

​Предварительные требования

​Установка OpenClaw

​Настройка RuAPI

​Способ 1: env + конфиг (рекомендуется)

​Способ 2: переменные окружения в shell

​Первый запрос

​Выбор другой модели

​Решение проблем

​Продвинутое: подключение каналов

Предварительные требования

Установка OpenClaw

Настройка RuAPI

Способ 1: env + конфиг (рекомендуется)

Способ 2: переменные окружения в shell

Первый запрос

Выбор другой модели

Решение проблем

Продвинутое: подключение каналов