Clawdbot 群组
配置 Clawdbot AI 助手群聊功能。了解群组检测、消息处理、提及和多用户对话。
Clawdbot 群组概述
Clawdbot 支持所有消息提供商的群组对话。本指南涵盖群聊配置、消息路由和多用户交互模式。
群组检测
自动检测
Clawdbot 自动检测群聊：
| 提供商 | 检测方法 |
|---|---|
聊天 ID 后缀 @g.us | |
| Telegram | 更新中的 chat.type |
| Discord | 频道类型 |
| 微信 | 群聊房间 ID |
| 飞书 | 聊天类型字段 |
会话键
群组会话使用不同的键：
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": "团队聊天"
}
}
}上下文策略
| 策略 | 描述 |
|---|---|
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 网关 - 网关配置