Группы

​

Введение для начинающих (2 минуты)

• Группы ограничены (groupPolicy: "allowlist"); отправители в группах блокируются, пока их не добавят в список разрешённых.
• Для ответов требуется упоминание, если вы не отключили проверку упоминаний для группы.
• Итоговый текст ответа автоматически публикуется в комнате (visibleReplies: "automatic").

groupPolicy? disabled -> отбросить
groupPolicy? allowlist -> группа разрешена? нет -> отбросить
requireMention? yes -> есть упоминание? нет -> сохранить только для контекста
упоминание/ответ/команда/личное сообщение -> запрос пользователя
общение в постоянно активной группе -> запрос пользователя или событие комнаты, если настроено

​

Видимые ответы

{
  messages: {
    groupChat: {
      unmentionedInbound: "room_event",
    },
  },
}

{
  messages: {
    groupChat: {
      visibleReplies: "message_tool",
    },
  },
}

{
  messages: {
    visibleReplies: "message_tool",
  },
}

​

Видимость контекста и списки разрешённых

• Авторизация запуска: кто может активировать агента (groupPolicy, groups, groupAllowFrom, списки разрешённых для отдельных каналов).
• Видимость контекста: какой дополнительный контекст передаётся модели (текст ответа или цитаты, история ветки, метаданные пересылки).

​

Ключи сеансов

• Групповые сеансы используют ключи сеансов agent:<agentId>:<channel>:group:<id> (комнаты и каналы используют agent:<agentId>:<channel>:channel:<id>).
• В темах форумов Telegram к идентификатору группы добавляется :topic:<threadId>, поэтому у каждой темы есть собственный сеанс.
• Личные чаты используют основной сеанс (или отдельные сеансы для каждого отправителя, если настроен session.dmScope).
• Heartbeat выполняется в настроенном сеансе Heartbeat (по умолчанию в основном сеансе агента); групповые сеансы не запускают собственные Heartbeat.

​

Схема: личные сообщения + публичные группы (один агент)

• Личные сообщения: полный набор инструментов (хост)
• Группы: песочница и ограниченный набор инструментов

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main", // группы/каналы являются неосновными -> выполняются в песочнице
        scope: "session", // наиболее строгая изоляция (один контейнер на группу/канал)
        workspaceAccess: "none",
      },
    },
  },
  tools: {
    sandbox: {
      tools: {
        // Если allow не пуст, всё остальное блокируется (deny по-прежнему имеет приоритет).
        allow: ["group:messaging", "group:sessions"],
        deny: ["group:runtime", "group:fs", "group:ui", "nodes", "cron", "gateway"],
      },
    },
  },
}

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main",
        scope: "session",
        workspaceAccess: "none",
        docker: {
          binds: [
            // hostPath:containerPath:mode
            "/home/user/FriendsShared:/data:ro",
          ],
        },
      },
    },
  },
}

• Ключи конфигурации и значения по умолчанию: Конфигурация Gateway
• Отладка причин блокировки инструмента: Песочница, политика инструментов и расширенные привилегии
• Подробнее о подключении каталогов: Песочница

​

Отображаемые метки

• Метки интерфейса используют displayName, если он доступен, в формате <channel>:<token>.
• #room зарезервирован для комнат и каналов; групповые чаты используют g-<slug> (нижний регистр, пробелы заменяются на -, #@+._- сохраняется). Очень длинные непрозрачные идентификаторы сокращаются до стабильного токена, чтобы полные идентификаторы маршрутов не отображались в интерфейсе.

​

Политика групп

{
  channels: {
    whatsapp: {
      groupPolicy: "disabled", // "open" | "disabled" | "allowlist"
      groupAllowFrom: ["+15551234567"],
    },
    telegram: {
      groupPolicy: "disabled",
      groupAllowFrom: ["123456789"], // числовой идентификатор пользователя Telegram (при настройке определяется @username)
    },
    signal: {
      groupPolicy: "disabled",
      groupAllowFrom: ["+15551234567"],
    },
    imessage: {
      groupPolicy: "disabled",
      groupAllowFrom: ["chat_id:123"],
    },
    msteams: {
      groupPolicy: "disabled",
      groupAllowFrom: ["user@org.com"],
    },
    discord: {
      groupPolicy: "allowlist",
      guilds: {
        GUILD_ID: { channels: { help: { enabled: true } } },
      },
    },
    slack: {
      groupPolicy: "allowlist",
      channels: { "#general": { enabled: true } },
    },
    matrix: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["@owner:example.org"],
      groups: {
        "!roomId:example.org": { enabled: true },
        "#alias:example.org": { enabled: true },
      },
    },
  },
}

