Академия Pioneer Labs · гайд

Настройка OpenClaw: как подключить Claude, GPT-6, Gemini и Kimi по одному ключу

Обновлено · 15 мин настройка

Коротко

Чтобы подключить OpenClaw к Пионер ИИ-шлюзу, добавьте провайдера в ~/.openclaw/openclaw.json с baseUrl https://pioneerlabs.ru/api/gateway/v1, api: "openai-completions", вашим ключом и нужными моделями, а модель по умолчанию задайте как pioneer/anthropic/claude-sonnet-5.5. После этого OpenClaw отвечает в Telegram, WhatsApp, Slack и других каналах моделями Claude, GPT-6, Gemini или Kimi по одному ключу.

Параметры подключения
Base URL (OpenAI-совместимый)https://pioneerlabs.ru/api/gateway/v1
Base URL для Claude Code и Anthropic SDKhttps://pioneerlabs.ru/api/anthropic
КлючAuthorization: Bearer <ключ> — страница «API-ключ» в кабинете
Модель по умолчаниюanthropic/claude-sonnet-5.5
Бесплатная модель для проверкиmb-auto/free

Что такое OpenClaw

OpenClaw (раньше Clawdbot и Moltbot) — открытый личный ИИ-ассистент. Процесс-шлюз работает на вашем компьютере или сервере, подключается к мессенджерам, которыми вы уже пользуетесь, — Telegram, WhatsApp, Slack, Discord, Microsoft Teams, iMessage, Google Chat, Signal и другим, — и действует с помощью инструментов, навыков из каталога ClawHub и задач по расписанию.

OpenClaw нужен провайдер моделей. В конфиге можно указать любой OpenAI-совместимый API как свой (custom) провайдер — так и подключается Пионер ИИ-шлюз: один ключ и один баланс организации для Claude, GPT, Gemini, Grok и открытых моделей вместо отдельного аккаунта в каждой лаборатории.

Настройка по шагам

  1. Шаг 1. Получите API-ключ Пионер ИИ-шлюза

    Пионер ИИ-шлюз работает для компаний и их сотрудников, по приглашениям. Компания оставляет заявку, мы заводим организацию, а сотрудники получают приглашение на почту с паролем. Сотрудник входит и создаёт ключ на странице «API-ключ». Один ключ открывает все текстовые модели, а также модели изображений и видео.

    Баланс организации в рублях, без VPN и зарубежной карты, доступ — по заявке. Подписки нет, каждый запрос оплачивается по цене модели, а расход виден по каждому сотруднику.

    Сохраните ключ в переменной окружения, чтобы он не попал в конфиг, которым вы делитесь с коллегами:

    # ~/.zshrc или ~/.bashrc
    export PIONEER_API_KEY="ваш-ключ-pioneer"
    curl https://pioneerlabs.ru/api/gateway/v1/chat/completions \
      -H "Authorization: Bearer $PIONEER_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"model": "anthropic/claude-sonnet-5.5", "messages": [{"role": "user", "content": "Ответь: OK"}]}'

    Проверьте ключ до настройки агента. Ответ в JSON с полем choices значит, что ключ, баланс и модель работают:

  2. Шаг 2. Установите OpenClaw

    На macOS, Linux или WSL2 (после установки скрипт сам запустит первичную настройку):

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

    Через npm: npm install -g openclaw@latest --allow-scripts=openclaw, затем openclaw onboard --install-daemon. На Windows: iwr -useb https://openclaw.ai/install.ps1 | iex.

  3. Шаг 3. Добавьте Пионер ИИ-шлюз как свой провайдер

    Быстрее всего — первичная настройка со своим API-ключом. Без интерактива OpenClaw требует флаг --accept-risk: им вы подтверждаете, что агент получает полный доступ к компьютеру. Если не указать --custom-model-id, OpenClaw прочитает /models и сохранит все найденные модели:

    openclaw onboard --non-interactive --accept-risk \
      --auth-choice custom-api-key \
      --custom-base-url "https://pioneerlabs.ru/api/gateway/v1" \
      --custom-model-id "anthropic/claude-sonnet-5.5" \
      --custom-api-key "$PIONEER_API_KEY" \
      --custom-compatibility openai

    Или впишите провайдера в ~/.openclaw/openclaw.json вручную (OpenClaw перечитывает файл при сохранении):

    {
      agents: { defaults: { model: { primary: "pioneer/anthropic/claude-sonnet-5.5" } } },
      models: {
        mode: "merge",
        providers: {
          pioneer: {
            baseUrl: "https://pioneerlabs.ru/api/gateway/v1",
            apiKey: "${PIONEER_API_KEY}",
            api: "openai-completions",
            models: [
              { id: "anthropic/claude-sonnet-5.5", name: "Claude Sonnet 5.5",
                input: ["text", "image"], contextWindow: 1000000, maxTokens: 32000 },
              { id: "openai/gpt-6.1-sol", name: "GPT-6.1 Sol",
                input: ["text", "image"], contextWindow: 1050000, maxTokens: 32000 },
              { id: "google/gemini-3.8-flash", name: "Gemini 3.8 Flash",
                input: ["text", "image"], contextWindow: 1048576, maxTokens: 32000 },
              { id: "mb-auto/free", name: "Auto Free",
                input: ["text"], contextWindow: 128000, maxTokens: 8000 }
            ]
          }
        }
      }
    }

    Ссылка на модель делится по первому слешу: в pioneer/anthropic/claude-sonnet-5.5 провайдер — pioneer, а модель — anthropic/claude-sonnet-5.5. Каждая модель, на которую вы ссылаетесь, должна быть в списке models. Конфиг проверяется строго: опечатка в ключе остановит шлюз — смотрите лог.

  4. Шаг 4. Подключите канал и проверьте

    Откройте панель управления по адресу http://127.0.0.1:18789 или снова запустите первичную настройку, чтобы подключить Telegram, WhatsApp или Slack. Напишите ассистенту — ответит модель, указанная в primary.

