QQ 机器人
在 QQ 开放平台注册机器人,获取 BotAppID 和 Token 并填入 StoryClaw 控制台,让 AI 成员进入 QQ 群。
概述
QQ 机器人接入需要在 QQ 开放平台注册机器人账号,获取 BotAppID 和 Token,填入 StoryClaw 控制台完成绑定。
QQ 机器人目前仅支持 QQ 群使用,暂不支持 QQ 私聊场景。
前提条件
- 已在 QQ 开放平台 完成开发者认证
- 已在 StoryClaw 控制台创建并激活了至少一个 AI 成员
接入步骤
1. 在 QQ 开放平台创建机器人
登录 q.qq.com,进入「机器人」管理页面,点击「创建机器人」,填写机器人名称和介绍,选择「群机器人」类型,提交申请。

2. 获取 BotAppID 和 Token
机器人创建成功后,在机器人详情页面找到「开发设置」,复制 BotAppID,并生成或复制 Token(Bot Token)。

3. 在控制台填入凭据
进入 StoryClaw 控制台 → ClawBot 设备 → 插件 → QQ Bot,将 BotAppID 和 Token 粘贴到对应输入框,选择要绑定的 AI 成员,点击「保存」。
4. 将机器人添加到 QQ 群
在 QQ 开放平台完成机器人审核并上线后,可通过机器人的 QQ 号将其邀请进群。群内 @ 机器人即可触发 AI 成员响应。
常见问题
Q:机器人不响应群消息
A:确认已在控制台完成 Token 配置,且 ClawBot 设备在线;群内需要 @ 机器人触发。
Q:Token 验证失败
A:在 QQ 开放平台重新生成 Token 并更新控制台中的配置。