​

Требование упоминания (по умолчанию)

{
  channels: {
    whatsapp: {
      groups: {
        "*": { requireMention: true },
        "123@g.us": { requireMention: false },
      },
    },
    telegram: {
      groups: {
        "*": { requireMention: true },
        "123456789": { requireMention: false },
      },
    },
    imessage: {
      groups: {
        "*": { requireMention: true },
        "123": { requireMention: false },
      },
    },
  },
  agents: {
    list: [
      {
        id: "main",
        groupChat: {
          mentionPatterns: ["@openclaw", "openclaw", "\\+15555550123"],
          historyLimit: 50,
        },
      },
    ],
  },
}

​

Ограничение области настроенных шаблонов упоминаний

{
  messages: {
    groupChat: {
      mentionPatterns: ["\\bopenclaw\\b", "\\bops bot\\b"],
    },
  },
  channels: {
    slack: {
      mentionPatterns: {
        mode: "deny",
        allowIn: ["C0123OPS"],
      },
    },
  },
}

{
  messages: {
    groupChat: {
      mentionPatterns: ["\\bopenclaw\\b"],
    },
  },
  channels: {
    telegram: {
      mentionPatterns: {
        denyIn: ["-1001234567890", "-1001234567890:topic:42"],
      },
    },
  },
}

​

Ограничения инструментов для групп/каналов (необязательно)

• tools: разрешение/запрет инструментов для всей группы (allow, alsoAllow, deny; запрет имеет приоритет).
• toolsBySender: переопределения для отдельных отправителей внутри группы. Используйте явные префиксы ключей: channel:<channelId>:<senderId>, id:<senderId>, e164:<phone>, username:<handle>, name:<displayName> и подстановочный знак "*". Идентификаторы каналов используют канонические идентификаторы каналов OpenClaw; псевдонимы, например teams, нормализуются в msteams. Устаревшие ключи без префикса по-прежнему принимаются, сопоставляются только как id: и приводят к записи предупреждения об устаревании в журнал.

{
  channels: {
    telegram: {
      groups: {
        "*": { tools: { deny: ["exec"] } },
        "-1001234567890": {
          tools: { deny: ["exec", "read", "write"] },
          toolsBySender: {
            "id:123456789": { alsoAllow: ["exec"] },
          },
        },
      },
    },
  },
}

​

Списки разрешённых групп

{
  channels: { whatsapp: { groupPolicy: "disabled" } },
}

{
  channels: {
    whatsapp: {
      groups: {
        "123@g.us": { requireMention: true },
        "456@g.us": { requireMention: false },
      },
    },
  },
}

{
  channels: {
    whatsapp: {
      groups: { "*": { requireMention: true } },
    },
  },
}

{
  channels: {
    whatsapp: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
      groups: { "*": { requireMention: true } },
    },
  },
}

​

Активация (только владельцем)

• /activation mention
• /activation always

​

Поля контекста

• ChatType=group
• GroupSubject (если известно)
• GroupMembers (если известно)
• WasMentioned (результат проверки упоминания)
• Темы форумов Telegram также включают MessageThreadId и IsForum.

​

Особенности iMessage

• При маршрутизации или добавлении в список разрешений предпочтительно использовать chat_id:<id>.
• Список чатов: imsg chats --limit 20.
• Ответы в группе всегда отправляются обратно в тот же chat_id.

​

Системные подсказки WhatsApp

​

Особенности WhatsApp

​

Связанные материалы

• Группы рассылки
• Маршрутизация каналов
• Групповые сообщения
• Сопряжение