openclaw-channel-b24

Плагин канала Bitrix24 для OpenClaw — подключает чат-бота Bitrix24 через REST API (imbot.*).

Установка

Из npm (рекомендуется)

openclaw plugins install openclaw-channel-b24

Локально (для разработки/тестирования без публикации на npm)

openclaw plugins install --link C:\path\to\openclaw-channel-b24

Обновление

openclaw plugins update openclaw-channel-b24

Затем перезапустите gateway:

systemctl --user restart openclaw-gateway

Если версия не обновляется

openclaw plugins update может использовать кешированную версию npm. Чтобы принудительно обновить до нужной версии:

npm cache clean --force
cd /tmp && npm pack openclaw-channel-b24@VERSION
tar -xzf openclaw-channel-b24-VERSION.tgz
rm -rf ~/.openclaw/extensions/openclaw-channel-b24
mv package ~/.openclaw/extensions/openclaw-channel-b24
systemctl --user restart openclaw-gateway

Замените VERSION на нужную версию (например, 1.0.19).

Проверить установленную версию:

cat ~/.openclaw/extensions/openclaw-channel-b24/package.json | grep version

Проверить последнюю версию в npm:

npm view openclaw-channel-b24 version

Настройка

1. Получите входящий вебхук Bitrix24

В портале: Приложения -> Вебхуки -> Добавить входящий вебхук

Скопируйте URL вида: https://my-portal.bitrix24.com/rest/1/my-secret-token/

2. Настройте параметры

openclaw config set channels.b24.webhookUrl https://vostok.bitrix24.ru/rest/1/TOKEN/
openclaw config set channels.b24.botName OpenClaw
openclaw config set channels.b24.botCode openclaw_bot

• webhookUrl — URL входящего вебхука (токен извлекается автоматически)
• botName — Имя бота в Bitrix24
• botCode — Уникальный код бота (латиница, без пробелов)

gatewayUrl задавать не нужно — плагин определяет публичный IP автоматически и строит URL вида http://:<gateway.port>. Если нужен кастомный домен или HTTPS:

openclaw config set channels.b24.gatewayUrl https://your-domain.com

3. Перезапустите gateway

openclaw gateway restart

При запуске gateway плагин автоматически:

• зарегистрирует бота в Bitrix24 через imbot.register
• сохранит BOT_ID в конфиге
• начнёт принимать входящие сообщения

Никаких дополнительных команд запускать не нужно.

Использование

Напишите боту в Bitrix24 — он ответит через агента OpenClaw.

Связать диалог с агентом:

openclaw pair b24 <DIALOG_ID> <agent-name>

DIALOG_ID — ID пользователя (например: 1) или группового чата (например: chat123).

Удаление бота

Чтобы удалить бота из Bitrix24, очистите botId из конфигурации:

openclaw config set channels.b24.botId ""

Затем удалите бота вручную на портале Bitrix24: Приложения -> Роботы и чат-боты -> найти бота -> удалить.

Логи и отладка

Все события плагина выводятся с префиксом [b24] в лог OpenClaw.

Просмотр логов в реальном времени

Логи плагина выводятся в stdout/stderr процесса gateway. Чтобы видеть их, запустите gateway в foreground-режиме:

openclaw gateway stop
openclaw gateway start --foreground

Или проверьте вывод через журнал системы (если gateway запускается как systemd-сервис):

journalctl -u openclaw-gateway -f

Уровни сообщений

[b24] Channel started. Webhook handler registered.   -- плагин запущен
[b24] Auto-detected gateway URL: http://1.2.3.4:18789 -- URL определён автоматически
[b24] Registering bot OpenClaw...                    -- регистрация бота
[b24] Bot registered! BOT_ID = 42                   -- успешная регистрация
[b24] Incoming: user=5 dialog=1 text=Привет          -- входящее сообщение
[b24] No agent route for dialog 1, message dropped. -- диалог не привязан к агенту

Типичные проблемы

Бот зарегистрирован, но не отвечает:

• Проверьте, что диалог привязан к агенту: openclaw pair b24 <DIALOG_ID>
• Убедитесь что gateway доступен извне: curl http://:/channels/b24/webhook

Ошибка при регистрации (BOT_ID_ERROR, ACCESS_DENIED):

• Проверьте webhookUrl — в нём должен быть действующий токен
• Убедитесь что вебхук имеет права на scope imbot

Битрикс не шлёт события (бот молчит на входящие):

• Проверьте eventHandlerUrl в логах: он должен быть доступен с серверов Bitrix24
• Если VPS за NAT или firewall — пробросьте порт или задайте gatewayUrl вручную
• Проверьте логи входящих запросов в foreground-режиме gateway

Просмотр текущей конфигурации плагина

openclaw config get channels.b24

Сброс регистрации и повтор

openclaw config set channels.b24.botId ""
openclaw gateway restart

Архитектура

Bitrix24
  POST /channels/b24/webhook  (ONIMBOTMESSAGEADD)
    -> OpenClaw gateway
       -> b24Plugin.handleIncomingEvent()
          -> rt.channel.routing.resolveAgentRoute()
             -> агент отвечает
                -> imbot.message.add -> Bitrix24

Файлы

index.ts              Точка входа плагина
src/channel.ts        Основная логика канала (ChannelPlugin)
src/bitrix.ts         REST-обёртки для imbot API
src/config-schema.ts  JSON Schema конфигурации
src/types.ts          TypeScript-типы

Поддерживаемые события Bitrix24

ONIMBOTMESSAGEADD  ->  Входящее сообщение -> агент
ONIMJOINCHAT       ->  Бот добавлен в чат (лог)
ONIMBOTDELETE      ->  Бот удалён с портала (лог)

Лицензия

MIT