Clawdbot 群組
配置 Clawdbot AI 助手用於群組聊天。了解群組偵測、訊息處理、提及和多用戶對話。
Clawdbot 群組概覽
Clawdbot 支援所有訊息提供者的群組對話。本指南涵蓋群組聊天配置、訊息路由和多用戶互動模式。
群組偵測
自動偵測
Clawdbot 自動偵測群組聊天：
| 提供者 | 偵測方法 |
|---|---|
聊天 ID 後綴 @g.us | |
| Telegram | 更新中的 chat.type |
| Discord | 頻道類型 |
| 群組房間 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 | 根據上下文決定 |
訊息路由
群組與私訊
| 屬性 | 私訊 | 群組 |
|---|---|---|
| 會話金鑰 | 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 閘道 - 閘道配置