跳到主要内容

QQ 机器人

QQ Bot 使用官方 WebSocket Gateway 收事件,通过 REST 发送回复,不需要公网入站 Webhook。常驻 Gateway 要能主动连接 QQ 平台。

先建应用,再填凭据​

准备 QQ Bot App ID、App Secret,并启用 C2C 与群聊 @ 消息所需 Intent。平台配置入口以官方事件订阅文档为准。

在 Dashboard 渠道 → 添加 → QQ Bot 的默认 WebSocket 接入填写 app_id 与 client_secret。默认账号 ID 是 bot;bot_user_id 为可选的机器人身份匹配字段,不是要发消息的联系人号码。

私聊和群聊分别放行​

默认 DM 为 pairing,Group 为 mention。CLI 交互向导 anyy setup channel 可修改策略:私聊 pairing/open/allowlist/disabled,群聊 mention/open/allowlist/disabled。Dashboard 凭据表单没有这些策略输入,名单条目也不是此平台当前公开设置字段。

anyy channel pairing list --channel qqbot
anyy channel pairing approve --request REQUEST_ID

核对发送者身份后批准,再发新消息。QQ Bot 的群聊路径要求按所选策略提及机器人,不应把私聊成功当成群聊也已验证。

看实际收发,不只看身份探测​

anyy channel reload
anyy channel doctor qqbot

分别测试一条 C2C 消息和一条群聊 @ 消息。身份检查成功而没有事件时,优先检查 Intent、订阅和应用可用状态,不必先轮换 App Secret。

回复绑定当前入站消息的上下文,不能把旧对话记录当作任意主动发送权限。平台拒发时检查身份、上下文、发信授权和当前诊断;未知/部分成功的结果先看平台记录,再决定是否需要另一条回复。访问控制和投递状态的通用说明见消息平台。