#Коннектор Битрикс24 для OpenClaw

Коннектор Битрикс24 — часть плагина @ihazz/bitrix24, которая регистрирует OpenClaw как чат-бота на портале и пересылает сообщения между Битрикс24 Мессенджером и агентом. Поддерживает личные сообщения, групповые чаты с политиками доступа, реакции, файлы, инлайн-кнопки и пассивный режим наблюдения за чатами.

#Что делает

После настройки коннектор:

  • Регистрирует OpenClaw как бота через API Вайбкода — пользователь не выполняет регистрацию вручную.
  • Опрашивает входящие события через GET /v1/bots/:botId/events каждые несколько секунд и передаёт сообщения агенту.
  • Преобразует Markdown-ответы агента в BBCode Битрикс24 при отправке.
  • Делит длинные сообщения на части по 20 000 символов (предел API мессенджера Битрикс24).
  • Кеширует историю переписки в оперативной памяти — агент видит контекст разговора без дополнительных вызовов API.

Регистрация бота, опрос событий, отправка ответов — внутренние операции коннектора. Пользователю достаточно создать API-ключ в личном кабинете Вайбкода, положить его в openclaw.json и запустить OpenClaw.

#Установка

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

Terminal 
openclaw plugins install @ihazz/bitrix24@latest

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

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

Дальше — настройка канала.

#Минимальная конфигурация

Ниже — только блок channels.bitrix24. Он входит в общий openclaw.json, где также нужны блоки plugins, gateway, agents, models и tools — без них OpenClaw v2026.4.1 либо подвисает на старте, либо не может работать с ботом. Полный шаблон openclaw.json со всеми блоками — на странице Пошаговая инструкция.

JSON 
{
  "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"]
    }
  }
}

YOUR_API_KEY — ключ формата vibe_api_… или vibe_app_… из личного кабинета Вайбкода. Скоупы на ключе: обязательно imbot (бот-платформа) и vibe:ai (LLM агента через AI Router), плюс доменные скоупы под задачи агента — crm, tasks, calendar и так далее. baseUrl указывает корень API Вайбкода и подставляется как есть.

botCode — уникальный код бота, ASCII. Используется при регистрации; повторный запуск с тем же кодом подхватывает существующего бота.

#Основные параметры

Шесть ключевых параметров блока channels.bitrix24. Полный список из 22 параметров, включая политики доступа, режим наблюдения и переопределения групп, — на странице Расширенная настройка коннектора.

Параметр По умолчанию Описание
provider — Всегда vibecode. Подключение через прокси Вайбкода.
providerConfig — { apiKey, baseUrl }. apiKey — ключ Вайбкода, baseUrl — https://vibecode.bitrix24.tech/v1.
botName OpenClaw Отображаемое имя бота в Битрикс24 Мессенджере.
botCode openclaw_<userId> Уникальный идентификатор бота. Фиксировать вручную, если на одном портале несколько ботов.
dmPolicy keyOwner Кто может писать боту в личных сообщениях. По умолчанию — только владелец ключа.
groupPolicy keyOwner Кто может упоминать бота в групповых чатах. По умолчанию — только владелец ключа.
requireMention true Бот отвечает в группах только при упоминании. Без упоминания сообщение всё равно попадает в контекст.
showTyping true Показывать индикатор набора перед ответом.

#Возможности чата

  • Реакции на сообщения — преобразование эмодзи в код реакции Битрикс24 происходит на стороне коннектора.
  • Инлайн-кнопки через channelData.bitrix24.keyboard (нативный формат Битрикс24) или универсальный формат OpenClaw channelData.telegram.buttons с автоматической конвертацией.
  • Action-ссылки в Markdown — send:, put:, tel:, user:, chat:, context:, timestamp: — преобразуются в нативный BBCode Битрикс24.
  • Rich ATTACH-блоки — карточки MESSAGE, LINK, IMAGE, FILE, DELIMITER, GRID, USER через channelData.bitrix24.attach или channelData.bitrix24.attachments. Это отдельный канал доставки от стандартной загрузки файлов через mediaUrl.
  • Загрузка и скачивание файлов через бот-платформу.
  • Нативные ответы и пересылки через бот-платформу с полем replyId — коннектор сохраняет контекст ответа в оперативной памяти и подгружает сообщения через API при необходимости.
  • Редактирование и удаление сообщений через бот-платформу.
  • Slash-команды — регистрация и реакция на их вызов в чате.
  • Поточная доставка ответа: коннектор обновляет одно и то же сообщение в чате по мере того, как агент генерирует текст, ограничивая частоту обновлений.

Полный список эндпоинтов, через которые работает коннектор — Бот-платформа.

#Хранение ключа в переменной окружения

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

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

Объект указывается полем source: "env" и id с именем переменной окружения. На старте плагин подменяет ссылку фактическим значением.

#Совместимость с OpenClaw

Версия OpenClaw Статус
v2026.4.1 Минимальная поддерживаемая. На ней проверены все возможности коннектора.
v2026.4.5 Содержит известную проблему: скиллы плагинов не разрешаются из директории расширений, бот может не отвечать на сообщения. До исправления оставаться на v2026.4.1.

#Проверка работы

  1. Запустить OpenClaw с включённым плагином.
  2. Открыть личный чат с ботом в Битрикс24 Мессенджере, отправить сообщение.
  3. Убедиться, что бот показывает индикатор набора и присылает ответ.
  4. При политике dmPolicy: "keyOwner" — проверить, что ответ приходит только владельцу ключа, а другому пользователю бот не отвечает.
  5. Добавить бота в групповой чат, разрешённый в groupAllowFrom, и упомянуть его через [USER=<botId>]Имя[/USER].
  6. Убедиться, что бот отвечает на упоминание и молчит без него (при requireMention: true).
  7. Ответить на одно из своих недавних сообщений — проверить, что бот сохраняет контекст ответа.

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

Список типичных симптомов и проверок собран на странице Пошаговая инструкция — там же, где описана установка.

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