教程

OpenClaw 群消息完全指南:群组配置、@ 触发、白名单与多 Bot 协同实战

OpenClaw 群消息(Group Messages)完整配置教程:群组消息的触发方式(requireMention/commandPrefix/respondToAll)、各渠道群组配置差异(Telegram群/Discord服务器/Slack频道/WhatsApp群)、群组白名单与黑名单管理、限制特定成员才能触发 AI(allowedUsers/allowedRoles)、响应限速防刷屏(cooldown)、多 Bot 在同一群组协同分工的配置方案、群组 Session 的记忆与上下文管理,以及群组中 AI 的礼貌边界设计(何时发言/何时沉默)。

2026/3/244分钟 阅读ClaudeEagle

在群组里用 AI 助手,最大的挑战是: AI 什么时候发言,什么时候保持沉默? 本文从配置到设计思路,讲清楚群消息的正确用法。

群消息触发方式

方式一:requireMention(@ 触发,推荐)

只有 @ Bot 才触发 AI 回复,不打扰正常群聊:

json
{
  "groups": {
    "default": {
      "requireMention": true
    }
  }
}
群成员:@openclaw-bot 帮我查一下这个 API 文档 Bot:根据文档,这个 API 的参数是... 群成员:今天午饭吃什么(普通聊天,Bot 不回复)

方式二:commandPrefix(命令前缀触发)

消息以特定前缀开头才触发:

json
{
  "groups": {
    "default": {
      "commandPrefix": "!ai"
    }
  }
}
!ai 翻译这段英文 → Bot 翻译 普通消息 → Bot 静默

方式三:respondToAll(响应所有消息)

