Интеграция OpenClaw 🦞

OpenClaw (ранее Moltbot, ранее Clawdbt) — open-source платформа для AI-агентов, которая подключает ИИ к Telegram, Discord, Slack, Signal, iMessage, WhatsApp и другим каналам. Поддерживает несколько LLM-провайдеров и позволяет запускать агентов, которые работают одновременно во всех этих каналах.

Для установки и настройки каналов обратитесь к официальной документации OpenClaw. В этой статье — только подключение AITUNNEL.

Установка

Требуется Node.js 24 (или 22.19+).

macOS / Linux

curl -fsSL https://openclaw.ai/install.sh | bash

Windows

iwr -useb https://openclaw.ai/install.ps1 | iex

npm

npm install -g openclaw@latest

Получение API ключа

1. Зарегистрируйтесь на aitunnel.ru
2. Перейдите в раздел Ключи
3. Создайте новый API ключ
4. Скопируйте его — он начинается с sk-aitunnel-

Настройка

Добавьте AITUNNEL в ~/.openclaw/openclaw.json:

{
  "models": {
    "mode": "merge",
    "providers": {
      "aitunnel": {
        "baseUrl": "https://api.aitunnel.ru/v1",
        "apiKey": "sk-aitunnel-xxx",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-4-5",
            "name": "Claude Sonnet 4.5",
            "reasoning": true,
            "input": ["text", "image"]
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "aitunnel/claude-sonnet-4-5"
      },
      "models": {
        "aitunnel/claude-sonnet-4-5": {}
      }
    }
  }
}

Запустите gateway:

openclaw gateway run

Проверьте что всё работает — Control UI откроется в браузере:

openclaw gateway status
openclaw dashboard

TIP

AITUNNEL использует единый baseUrl для всех моделей — не нужно настраивать отдельные endpoints для Anthropic, Google, OpenAI и других.

Выбор модели

Обновите primary и добавьте нужные модели. Актуальные ID — на странице моделей.

Anthropic Claude:

"model": { "primary": "aitunnel/claude-sonnet-4-5" },
"models": { "aitunnel/claude-sonnet-4-5": {} }

Google Gemini:

"model": { "primary": "aitunnel/gemini-2.5-flash" },
"models": { "aitunnel/gemini-2.5-flash": {} }

OpenAI GPT:

"model": { "primary": "aitunnel/gpt-4o" },
"models": { "aitunnel/gpt-4o": {} }

DeepSeek:

"model": { "primary": "aitunnel/deepseek-chat" },
"models": { "aitunnel/deepseek-chat": {} }

Moonshot Kimi:

"model": { "primary": "aitunnel/moonshotai/kimi-k2" },
"models": { "aitunnel/moonshotai/kimi-k2": {} }

Сменить модель без редактирования конфига:

openclaw models set aitunnel/claude-sonnet-4-5

Или командой /model прямо в чате OpenClaw.

Формат модели

OpenClaw обращается к AITUNNEL-моделям в формате aitunnel/<model-id>. Примеры:

• aitunnel/claude-sonnet-4-5
• aitunnel/claude-opus-4-5
• aitunnel/gpt-4o
• aitunnel/gemini-2.5-pro
• aitunnel/deepseek-chat
• aitunnel/moonshotai/kimi-k2
• aitunnel/auto

Каждую используемую модель нужно добавить в models.providers.aitunnel.models[] и в agents.defaults.models. Для моделей с vision укажите "input": ["text", "image"].

Несколько моделей с резервными вариантами

OpenClaw поддерживает fallback-модели. Если основная недоступна, используется следующая:

{
  "models": {
    "mode": "merge",
    "providers": {
      "aitunnel": {
        "baseUrl": "https://api.aitunnel.ru/v1",
        "apiKey": "sk-aitunnel-xxx",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-4-5",
            "name": "Claude Sonnet 4.5",
            "reasoning": true,
            "input": ["text", "image"]
          },
          {
            "id": "claude-haiku-4-5",
            "name": "Claude Haiku 4.5",
            "input": ["text", "image"]
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "aitunnel/claude-sonnet-4-5",
        "fallbacks": ["aitunnel/claude-haiku-4-5"]
      },
      "models": {
        "aitunnel/claude-sonnet-4-5": {},
        "aitunnel/claude-haiku-4-5": {}
      }
    }
  }
}

Модель auto для оптимизации расходов

Модель auto подбирает подходящую модель под запрос автоматически — простые задачи вроде heartbeat идут на дешёвые модели, сложные — на мощные:

{
  "models": {
    "mode": "merge",
    "providers": {
      "aitunnel": {
        "baseUrl": "https://api.aitunnel.ru/v1",
        "apiKey": "sk-aitunnel-xxx",
        "api": "openai-completions",
        "models": [
          { "id": "auto", "name": "AITUNNEL Auto" },
          { "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "aitunnel/auto",
        "fallbacks": ["aitunnel/gemini-2.5-flash"]
      },
      "models": {
        "aitunnel/auto": {},
        "aitunnel/gemini-2.5-flash": {}
      },
      "heartbeat": {
        "every": "30m",
        "model": "aitunnel/gemini-2.5-flash"
      }
    }
  }
}

Оплата идёт по фактически выбранной модели.

Разные модели по каналам

{
  "telegram": {
    "agents": {
      "defaults": {
        "model": { "primary": "aitunnel/gemini-2.5-flash" }
      }
    }
  },
  "discord": {
    "agents": {
      "defaults": {
        "model": { "primary": "aitunnel/claude-sonnet-4-5" }
      }
    }
  }
}

Безопасное хранение ключа

Если не хотите держать ключ прямо в конфиге — через переменную окружения:

export AITUNNEL_API_KEY="sk-aitunnel-xxx"

{
  "models": {
    "providers": {
      "aitunnel": {
        "apiKey": "${AITUNNEL_API_KEY}"
      }
    }
  }
}

Или через auth-профиль (ключ хранится в системном keychain):

{
  "auth": {
    "profiles": {
      "aitunnel:default": {
        "provider": "aitunnel",
        "mode": "api_key"
      }
    }
  }
}

openclaw auth set aitunnel:default --key "sk-aitunnel-xxx"

Мониторинг использования

Все запросы от OpenClaw отображаются в личном кабинете AITUNNEL:

• Расход токенов по каждой модели
• Стоимость запросов в рублях
• История использования
• Текущий баланс

Проверить статус провайдера:

openclaw models status
openclaw models list --provider aitunnel

Устранение неполадок

Gateway не запускается

OpenClaw строго валидирует openclaw.json — при ошибке в конфиге gateway не стартует.

Решение: openclaw doctor для диагностики, openclaw doctor --fix для автоисправления.

«No API key found for provider 'aitunnel'»

Решение:

1. Проверьте, что apiKey заполнен в секции aitunnel
2. Или проверьте auth-профиль: openclaw models auth list --provider aitunnel
3. Убедитесь, что нет лишних пробелов при копировании ключа

Ошибки авторизации (401/403)

Решение:

1. Проверьте ключ в личном кабинете
2. Убедитесь, что баланс положительный
3. Проверьте что baseUrl — https://api.aitunnel.ru/v1

Модель не работает

Решение:

1. Проверьте ID модели на странице моделей
2. Убедитесь, что модель есть в models.providers.aitunnel.models[] и в agents.defaults.models
3. Используйте формат aitunnel/<model-id>

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

• Документация OpenClaw
• GitHub OpenClaw
• Список моделей AITUNNEL
• Управление API ключами
• Личный кабинет AITUNNEL
• Поддержка в Telegram