Полное руководство по подключению Moltbot к API-шлюзу: 5 шагов настройки OpenAI-совместимого интерфейса для экономии 60% затрат

Moltbot по умолчанию работает через официальный API Anthropic. Однако у оригинального API есть свои нюансы: ограничения по доступу и довольно высокий ценник. В этой статье мы подробно разберем, как подключить Moltbot к API-шлюзу (прокси), используя режим openai-compatible для работы со сторонними сервисами.

Суть: прочитав этот гайд, вы научитесь настраивать Moltbot для работы через API-посредников. Это поможет сделать использование ИИ-помощника дешевле и стабильнее.

Основные моменты настройки API-прокси для Moltbot

Перед началом настройки стоит разобраться в механизме конфигурации API в Moltbot и преимуществах использования прокси-сервисов (relay).

Сравнение способов настройки API Moltbot

Подготовка к настройке API-прокси в Moltbot

Шаг 1: Убедитесь, что Moltbot установлен

Прежде всего, проверьте наличие установленного Moltbot в системе:

# Проверка версии Moltbot
moltbot --version

# Если не установлен, выполните установку
npm install -g moltbot@latest

Системные требования: Node.js >= 22

Шаг 2: Получение ключа API-прокси

Вам необходимо получить API Key у провайдера API-прокси.

🚀 Быстрый старт: Рекомендуем использовать APIYI (apiyi.com) для получения API-ключа. При регистрации начисляется бесплатный лимит; поддерживаются Claude Sonnet 4, Claude Opus 4.5, GPT-4o и другие актуальные модели. Цены на 40-60% ниже, чем у официальных провайдеров.

После получения ключа сохраните следующие данные:

Способ 1: Настройка прокси-сервера API для Moltbot через файл config.json

Это самый рекомендуемый способ: настроили один раз, и всё работает постоянно.

Где найти файл конфигурации Moltbot

Файл конфигурации Moltbot обычно находится здесь:

Также путь можно узнать с помощью команды:

# Посмотреть текущую конфигурацию
moltbot config list

# Узнать путь к файлу конфигурации
moltbot config path

Редактирование config.json для настройки прокси-сервера

Откройте конфигурационный файл и добавьте или измените раздел models.providers:

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-your-api-key-here",
        "api": "openai-completions",
        "authHeader": true,
        "models": [
          {
            "id": "claude-sonnet-4-20250514",
            "name": "Claude Sonnet 4",
            "contextWindow": 200000,
            "maxTokens": 64000
          },
          {
            "id": "claude-opus-4-5-20251101",
            "name": "Claude Opus 4.5",
            "contextWindow": 200000,
            "maxTokens": 32000
          },
          {
            "id": "gpt-4o",
            "name": "GPT-4o",
            "contextWindow": 128000,
            "maxTokens": 16384
          }
        ]
      }
    }
  },
  "agent": {
    "model": {
      "primary": "apiyi/claude-sonnet-4-20250514",
      "fallbacks": ["apiyi/claude-opus-4-5-20251101", "apiyi/gpt-4o"]
    }
  }
}

Подробное описание параметров

Способ 2: Настройка в формате YAML

Если вам больше нравится формат YAML, Moltbot также поддерживает config.yaml:

# ~/.moltbot/config.yaml
models:
  providers:
    apiyi:
      baseUrl: "https://api.apiyi.com/v1"
      apiKey: "sk-your-api-key-here"
      api: openai-completions
      authHeader: true
      models:
        - id: claude-sonnet-4-20250514
          name: Claude Sonnet 4
          contextWindow: 200000
          maxTokens: 64000
        - id: claude-opus-4-5-20251101
          name: Claude Opus 4.5
          contextWindow: 200000
          maxTokens: 32000

agent:
  model:
    primary: apiyi/claude-sonnet-4-20250514
    fallbacks:
      - apiyi/claude-opus-4-5-20251101
      - apiyi/gpt-4o

Упрощенная версия конфигурации YAML

Если вам нужна только одна модель, можно использовать максимально простой конфиг:

# ~/.moltbot/config.yaml - минималистичная версия
llm:
  provider: openai-compatible
  model: claude-sonnet-4-20250514
  apiKey: sk-your-api-key-here
  baseUrl: https://api.apiyi.com/v1

