Подключение OpenClaw к BotHub

В этом руководстве описано, как настроить OpenClaw для работы с моделями через BotHub (bothub.ru) — российский агрегатор AI-моделей с OpenAI-совместимым API. Это позволяет использовать GPT, Claude, Gemini, DeepSeek и другие модели без VPN и зарубежных карт.

Содержание

• Что такое BotHub
• Предварительные требования
• Шаг 1 — Получение API-ключа BotHub
• Шаг 2 — Установка OpenClaw
• Шаг 3 — Настройка конфигурации
• Шаг 4 — Применение конфигурации
• Примеры конфигураций для популярных моделей
• Доступные модели BotHub
• Переменные окружения
• Проверка подключения
• Переключение между моделями
• Устранение ошибок
• Полная пример-конфигурация

Что такое BotHub

BotHub — российский агрегатор AI-моделей, предоставляющий доступ к GPT-5.x, Claude Opus/Sonnet, Gemini, DeepSeek, Grok и другим моделям через единый OpenAI-совместимый API без необходимости использовать VPN.

Параметр	Значение
Base URL	https://bothub.ru/v1
Альт. Base URL	https://bothub.ru/v1
Тип API	OpenAI-compatible (openai-completions)
Оплата	Caps (без ежемесячных подписок, не сгорают)
Бесплатно	30 000 Caps при регистрации

примечание

OpenClaw использует поле api: "openai-completions" для работы с любым OpenAI-совместимым провайдером, что полностью подходит для BotHub.

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

• Node.js ≥ 22 (проверить: node --version)
• OpenClaw установлен (npm install -g openclaw@latest или pnpm add -g openclaw@latest)
• Аккаунт на bothub.ru
• Сгенерированный API-ключ BotHub

Шаг 1 — Получение API-ключа BotHub

1. Зарегистрируйтесь или войдите на bothub.ru.
2. Откройте раздел профиля «Для разработчиков»:
   https://bothub.ru/profile/for-developers
3. Нажмите «Добавить ключ» и сгенерируйте новый API-ключ.
4. Скопируйте и сохраните ключ — он понадобится для конфигурации OpenClaw.

Ключ выглядит как длинная строка символов (без префикса).

Шаг 2 — Установка OpenClaw

Если OpenClaw ещё не установлен:

# Через npm
npm install -g openclaw@latest

# Или через pnpm
pnpm add -g openclaw@latest

# Затем запустите мастер первоначальной настройки
openclaw onboard --install-daemon

Шаг 3 — Настройка конфигурации

Файл конфигурации OpenClaw:

~/.openclaw/openclaw.json

Вариант A: Ручная правка openclaw.json

Откройте файл конфигурации и добавьте BotHub как пользовательский провайдер.

Минимальная конфигурация (одна модель)

{
  "agent": {
    "model": "bothub/claude-sonnet-4-6"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "bothub": {
        "baseUrl": "https://bothub.ru/v1",
        "apiKey": "ВАШ_КЛЮЧ_BOTHUB",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6 (BotHub)",
            "contextWindow": 200000,
            "maxTokens": 8192,
            "reasoning": false,
            "input": ["text", "image"]
          }
        ]
      }
    }
  }
}

подсказка

Вместо хранения ключа в файле конфигурации используйте переменную окружения (см. раздел «Переменные окружения»).

Использование переменной окружения для ключа (рекомендуется)

{
  "models": {
    "mode": "merge",
    "providers": {
      "bothub": {
        "baseUrl": "https://bothub.ru/v1",
        "apiKey": "${BOTHUB_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6 (BotHub)",
            "contextWindow": 200000,
            "maxTokens": 8192,
            "reasoning": false,
            "input": ["text", "image"]
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bothub/claude-sonnet-4-6"
      }
    }
  }
}

Задайте переменную окружения:

# В .env или ~/.openclaw/.env
BOTHUB_API_KEY=ВАШ_КЛЮЧ_BOTHUB

