Настройте ИИ-ассистента Clawdbot для групповых чатов. Узнайте об обнаружении групп, обработке сообщений, упоминаниях и многопользовательских беседах.

Обзор групп Clawdbot

Clawdbot поддерживает групповые беседы во всех мессенджерах. Это руководство охватывает настройку групповых чатов, маршрутизацию сообщений и паттерны многопользовательского взаимодействия.

Обнаружение групп

Автоматическое обнаружение

Clawdbot автоматически обнаруживает групповые чаты:

Провайдер	Метод обнаружения
WhatsApp	Суффикс ID чата `@g.us`
Telegram	`chat.type` в обновлении
Discord	Тип канала
WeChat	ID групповой комнаты
Feishu	Поле типа чата

Ключи сессий

Групповые сессии используют отдельные ключи:

agent:<agentId>:<channel>:group:<groupId>

Конфигурация

Включение поддержки групп

{
  "providers": {
    "whatsapp": {
      "groups": {
        "enabled": true,
        "mentionOnly": true
      }
    }
  }
}

Настройки группы

Настройка	По умолчанию	Описание
`enabled`	true	Разрешить групповые сообщения
`mentionOnly`	false	Отвечать только на упоминания
`allowList`	[]	Разрешённые ID групп
`denyList`	[]	Заблокированные ID групп

Обработка упоминаний

Обнаружение упоминаний

Clawdbot обнаруживает упоминания:

{
  "groups": {
    "mentionPatterns": [
      "@bot",
      "@clawdbot",
      "hey bot"
    ]
  }
}

Режимы ответа

Режим	Поведение
`mention_only`	Отвечать только при упоминании
`all_messages`	Отвечать на все сообщения
`smart`	Использовать контекст для решения

Маршрутизация сообщений

Группа vs ЛС

Атрибут	ЛС	Группа
Ключ сессии	`agent:<id>:<main>`	`agent:<id>:<ch>:group:<gid>`
Контекст	Приватный	Общий
История	По пользователю	По группе

Правила маршрутизации

{
  "bindings": [
    {
      "agentId": "work",
      "match": {
        "channel": "whatsapp",
        "peer": { "kind": "group", "id": "[email protected]" }
      }
    }
  ]
}

Многопользовательский контекст

Идентификация пользователей

Clawdbot отслеживает пользователей в группах:

{
  "message": {
    "sender": {
      "id": "user123",
      "name": "John",
      "role": "member"
    },
    "group": {
      "id": "group456",
      "name": "Team Chat"
    }
  }
}

Стратегии контекста

Стратегия	Описание
`shared`	Все пользователи делят контекст
`per_user`	У каждого пользователя отдельный контекст
`hybrid`	Общая история, память по пользователям

Групповые команды

Встроенные команды

Команда	Описание
`/status`	Статус бота в группе
`/help`	Доступные команды
`/mute`	Приостановить ответы бота
`/unmute`	Возобновить ответы бота

Пользовательские команды

{
  "groups": {
    "commands": {
      "prefix": "/",
      "custom": [
        {
          "name": "report",
          "action": "generate_report"
        }
      ]
    }
  }
}

Ограничение частоты

Лимиты на уровне группы

{
  "groups": {
    "rateLimit": {
      "messagesPerMinute": 10,
      "cooldownSeconds": 5
    }
  }
}

Безопасность

Административный контроль

Только администраторы могут настраивать бота
Отключение/включение звука требует разрешений
Списки разрешённых/заблокированных на уровне группы

Конфиденциальность

Групповые сообщения изолированы от ЛС
Нет обмена контекстом между группами
Соблюдение настроек конфиденциальности провайдера

Следующие шаги

Концепции Clawdbot - Основные концепции
Каналы Clawdbot - Настройка каналов
Шлюз Clawdbot - Настройка шлюза

Группы Clawdbot