🎯 Совет: Рекомендую использовать полную версию конфигурации. Так вы сможете настроить несколько моделей и стратегии резервного переключения (fallback), что повысит стабильность работы. Через APIYI (apiyi.com) можно получить доступ сразу к Claude, GPT, Gemini и другим современным моделям.

Способ 3 настройки прокси Moltbot API: переменные окружения

Подходит для временного тестирования или CI/CD сред:

# Настройка переменных окружения
export MOLTBOT_LLM_PROVIDER="openai-compatible"
export MOLTBOT_LLM_MODEL="claude-sonnet-4-20250514"
export MOLTBOT_LLM_API_KEY="sk-your-api-key-here"
export MOLTBOT_LLM_BASE_URL="https://api.apiyi.com/v1"

# Запуск Moltbot
moltbot gateway start

Или настройте в файле .env:

# ~/.moltbot/.env
MOLTBOT_LLM_PROVIDER=openai-compatible
MOLTBOT_LLM_MODEL=claude-sonnet-4-20250514
MOLTBOT_LLM_API_KEY=sk-your-api-key-here
MOLTBOT_LLM_BASE_URL=https://api.apiyi.com/v1

Способ настройки API-прокси Moltbot №4: Командная строка

Быстрая настройка с помощью команды moltbot config set:

# Настройка API-прокси
moltbot config set models.providers.apiyi.baseUrl "https://api.apiyi.com/v1"
moltbot config set models.providers.apiyi.apiKey "sk-your-api-key-here"
moltbot config set models.providers.apiyi.api "openai-completions"

# Установка модели по умолчанию
moltbot config set agent.model.primary "apiyi/claude-sonnet-4-20250514"

# Проверка конфигурации
moltbot config list

Скрипт для пакетной настройки

Создайте небольшой bash-скрипт, чтобы выполнить все настройки одной командой:

#!/bin/bash
# setup-apiyi.sh - Скрипт настройки API-прокси APIYI для Moltbot

API_KEY="sk-your-api-key-here"
BASE_URL="https://api.apiyi.com/v1"

echo "Настройка API-прокси для Moltbot..."

# Настройка провайдера (provider)
moltbot config set models.providers.apiyi.baseUrl "$BASE_URL"
moltbot config set models.providers.apiyi.apiKey "$API_KEY"
moltbot config set models.providers.apiyi.api "openai-completions"
moltbot config set models.providers.apiyi.authHeader true

# Установка основной модели
moltbot config set agent.model.primary "apiyi/claude-sonnet-4-20250514"

# Перезапуск шлюза (gateway)
moltbot gateway restart

echo "Настройка завершена! Используйте 'moltbot doctor' для проверки конфигурации"

Проверка конфигурации API-прокси Moltbot

После завершения настройки нужно убедиться, что всё указано верно и система работает.

Проверка с помощью moltbot doctor

# Запуск диагностики
moltbot doctor

# Автоматическое исправление найденных проблем
moltbot doctor --fix

Пример успешного вывода:

✓ Gateway running on port 18789
✓ Model provider 'apiyi' configured
✓ API key validated
✓ Model 'claude-sonnet-4-20250514' available
✓ Connection test passed

Отправка тестового сообщения

# Тестирование подключения к API
moltbot test-llm --provider apiyi --model claude-sonnet-4-20250514

# Отправка пробного сообщения в чат
moltbot chat "Привет, расскажи немного о себе"

Просмотр логов API-вызовов

# Просмотр логов в режиме реального времени
moltbot logs --follow

# Просмотр последних 10 вызовов API
moltbot logs --filter api-call --last 10

Список моделей, поддерживаемых прокси-сервисом APIYI для Moltbot

Через прокси-сервис APIYI вы можете использовать следующие модели в Moltbot:

Серия Claude

Серия OpenAI

Серия Google

💡 Совет по выбору: Для повседневного использования Moltbot мы рекомендуем Claude Sonnet 4 — это идеальный баланс производительности и стоимости. Полный список моделей и актуальные цены можно найти на сайте APIYI apiyi.com.

Расширенная настройка прокси-хаба Moltbot API

Настройка стратегии Fallback

Автоматическое переключение на резервную модель, если основная модель недоступна:

