机器人在群里不回话：唤醒与权限检查清单

机器人装死是最常见的新手问题，而多数情况根本不是故障。按下面四层从上往下查，命中率极高。

第一层：这是设计行为

群聊场景下，为防消息泛滥，机器人默认不响应每条消息。先做两个动作：

1. @ 机器人说话——回了，说明一切正常，只是你之前没唤醒它
2. 发 /你好（默认唤醒前缀 + 内容）——回了，同上

私聊默认直接对话，不需要前缀。想让群聊不用 @ 也能聊，去配置文件「平台与消息」区改唤醒方式，或调整唤醒词。

第二层：模型没接好

唤醒了、日志里也看到消息进来了，但没回复或报错：

• 「配置文件 → AI → 模型」里对话模型设了吗？接了提供商不等于选了模型，见接入原理的「弹药库与枪」
• 模型 API 报错（completion 无法解析之类）：Key 失效、余额用尽、网络不通，逐项排查清单见模型 API 报错
• 上下文积累过多导致异常：群里发 /reset 重置会话再试

第三层：权限把它挡住了

• 自定义规则：该会话的消息处理或 LLM 开关被关了（可能是历史遗留规则），去「自定义规则」页查，见自定义规则
• 黑名单：该用户或会话被拉黑（部分由插件实现）
• 管理员指令误解：敲的是管理员指令但不在名单里——普通消息没问题、只有特定指令没反应就是这种，先 /sid 拿 ID 进管理员名单

第四层：平台侧收不到

适配器显示已连接但消息就是不进来，查平台开关：

平台开关的具体位置查各平台开放平台文档；连接层面的故障（适配器连不上、频繁掉线）在连接排查。

排查时的黄金习惯

任何一步改动后，看一眼「数据 → 日志」：消息进来有记录 = 平台链路通；有模型调用记录 = 唤醒与权限通；有报错 = 按报错文本对症。三层日志定位法比瞎试快十倍，详见连接排查的三板斧。