# Или экспортируйте напрямую
export BOTHUB_API_KEY=ВАШ_КЛЮЧ_BOTHUB

Вариант B: Автоматическая настройка через чат

Если OpenClaw уже запущен, вставьте в чат следующий промпт:

Add BotHub as a custom provider to my OpenClaw config. Use these details:

- Provider name: bothub
- Base URL: https://bothub.ru/v1
- API key: [ВСТАВЬТЕ ВАШ КЛЮЧ BOTHUB СЮДА]
- API type: openai-completions

Add these models:
1. claude-sonnet-4-6 (context: 200000, max tokens: 8192)
2. gpt-5.2 (context: 400000, max tokens: 128000)
3. gpt-5.4 (context: 1050000, max tokens: 128000)

Set bothub/claude-sonnet-4-6 as the primary model. Apply the config when done.

OpenClaw обновит конфигурацию и перезапустит Gateway.

Шаг 4 — Применение конфигурации

После ручного редактирования openclaw.json примените изменения:

# Применить конфигурацию из файла
openclaw gateway config.apply --file ~/.openclaw/openclaw.json

# Или перезапустить Gateway
openclaw gateway restart

# Проверить корректность конфигурации
openclaw doctor

Примеры конфигураций для популярных моделей

Claude Sonnet 4.6

{
  "id": "claude-sonnet-4-6",
  "name": "Claude Sonnet 4.6 via BotHub",
  "contextWindow": 200000,
  "maxTokens": 8192,
  "reasoning": false,
  "input": ["text", "image"]
}

GPT-5.2

{
  "id": "gpt-5.2",
  "name": "GPT-5.2 via BotHub",
  "contextWindow": 400000,
  "maxTokens": 128000,
  "reasoning": false,
  "input": ["text", "image"]
}

GPT-5.4

{
  "id": "gpt-5.4",
  "name": "GPT-5.4 via BotHub",
  "contextWindow": 1050000,
  "maxTokens": 128000,
  "reasoning": false,
  "input": ["text", "image"]
}

DeepSeek (через BotHub)

{
  "id": "deepseek-chat",
  "name": "DeepSeek Chat via BotHub",
  "contextWindow": 128000,
  "maxTokens": 8192,
  "reasoning": false,
  "input": ["text"]
}

Доступные модели BotHub

Актуальный список моделей: https://bothub.ru/models

Популярные модели для использования в OpenClaw:

Model ID (для конфига)	Описание	Контекст
claude-sonnet-4-6	Claude Sonnet 4.6 (Anthropic)	200K
gpt-5.2	GPT-5.2 (OpenAI)	400K
gpt-5.4	GPT-5.4 (OpenAI)	1 050K
gpt-5	GPT-5 (OpenAI)	400K
gpt-4.1	GPT-4.1 (OpenAI)	1 047K
o3	OpenAI o3 (reasoning)	128K
deepseek-chat	DeepSeek Chat	128K
gemini-1.5-pro	Gemini 1.5 Pro (Google)	1 000K

Точные ID моделей уточняйте на bothub.ru/models или в API BotHub.

Переменные окружения

Для безопасного хранения ключей создайте файл .env в директории OpenClaw:

# ~/.openclaw/.env  или  /opt/openclaw.env

BOTHUB_API_KEY=ВАШ_КЛЮЧ_BOTHUB

Затем укажите путь к .env в конфигурации или экспортируйте переменную:

export BOTHUB_API_KEY=ВАШ_КЛЮЧ_BOTHUB

Проверка подключения

# Список всех настроенных моделей
openclaw models list

# Фильтр по провайдеру BotHub
openclaw models list --provider bothub

# Проверить статус текущей модели
openclaw models status

# Проверить подключение ко всем провайдерам
openclaw models status --probe

# Диагностика
openclaw doctor

Переключение между моделями

В чате:

/model bothub/gpt-5.2
/model bothub/claude-sonnet-4-6
/model bothub/deepseek-chat