{
  "agent": {
    "model": {
      "primary": "apiyi/claude-sonnet-4-20250514",
      "fallbacks": [
        "apiyi/claude-3-5-sonnet-20241022",
        "apiyi/gpt-4o"
      ],
      "fallbackStrategy": "sequential"
    }
  }
}

Настройка правил маршрутизации моделей

Автоматический выбор оптимальной модели в зависимости от типа задачи:

{
  "agent": {
    "modelRouting": {
      "coding": "apiyi/claude-sonnet-4-20250514",
      "reasoning": "apiyi/claude-opus-4-5-20251101",
      "quick": "apiyi/claude-3-5-haiku-20241022",
      "default": "apiyi/claude-sonnet-4-20250514"
    }
  }
}

Настройка лимитов затрат

Защита от непредвиденных высоких расходов:

{
  "agent": {
    "limits": {
      "maxTokensPerRequest": 32000,
      "maxRequestsPerHour": 100,
      "maxCostPerDay": 10.00
    }
  }
}

FAQ по прокси-хабу Moltbot API

# Проверка API-ключа
curl -H "Authorization: Bearer sk-your-key" https://api.apiyi.com/v1/models

moltbot config set agent.model.primary "apiyi/claude-opus-4-5-20251101"
moltbot gateway restart

moltbot chat --model apiyi/gpt-4o "Привет"

{
  "agent": {
    "model": {
      "primary": "apiyi/claude-sonnet-4-20250514",
      "fallbacks": ["openrouter/anthropic/claude-3.5-sonnet"]
    }
  }
}

# Просмотр локальной статистики за сегодня
moltbot stats --period today

# Просмотр детального расхода за неделю
moltbot stats --detailed --period week

Устранение неполадок в работе прокси-сервера Moltbot API

Распространенные ошибки и способы их решения

Режим отладки

Включите подробное логирование, чтобы было проще найти причину проблемы:

# Включение режима отладки
export MOLTBOT_DEBUG=true
moltbot gateway start

# Или используйте флаги в командной строке
moltbot gateway start --debug --log-level verbose

Команды для проверки конфигурации

# Проверка синтаксиса конфигурации
moltbot config validate

# Тестирование подключения к API
moltbot test-connection --provider apiyi

# Полная диагностика системы (health check)
moltbot doctor --verbose

Сравнение прокси-сервера Moltbot API и официального API

🎯 Совет по выбору: Если вам нужна поддержка сразу нескольких моделей или вы находитесь в регионе со сложным доступом к зарубежным сервисам, мы рекомендуем подключать Moltbot через APIYI (apiyi.com). Это не только выгоднее по цене, но и обеспечит стабильную работу и оперативную помощь от техподдержки.

Итоги: основные моменты настройки API-прокси для Moltbot

Из этого руководства вы узнали, как полностью настроить подключение Moltbot к API-прокси:

1. Подготовка: установите Moltbot и получите API-ключ на сайте APIYI (apiyi.com).
2. Конфигурационный файл: отредактируйте config.json или config.yaml, чтобы добавить конфигурацию провайдера.
3. Ключевые параметры: baseUrl, apiKey, тип API и список моделей.
4. Проверка: используйте команду moltbot doctor и тестовые запросы, чтобы убедиться в правильности настроек.
5. Продвинутые функции: стратегии Fallback (резервные варианты), маршрутизация моделей и лимиты затрат.

Рекомендуем получать API-ключи через APIYI (apiyi.com) — это обеспечит более выгодные цены и стабильную работу сервиса, позволяя вашему помощнику Moltbot приносить максимум пользы.

Справочные материалы

1. Официальная документация Moltbot: справочник по настройке Gateway

   • Ссылка: docs.molt.bot/gateway/configuration

2. Примеры конфигурации Moltbot: шаблоны настроек для разных сценариев

   • Ссылка: docs.molt.bot/gateway/configuration-examples

3. Провайдеры моделей в Moltbot: детальное описание настройки Provider

   • Ссылка: docs.molt.bot/concepts/model-providers

4. Moltbot GitHub: исходный код проекта и раздел Issue

   • Ссылка: github.com/moltbot/moltbot

5. Руководство по началу работы с Moltbot: туториал для быстрого старта

   • Ссылка: docs.molt.bot/start/getting-started

📝 Автор: APIYI Team
🔗 Техподдержка: если вам нужен API-ключ или техническая помощь, заходите на APIYI (apiyi.com)