#Расширенная настройка коннектора Битрикс24

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

#Идентификация бота

botToken — токен, по которому Битрикс24 узнаёт бота среди остальных приложений на портале. Если не задан в конфигурации, коннектор вычисляет его автоматически из API-ключа. Указывать botToken в конфигурации явно нужно только тогда, когда исходные учётные данные могут поменяться, — иначе после смены ключа на портале появится новый бот вместо обновления существующего.

botCode — внутренний идентификатор бота. По умолчанию коннектор регистрирует бота как openclaw_<userId>, где <userId> — идентификатор пользователя, к которому привязан ключ. При повторной регистрации с тем же botCode коннектор подхватывает существующего бота. Чтобы развернуть на одном портале сразу несколько ботов на одном ключе, добавляются суффиксы _2, _3 и так далее.

#Политики доступа

#Личные сообщения

#Групповые чаты

groupAllowFrom отдельно ограничивает, в каких чатах разрешено работать боту. Чат, упомянутый явно в groups, считается разрешённым автоматически.

#Переопределения для конкретных групп

{
  "groups": {
    "chat615": {
      "groupPolicy": "open",
      "requireMention": false
    },
    "chat208": {
      "watch": [
        { "userId": "77", "topics": ["договор", "оплата"], "mode": "reply" }
      ]
    },
    "*": {
      "requireMention": true
    }
  }
}

Порядок применения: точное совпадение dialogId имеет приоритет над числовым chatId, оба перекрывают *.

#Режим наблюдения

agentMode: true включает пассивное чтение всей истории группового чата без ответов от лица бота. Коннектор подписывает владельца ключа на пользовательские события Битрикс24 Мессенджера и опрашивает их вместе с обычными событиями бота.

Когда применять:

• Бот молчит в групповом чате, но запоминает контекст и отвечает в личных сообщениях, если владелец задал вопрос «что обсуждали в чате X».
• В сочетании с agentWatch — следить за чатом и присылать владельцу уведомления, когда упомянули нужного человека или ключевую тему.

{
  "agentMode": true,
  "agentWatch": {
    "chat615": [
      { "userId": "77", "topics": ["договор", "оплата"], "mode": "notifyOwnerDm" }
    ]
  }
}

В режиме notifyOwnerDm бот отправляет владельцу личное сообщение со ссылкой на оригинал. Если нативная пересылка через Битрикс24 не работает — отправляет цитату как запасной путь.

Подписка на пользовательские события действует на весь портал. В конфигурации с несколькими аккаунтами на одном портале — agentMode: true ставится только на одном аккаунте, иначе подписки будут конфликтовать.

#Несколько аккаунтов

В одном инстансе OpenClaw можно запустить несколько ботов — например, для разных ролей на одном портале:

{
  "channels": {
    "bitrix24": {
      "provider": "vibecode",
      "providerConfig": { "apiKey": "MAIN_KEY" },
      "botName": "Помощник",
      "agentMode": true,
      "accounts": {
        "second": {
          "providerConfig": { "apiKey": "SECOND_KEY" },
          "botName": "Аналитик",
          "agentMode": false
        }
      }
    }
  }
}

Корневой блок описывает основной аккаунт, дополнительные идут в accounts и наследуют корневые настройки, переопределяя нужные.

Ограничение: рабочее пространство OpenClaw, история сессий и хранилище файлов общие для всех аккаунтов в одном инстансе. Для разных порталов на боевом стенде — отдельный инстанс OpenClaw на каждый, чтобы данные не пересекались.

#Полная таблица параметров

Полный список параметров блока channels.bitrix24 в openclaw.json. Все параметры опциональны, кроме provider и providerConfig.

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

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