Какую модель выбрать

OpenClaw вызывает инструменты почти на каждом ходу, поэтому нужна модель с надёжным вызовом инструментов. По умолчанию — Claude Sonnet 5.5; на каналы с большим потоком сообщений поставьте модель подешевле. Укажите input: ["text", "image"] у моделей, которые понимают изображения, чтобы до них доходили фото из чата.

ID моделиКогда брать
anthropic/claude-sonnet-5.5Модель по умолчанию для агента: надёжно вызывает инструменты, держит длинные задачи, контекст 1 млн токенов.
anthropic/claude-opus-5.5Сложные многошаговые задачи, ревью кода, аналитика, где ошибка дороже токенов.
openai/gpt-6.1-solФлагман OpenAI: альтернатива Claude для кода и рассуждений.
google/gemini-3.8-flashБыстро и недорого: длинные документы, таблицы, разбор входящих.
moonshotai/kimi-k3.1-proСильная открытая модель для агентов и кода.
z-ai/glm-5.3Открытая модель для кода и инструментов, хорошее соотношение цены и качества.
deepseek/deepseek-v4.1-flashМассовые рутинные задачи: классификация, черновики, саммари.
mb-auto/freeБесплатно, для проверки настройки. Контекст 128 тыс., слабее в вызове инструментов; не отправляйте конфиденциальные данные.

Все модели с ценами и размером контекста — в каталоге. Каждая модель вызывается одним и тем же ключом.

Что можно делать

Больше 20 каналов

Telegram, WhatsApp, Slack, Discord, Teams, iMessage, Google Chat, Signal и другие настраиваются в разделе channels одного шлюза.

Задачи cron

Регулярные задачи ставятся командой openclaw cron add --name "Утренняя сводка" --cron "0 8 * * 1-5" --message "…", а ответ публикуется в канал.

Навыки и плагины

Устанавливайте навыки из ClawHub или пишите свои, чтобы научить ассистента процессам вашей компании.

Несколько моделей сразу

Перечислите несколько моделей у одного провайдера и переключайтесь между ними для разных агентов и задач — всё списывается с одного баланса организации.

Сценарии для бизнеса

Администратор в Telegram для студии или салона

Клиенты пишут в Telegram компании; OpenClaw отвечает на вопросы о часах работы, ценах и свободных окнах по вашему FAQ, записывает заявки в таблицу и передаёт сложные случаи человеку.

Задача для агента:

