教程

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 Skills 开发完全指南:从零编写高质量 SKILL.md 自定义技能文件OpenClaw Skills 开发完整教程:SKILL.md 文件结构详解、自动触发 vs 显式触发原理、三个实战模板(GitHub 仓库管理/每日信息简报/代码健康检查)、让技能精准自动触发的描述写法,以及技能质量标准和 clawhub.ai 使用方法。2026/4/19教程OpenClaw 零基础完全入门:安装、Telegram 配置、记忆系统和技能插件完整指南OpenClaw 从零开始完整教程:用宠物龙虾类比理解架构、npm 安装步骤、Telegram Bot 配置、SOUL.md 性格定义、三层记忆系统(每日日志/长期记忆/MEMORY.md)、HEARTBEAT.md 主动任务、技能安装,以及安全配置和常见问题解决。2026/4/18教程Hermes Agent 消息网关配置完整指南:Telegram、Discord、Slack 多平台同步Hermes Agent 消息网关全面配置教程:Telegram Bot 创建和私聊话题分区、Discord Bot 权限配置、Slack App 设置、多平台同步原理、工具权限按平台管控、安全白名单配置,含常见连接问题排查。2026/4/15教程OpenClaw 快速入门:用 Telegram 控制 AI Agent,5 分钟搭建个人 AI 助理OpenClaw 5 分钟快速入门:用 Telegram 控制 AI Agent,含安装配置、Bot 创建、Skills 定义、多渠道支持、Claude Code 编程任务集成,以及与 Claude Code CLI 的区别和互补关系。2026/4/13教程OpenClaw 多 Agent 架构入门:用 Telegram Bot 控制你的 AI Agent 集群OpenClaw 多 Agent 架构入门指南:通过 Telegram 控制 AI Agent 集群,支持子 Agent 编排、MCP 集成和多节点部署。含快速开始教程。2026/4/7教程OpenClaw Background Tasks 完全指南:让 AI 在后台自主执行长时间任务(2026)OpenClaw Background Tasks(后台任务)完整指南:Background Tasks 与普通对话的区别(异步执行/不阻塞渠道/可中断恢复)、通过自然语言触发后台任务(「帮我在后台处理...」)、openclaw tasks 命令行管理(list/show/cancel/logs)、任务状态跟踪与完成通知、长时间任务的最佳实践(分批处理/超时设置/错误恢复)、与 Cron Jobs 的区别和选用场景,以及实战案例(批量文件处理/代码库扫描/数据报告生成)。2026/4/2