Через CLI:

openclaw models set bothub/gpt-5.2

Устранение ошибок

Model 'bothub/model-name' is not allowed

Модель не добавлена в список разрешённых. Добавьте её в agents.defaults.models:

{
  "agents": {
    "defaults": {
      "models": {
        "bothub/gpt-5.2": { "alias": "GPT-5.2" },
        "bothub/claude-sonnet-4-6": { "alias": "Claude-BotHub" }
      }
    }
  }
}

401 Unauthorized / Invalid API key

• Убедитесь, что переменная окружения BOTHUB_API_KEY установлена корректно.
• Проверьте, что ключ сгенерирован в разделе «Для разработчиков» на сайте BotHub.
• Проверьте баланс Caps на аккаунте BotHub.

Connection refused / ECONNREFUSED

• Проверьте интернет-соединение.
• Убедитесь в корректности baseUrl: https://bothub.ru/v1
• Можно использовать альтернативный URL: https://bothub.ru/v1

Unknown provider / Provider not found

Имя провайдера в models.providers должно совпадать с именем в строке модели (bothub/model-id):

{
  "providers": {
    "bothub": {}
  }
}

В agents используйте bothub/gpt-5.2 — имя совпадает.

Ошибки синтаксиса JSON

Попросите OpenClaw исправить конфигурацию в чате:

Fix the JSON syntax errors in my openclaw config.

Или выполните:

openclaw doctor

Полная пример-конфигурация

Ниже приведена полная конфигурация ~/.openclaw/openclaw.json с несколькими моделями BotHub и fallback-цепочкой:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "bothub/claude-sonnet-4-6",
        "fallbacks": ["bothub/gpt-5.2", "bothub/deepseek-chat"]
      },
      "models": {
        "bothub/claude-sonnet-4-6": { "alias": "Claude" },
        "bothub/gpt-5.2": { "alias": "GPT-5.2" },
        "bothub/gpt-5.4": { "alias": "GPT-5.4" },
        "bothub/deepseek-chat": { "alias": "DeepSeek" }
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "bothub": {
        "baseUrl": "https://bothub.ru/v1",
        "apiKey": "${BOTHUB_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "contextWindow": 200000,
            "maxTokens": 8192,
            "reasoning": false,
            "input": ["text", "image"],
            "cost": {
              "input": 3.0,
              "output": 15.0,
              "cacheRead": 0,
              "cacheWrite": 0
            }
          },
          {
            "id": "gpt-5.2",
            "name": "GPT-5.2",
            "contextWindow": 400000,
            "maxTokens": 128000,
            "reasoning": false,
            "input": ["text", "image"],
            "cost": {
              "input": 1.97,
              "output": 15.75,
              "cacheRead": 0,
              "cacheWrite": 0
            }
          },
          {
            "id": "gpt-5.4",
            "name": "GPT-5.4",
            "contextWindow": 1050000,
            "maxTokens": 128000,
            "reasoning": false,
            "input": ["text", "image"],
            "cost": {
              "input": 2.81,
              "output": 16.88,
              "cacheRead": 0,
              "cacheWrite": 0
            }
          },
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat",
            "contextWindow": 128000,
            "maxTokens": 8192,
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0.14,
              "output": 0.28,
              "cacheRead": 0,
              "cacheWrite": 0
            }
          }
        ]
      }
    }
  }
}

Дополнительные ресурсы

Ресурс	Описание
OpenClaw Docs	Документация по моделям OpenClaw
BotHub API Docs	Документация BotHub API
BotHub Models	Актуальный список моделей и цен
BotHub Dev Profile	Управление API-ключами
OpenClaw GitHub	Исходный код OpenClaw
OpenClaw Discord	Сообщество для поддержки
BotHub Telegram	Сообщество BotHub

Документация актуальна для OpenClaw версии 2026.3.x и BotHub API v2. Март 2026.