Ты отвечаешь клиентам нашей студии в Telegram. Используй только факты из ~/business/faq.md. Если клиент хочет записаться, узнай имя, дату, время (по Москве) и услугу и добавь строку в ~/business/bookings.csv. Если не уверен в ответе, скажи, что менеджер ответит в течение часа, и напиши мне в личные сообщения.

Помощник отдела продаж

Менеджер пишет в рабочий чат «подготовь меня к звонку с ООО „Ромашка“»; ассистент собирает заметки по клиенту (через навык или MCP-сервер вашей CRM, если он есть), свежие новости компании и набрасывает тезисы для разговора.

Контент прямо из чата

Маркетолог присылает фото товара в Telegram; OpenClaw пишет пост для Telegram-канала и описание для карточки на Ozon или Wildberries, а через API изображений и видео Пионер ИИ-шлюза делает ролик 9:16 тем же ключом.

Ежедневная операционная сводка

Задача cron каждый вечер в 19:00 по Москве собирает заказы, возвраты и обращения в поддержку из выгрузок и публикует короткую сводку в рабочий чат.

Если не работает

401 Unauthorized

Ключ не указан или скопирован с ошибкой, либо агент не прочитал переменную окружения (перезапустите агент после export). Проверьте ключ командой curl из шага 1.

402 Payment Required

Закончился баланс организации. Администратору нужно пополнить его (страница «Баланс»); пока баланс пуст, проверять настройку можно на mb-auto/free.

Model not found

ID модели должен точно совпадать с каталогом, вместе с префиксом лаборатории: anthropic/claude-sonnet-5.5, а не claude-sonnet-5.5. Базовый URL должен заканчиваться на /v1.

Шлюз не запускается после правки openclaw.json

OpenClaw отклоняет неизвестные ключи. Сравните файл с примером из шага 3, посмотрите лог шлюза или используйте openclaw config set и панель управления вместо ручной правки.

«Unknown model» для модели, которая есть в каталоге

Добавьте её в массив models провайдера с точным ID и ссылайтесь на неё как pioneer/<id>.

Частые вопросы

Может ли OpenClaw работать с Claude без ключа Anthropic?

Да. Через Пионер ИИ-шлюз OpenClaw получает доступ к anthropic/claude-sonnet-5.5, anthropic/claude-opus-5.5 и anthropic/claude-fable-5.2 по вашему ключу Пионер ИИ-шлюза; аккаунт Anthropic не нужен.

Какое значение `api` указать?

openai-completions с базовым URL https://pioneerlabs.ru/api/gateway/v1. Пионер ИИ-шлюз также поддерживает OpenAI Responses API и Anthropic Messages API, но Chat Completions — самый проверенный путь.

Сколько это стоит?

Вы платите за токены по цене модели с баланса организации в рублях. Подписки и платы за места нет, поэтому агент, который простаивает, ничего не стоит. Цены в рублях за миллион токенов — в каталоге; mb-auto/free бесплатна.

Нужны ли отдельные аккаунты Anthropic, OpenAI или Google?

Нет. Один ключ Пионер ИИ-шлюза открывает Claude, GPT, Gemini, Grok, Kimi, GLM, DeepSeek, Qwen и MiniMax. Модель меняется сменой ID, а не провайдера или ключа, а оплата идёт с одного рублёвого баланса организации.

Это работает из России без VPN?

Да. Агент обращается к https://pioneerlabs.ru/api/gateway/v1, VPN для запросов к моделям не нужен, зарубежная карта тоже: запросы оплачиваются с баланса организации в рублях.

Где OpenClaw хранит настройки?

В ~/.openclaw/openclaw.json (формат JSON5). Держите ключ в переменной окружения PIONEER_API_KEY и ссылайтесь на неё как ${PIONEER_API_KEY} — тогда файл можно спокойно копировать в резервные копии.

Пионер ИИ-шлюз · один API для всех моделей

Claude, GPT, Gemini, Kimi, GLM и DeepSeek в любом агенте — один ключ и один баланс.

Без VPN и иностранной карты: один баланс в рублях на всю команду, сотрудники получают свои API-ключи, расход виден по каждому. Доступ по заявке.

Источники

Другие гайды Академии Pioneer Labs