#Подключение Битрикс24 к OpenClaw

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

#Разделы документации

  • Скилл Битрикс24 — что агент получает: переменные окружения, формат вызовов API портала, базовые сценарии
  • Коннектор Битрикс24 — чат с пользователями портала: провайдеры, политики доступа, поддерживаемые возможности
  • Пошаговая инструкция — установка и проверка работы за 5 шагов

#Что входит

Плагин @ihazz/bitrix24 (MIT, текущая версия 2.3.2) — один npm-пакет, внутри которого логически выделяются два компонента:

  • Скилл Битрикс24 — учит агента вызывать API Вайбкода через curl и стандартный exec-инструмент OpenClaw, чтобы работать со сделками, задачами, контактами, календарём и другими данными портала. На старте плагин экспортирует в окружение переменные VIBE_KEY, VIBE_BASE_URL, VIBE_PLATFORM_URL — агент использует их в каждом вызове.
  • Коннектор Битрикс24 — регистрирует OpenClaw как бота на портале и пересылает сообщения между Битрикс24 Мессенджером и агентом. Поддерживает личные сообщения, групповые чаты с политиками доступа, реакции, файлы, инлайн-кнопки, индикатор набора и пассивный режим наблюдения за чатами.

#Что понадобится

  1. OpenClaw v2026.4.1 на собственной инфраструктуре.

  2. API-ключ Вайбкода (vibe_api_… или vibe_app_…) со скоупами:

    • imbot — обязательно, для регистрации бота и обмена сообщениями.
    • vibe:ai — обязательно, чтобы LLM-провайдер агента ходил в AI Router Вайбкода.
    • Доменные скоупы под задачи агента: crm для CRM, tasks для задач, calendar для расписания, и так далее.

    Как создать ключ — Ключи и авторизация.

  3. Доступ к порталу Битрикс24 — портал берётся из ключа, отдельно указывать его в openclaw.json не нужно.

#Быстрый старт

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

Terminal 
openclaw plugins install @ihazz/bitrix24@latest

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

JSON 
{
  "plugins": {
    "allow": ["bitrix24"]
  },
  "channels": {
    "bitrix24": {
      "provider": "vibecode",
      "providerConfig": {
        "apiKey": "YOUR_API_KEY"
      }
    }
  }
}

Перезапустить OpenClaw. Плагин зарегистрирует бота на портале через ключ, агент начнёт принимать сообщения в Битрикс24 Мессенджере.

Полная пошаговая инструкция с проверкой работы — Пошаговая инструкция.

#Как плагин работает с API Вайбкода

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

Бот-платформа. Коннектор регистрирует бота, опрашивает события чата, отправляет сообщения, реакции, файлы и индикатор набора через /v1/bots/*. Полный справочник — Бот-платформа.

Данные портала. Скилл запрашивает сделки, задачи, контакты, календарь и другие сущности через /v1/<entity>. Какие сущности доступны конкретному ключу, определяют его доменные скоупы. Полный каталог — Справочник сущностей.

AI Router. LLM-провайдер агента ходит в /v1/ai/chat/completions за моделями Вайбкода. Для OpenClaw-агента в BYO-режиме мы рекомендуем bitrix/moonshotai/Kimi-K2.6 — ту же модель, на которой работают Vibe-managed агенты. Список доступных моделей — Модели.

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

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

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