Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

1

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

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

Node.js ≥ 18

node --version
Установка: nodejs.org.
3

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

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

​
Установка OpenClaw

npm install -g openclaw@latest
Проверка: 
openclaw --version

​
Настройка RuAPI

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

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

1

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

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

Отредактируйте 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-4-6" },
    },
  },
}
Не добавляйте /v1 к ANTHROPIC_BASE_URL.
3

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

Если установлен как демон:
openclaw onboard --install-daemon
Или вручную:
openclaw gateway:start

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

Если конфиг трогать не хочется — пропишите переменные в shell:
Добавьте в ~/.zshrc или ~/.bashrc:
export ANTHROPIC_BASE_URL="https://www.ruapi.ai"
export ANTHROPIC_API_KEY="sk-ваш-ключ"
Затем source файл или откройте новый терминал.
В openclaw.json всё равно нужно прописать agents.defaults.model, иначе OpenClaw будет спрашивать модель при каждом запуске.

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

openclaw agent --message "Поздоровайся одним предложением по-русски" --local
В ответ должно прийти сообщение, а в Консоли RuAPI → Логи — соответствующий вызов модели claude-sonnet-4-6 (или указанной вами). Когда подключите Telegram / Discord и др., сообщения оттуда тоже пойдут через RuAPI.

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

Отредактируйте ~/.openclaw/openclaw.json: 
{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-7" },
    },
  },
}
OpenClaw использует именование <provider>/<model-id>. Часто используемые:
ID моделиНазначение
anthropic/claude-sonnet-4-6Основная рабочая лошадка
anthropic/claude-opus-4-7Тяжёлые задачи
anthropic/claude-haiku-4-5Быстро и дёшево
Полный список — в галерее моделей.

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

  • ANTHROPIC_API_KEY должен быть токеном RuAPI (sk-...), а не официальным ключом Anthropic.
  • В Консоли RuAPI → Токены проверьте, что ключ активен и модель не исключена из allowlist.
  • ID модели должен начинаться с anthropic/, например anthropic/claude-sonnet-4-6.
  • Не добавляйте /v1 к ANTHROPIC_BASE_URL.
  • Проверьте сеть: curl -I https://www.ruapi.ai.
  • Прервите onboarding (Ctrl+C), отредактируйте ~/.openclaw/openclaw.json вручную — при следующем запуске будет использован этот файл.
models.providers в OpenClaw поддерживает fallback-цепочки. Сначала добейтесь работы RuAPI как единственного провайдера, затем добавляйте fallback по конфигурации OpenClaw.
Объявите кастомного провайдера в openclaw.json:
{
  models: {
    providers: {
      ruapi: {
        api: "openai",
        baseUrl: "https://www.ruapi.ai/v1",
        apiKey: "sk-ваш-ключ",
        models: ["gpt-5", "gpt-5-mini"],
      },
    },
  },
  agents: {
    defaults: { model: { primary: "ruapi/gpt-5" } },
  },
}

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

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