适合专用 AI 频道(如 #ai-assistant):

json
{
  "groups": {
    "my-special-channel-id": {
      "respondToAll": true
    }
  }
}

⚠️ 不推荐在日常群组中开启,会占满对话空间。

各渠道群组配置

Telegram 群组

json
{
  "channels": {
    "telegram": {
      "groups": {
        "-1001234567890": {
          "requireMention": true,
          "allowedUsers": ["123456789", "987654321"]
        }
      }
    }
  }
}

获取 Telegram 群组 ID:把 Bot 加入群组,发消息后查看日志中的 chatId

Discord 服务器/频道

json
{
  "channels": {
    "discord": {
      "groups": {
        "channel-id-123456": {
          "requireMention": false,
          "commandPrefix": "?",
          "allowedRoles": ["admin", "moderator"]
        }
      }
    }
  }
}

Discord 支持按**角色(Role)**限制权限,更符合服务器管理习惯。

Slack 频道

json
{
  "channels": {
    "slack": {
      "groups": {
        "C0123456789": {
          "requireMention": true,
          "threadMode": "thread"
        }
      }
    }
  }
}

threadMode: "thread":AI 回复在线程内,不占用主频道空间。

WhatsApp 群组

json
{
  "channels": {
    "whatsapp": {
      "groups": {
        "120363xxxxxx@g.us": {
          "requireMention": true,
          "allowedNumbers": ["+8613800138000"]
        }
      }
    }
  }
}

响应限速(防刷屏)

多人群组中,限制相邻两次 AI 回复的最短间隔:

json
{
  "groups": {
    "default": {
      "cooldown": 10,
      "cooldownMessage": "AI 正在冷却中,请稍等..."
    }
  }
}

用户触发限速时会看到 cooldownMessage, 避免 Bot 被人刷导致 API 费用激增。

成员白名单与黑名单

json
{
  "groups": {
    "my-group-id": {
      "allowedUsers": ["user1", "user2"],
      "blockedUsers": ["spammer-id"]
    }
  }
}
  • allowedUsers:只有这些用户才能触发 AI
  • blockedUsers:这些用户的消息直接忽略
  • 不设置时:所有群成员都能触发(在 requireMention 限制下)

群组记忆与上下文

群组 Session 的上下文管理:

json
{
  "groups": {
    "default": {
      "sessionScope": "per-thread",
      "maxContextMessages": 20
    }
  }
}
  • "per-thread":每个线程独立会话(推荐,防止上下文污染)
  • "per-group":整个群组共享会话(所有对话都在一个上下文里)
  • "per-user":每个用户在群里有独立会话

多 Bot 协同配置

一个群组里,不同 Bot 负责不同领域:

群组:#engineering @devbot 帮我 review 这段代码 → Claude Code Agent(专注编程) @docsbot 更新一下 API 文档 → Docs Agent(专注文档) @monitorbot 服务器状态怎么样? → Ops Agent(专注运维)

配置方案:

json
{
  "routing": {
    "rules": [
      {
        "channel": "slack",
        "groupId": "C-engineering",
        "mentionedBot": "devbot",
        "agent": "code-reviewer"
      },
      {
        "channel": "slack",
        "groupId": "C-engineering",
        "mentionedBot": "docsbot",
        "agent": "doc-writer"
      }
    ]
  }
}

AI 在群组里的礼貌设计

在 SOUL.md 中配置群组行为规范:

markdown
# SOUL.md — 群组行为规范

## 什么时候发言
- 被直接 @ 提问
- 有明确的任务需要我处理
- 需要纠正错误信息

## 什么时候沉默
- 普通日常聊天(不涉及需要 AI 处理的内容)
- 别人在聊我不了解的私事
- 话题已经被人工解答了
- 我的回复只会是「好的」「明白」这类无意义内容

## 群组回复格式
- 控制在 200 字以内(群组不适合长篇大论)
- 直接回答,不废话
- 长内容用线程/链接形式,不刷屏

来源:OpenClaw 官方文档 - docs.openclaw.ai/channels/group-messages

相关文章推荐

教程OpenClaw Standing Orders 完全指南:让 AI 记住你的长期规则和行为偏好OpenClaw Standing Orders(常驻指令)功能完整教程:Standing Orders 与 SOUL.md 的区别(动态运行时规则 vs 静态人格文件)、通过对话动态添加/查看/删除常驻指令、指令的持久化存储与跨会话生效机制、适合写入 Standing Orders 的内容类型(格式偏好/禁止行为/固定工作流)、与 Hooks 的协同使用、按渠道/Agent 设置不同的 Standing Orders,以及常驻指令的最佳实践(写清晰的规则、避免矛盾冲突、定期清理过时规则)。2026/3/26教程OpenClaw 多媒体处理完全指南:图片识别、音频转写与视频理解实战OpenClaw 多媒体处理(Media)完整教程:发送图片给 AI 进行视觉分析(OCR/物体识别/图表解读/代码截图)、音频消息自动转写为文字(Whisper/系统STT)、视频消息关键帧提取与理解、Node 摄像头实时拍照触发分析、媒体消息的渠道支持差异(各渠道的图片/音频/视频支持情况对比)、大文件处理策略(分割/压缩/超时设置)、媒体消息在不同 AI 模型上的能力对比(Claude Vision/GPT-4V/Gemini Pro Vision),以及本地媒体文件分析(read 工具读取图片路径)。2026/3/25教程OpenClaw TUI 完全指南:纯键盘操作的终端管理界面使用详解OpenClaw TUI(Terminal User Interface,终端用户界面)完整使用指南:TUI 与 Control UI(浏览器)的定位对比、适合 TUI 的场景(SSH 远程/无浏览器服务器/低带宽环境)、启动命令(openclaw tui)及参数、界面布局(Agents 面板/Sessions 面板/Channels 状态/Logs 实时流)、全键盘快捷键手册(导航/选择/搜索/刷新/退出)、在 TUI 中发送测试消息、实时日志过滤与搜索,以及 TUI 与 tmux/screen 配合使用的后台运行方案。2026/3/25教程OpenClaw Control UI 与 Dashboard 完全指南:浏览器管理 AI 助手的全功能界面OpenClaw Control UI(控制面板)与 Dashboard(仪表盘)完整使用指南:Control UI 的功能布局(Agents 管理/Tools 工具面板/Sessions 会话查看/Channel 渠道状态)、浏览器访问方式(本地 localhost:18789 vs 远程 SSH 隧道)、在 Control UI 中实时修改 Agent 配置(SOUL.md 编辑/模型切换/工具开关)、Dashboard 数据概览(Token 用量/渠道在线状态/会话列表/Node 节点健康)、从 Dashboard 发起诊断(doctor 命令)、以及 TUI(终端界面)的使用场景与快捷键。2026/3/24教程OpenClaw 接入 Nextcloud Talk:自托管视频会议平台 AI 助手完全配置指南OpenClaw 接入 Nextcloud Talk 的完整教程:Nextcloud Talk 的自托管通信平台特点(视频会议+聊天+文件协作)、插件安装(@openclaw/nextcloud-talk)、通过 occ CLI 创建 Bot 账户并注册 Webhook、OpenClaw 最简配置(serverUrl+appPassword+sharedSecret)、DM 私信与房间(Room)访问控制、Markdown 消息格式和表情反应支持、局域网/内网部署注意事项(WebSocket vs Polling),以及 Nextcloud Talk AI 助手的典型使用场景(会议摘要/文件问答/任务分派)。2026/3/24教程OpenClaw Talk Mode 语音对话完全指南:用说话代替打字的 AI 交互新方式OpenClaw Talk Mode(语音对话模式)完整教程:Talk Mode 的工作原理(语音输入转文字 + AI 处理 + TTS 语音输出的完整链路)、在 iOS/Android/macOS 节点上启用 Talk Mode 的配置步骤、语音唤醒词(Voice Wake)设置、TTS 语音引擎选择(ElevenLabs/系统TTS)、语音对话的延迟优化、配合 Node 摄像头的多模态语音交互,以及 Talk Mode 与 Voice Wake 的组合使用场景(免手持语音助手/车载助手/烹饪助手)。2026/3/23