#Как подключить Битрикс24 к OpenClaw — пошаговая инструкция

Пошаговая инструкция, как подключить Битрикс24 к самостоятельно развёрнутому OpenClaw через npm-плагин @ihazz/bitrix24. После прохождения сценария OpenClaw-агент переписывается с пользователями портала и работает с данными CRM, задач, календаря через API Вайбкода.

#Что в итоге получится

После выполнения шагов:

• В Битрикс24 Мессенджере появится бот, имя и аватар которого вы укажете в openclaw.json или в личном кабинете Вайбкода.
• Бот отвечает в личных сообщениях владельцу API-ключа.
• Бот отвечает в групповых чатах, если его упомянуть, и пишет с учётом контекста переписки.
• Агент через бота читает и обновляет данные портала: сделки, задачи, контакты, календарь — какие именно, определяется скоупами API-ключа.

Время настройки — 15–30 минут при готовом OpenClaw на сервере.

#Что нужно подготовить

1. Сервер с OpenClaw. Развёрнутый и работающий инстанс. Документация по установке самого OpenClaw — на сайте проекта OpenClaw. Рекомендуемая версия для совместимости с плагином — v2026.4.1.
2. Аккаунт на портале Битрикс24 с правами устанавливать приложения. Если портала ещё нет — создать Битрикс24 бесплатно.
3. Аккаунт в Вайбкоде на том же портале — потребуется для создания API-ключа на шаге 3. Регистрация — на vibecode.bitrix24.tech.

#Шаг 1: Установить плагин в OpenClaw

Подключиться к серверу с OpenClaw и поставить плагин:

openclaw plugins install @ihazz/bitrix24@latest

Команда установит последнюю стабильную версию пакета и зарегистрирует канал bitrix24 в OpenClaw. После установки в директории расширений OpenClaw появятся два каталога скиллов: skills/bitrix24/ и skills/vibe-platform/.

#Шаг 2: Разрешить плагин в openclaw.json

Открыть файл конфигурации OpenClaw и добавить разрешение для плагина:

{
  "plugins": {
    "allow": ["bitrix24"]
  }
}

Без этой строки OpenClaw откажется загружать плагин при старте.

#Шаг 3: Получить API-ключ Вайбкода

1. Открыть vibecode.bitrix24.tech и войти под учётной записью своего портала Битрикс24.
2. Перейти в раздел Ключи API в личном кабинете.
3. Нажать Создать ключ и выбрать скоупы:
   • imbot — обязательно, для регистрации бота и обмена сообщениями через бот-платформу.
   • vibe:ai — обязательно, для доступа агента к LLM-моделям Вайбкода через AI Router.
   • Доменные скоупы под задачи агента: crm для CRM, tasks для задач, calendar для расписания, im для пассивного режима наблюдения за чатами, и так далее.
4. Скопировать ключ формата vibe_api_… или vibe_app_… сразу после создания — он показывается только один раз.

Подробное описание типов ключей, скоупов и безопасного хранения — Ключи и авторизация.

#Шаг 4: Настроить openclaw.json

Открыть файл конфигурации OpenClaw и записать блок целиком. Шаблон ниже — рабочий минимум: подставьте API-ключ в двух местах, задайте botName и botCode, остальное оставьте как есть.

{
  "channels": {
    "bitrix24": {
      "enabled": true,
      "provider": "vibecode",
      "providerConfig": {
        "apiKey": "YOUR_API_KEY",
        "baseUrl": "https://vibecode.bitrix24.tech/v1"
      },
      "botName": "Помощник",
      "botCode": "openclaw_helper",
      "dmPolicy": "keyOwner",
      "showTyping": true,
      "capabilities": ["inlineButtons", "reactions"]
    }
  },
  "plugins": { "allow": ["bitrix24"] },
  "gateway": { "bind": "lan", "mode": "local", "controlUi": { "enabled": true } },
  "agents": { "defaults": { "model": "litellm/kimi-k2-6" } },
  "models": {
    "mode": "replace",
    "providers": {
      "litellm": {
        "baseUrl": "https://vibecode.bitrix24.tech/v1/ai",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-completions",
        "models": [{ "id": "bitrix/moonshotai/Kimi-K2.6", "name": "kimi-k2-6", "maxTokens": 65535 }]
      }
    }
  },
  "tools": { "exec": { "security": "full", "ask": "off" } }
}

Что подставляет пользователь:

• apiKey — ключ vibe_api_… из шага 3, в двух местах: channels.bitrix24.providerConfig.apiKey (для коннектора) и models.providers.litellm.apiKey (для LLM агента).
• botName — отображаемое имя бота в Битрикс24 Мессенджере.
• botCode — уникальный код бота, ASCII. Используется при регистрации; повторный запуск с тем же кодом подхватывает существующего бота, не создаёт нового.
• model — в шаблоне зафиксирована Kimi K2.6 (bitrix/moonshotai/Kimi-K2.6): та же модель, на которой работают Vibe-managed агенты — для консистентности поведения. Если нужна другая — поменять в agents.defaults.model и models.providers.litellm.models[0].id; список доступных моделей — `GET /v1/ai/models`.
• maxTokens — клиентский кап OpenClaw на длину ответа (models.providers.litellm.models[0].maxTokens). В шаблоне — 65535, потолок Kimi K2.6; уменьшайте, если нужны более короткие ответы или жёсткий бюджет токенов.

Что критично оставить как есть:

• models.mode: "replace" — без этого OpenClaw v2026.4.1 при старте 75–90 секунд тянет внешний каталог цен моделей и подвисает.
• tools.exec.security: "full" и ask: "off" — без этого каждый shell-вызов агента упирается в окно подтверждения, у которого в Битрикс24 Мессенджере нет интерфейса. Полный доступ безопасно держать только на отдельном сервере.

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

{
  "channels": {
    "bitrix24": {
      "providerConfig": {
        "apiKey": { "source": "env", "id": "B24_VIBE_API_KEY" }
      }
    }
  }
}

И задать B24_VIBE_API_KEY=vibe_api_… в окружении процесса OpenClaw. Тот же формат поддерживается для второго вхождения ключа в models.providers.litellm.apiKey.

Полный список параметров блока channels.bitrix24 — Расширенная настройка коннектора.

#Шаг 5: Запустить OpenClaw и проверить работу

Перезапустить OpenClaw, чтобы он подхватил обновлённую конфигурацию. В docker:

docker restart openclaw

Без docker — перезапустить процесс OpenClaw тем способом, которым он был запущен. Дождаться, пока gateway откроет порт 18789 — это сигнал, что плагин загружен и готов принимать события.

На старте плагин:

• Прочитает API-ключ и зарегистрирует бота на портале через API Вайбкода. Регистрация может запаздывать до 10 минут — нормально для первого запуска.
• Экспортирует переменные окружения VIBE_KEY, VIBE_BASE_URL, VIBE_PLATFORM_URL для скилла.
• Подключит LLM-провайдер litellm к AI Router Вайбкода.
• Начнёт опрашивать события Битрикс24 каждые несколько секунд.

#Проверить, что плагин жив

curl -s -o /dev/null -w '%{http_code}' --max-time 3 http://127.0.0.1:18789/

Любой код ответа кроме 000 означает, что gateway отвечает. Если OpenClaw запущен внутри docker — выполнить ту же команду через docker exec openclaw curl ….

#Проверить, что бот зарегистрирован на портале

curl -H "X-Api-Key: YOUR_API_KEY" \
  https://vibecode.bitrix24.tech/v1/bots

В ответе должен быть бот с code из openclaw.json. Если ответ пустой — подождать до 10 минут после запуска.

#Проверить чат с ботом

Открыть Битрикс24 Мессенджер и найти бота по имени из botName. Простой запрос: «Привет, что у меня сегодня?». Агент должен вызвать GET /v1/calendar-events и GET /v1/tasks и собрать единый ответ.

Перед записывающим действием агент показывает короткое подтверждение и ждёт «да» — это правило скилла. Например, попросите создать тестовую задачу и проверьте, что бот сначала спрашивает «Создать задачу „Проверить отчёт“ для меня с дедлайном завтра?».

Добавить бота в групповой чат, упомянуть его через [USER=<botId>]Имя[/USER] — он должен ответить только на упоминание.

Если на любом шаге что-то не сработало — раздел Что делать, если что-то не работает ниже.

#Что попробовать дальше

После того как базовая связка работает — настроить агента под конкретные задачи. Варианты сценариев:

• Утренний разбор полётов руководителя. Спросите бота «что у меня сегодня» — он соберёт события календаря и задачи на день, пометит просроченные, предупредит о пересечениях встреч.
• Менеджер по продажам в групповом чате отдела. Подключите groupPolicy: "open" или "allowlist" для нужных чатов, упомяните бота — попросите показать зависшие сделки или создать сделку для нового клиента прямо в чате.
• Постановщик задач команды. «Сделай задачу: проверить отчёт, ответственный — Сергей, до пятницы» — бот разберёт реплику, при необходимости задаст одно уточнение, покажет превью карточки задачи и создаст после подтверждения.

Для каждого из этих сценариев — нужный скоуп на API-ключе и подходящие политики доступа в openclaw.json. Контракт скилла и базовые curl-вызовы — Скилл Битрикс24.

#Что делать, если что-то не работает

Если симптом не из списка — проверить логи OpenClaw в режиме verboseLog: true и сверить ошибки с разделом Коды ошибок бот-платформы.

#Смотрите также

• Подключение Битрикс24 к OpenClaw — обзор раздела
• Скилл Битрикс24 — доступ агента к API портала
• Коннектор Битрикс24 — параметры конфигурации и политики
• Ключи и авторизация — типы ключей и скоупы
• Бот-платформа — справочник эндпоинтов
• Коды ошибок — общие коды ответов API
• Документация OpenClaw — установка самого OpenClaw