StoryClaw Docs

QQ 机器人

在 QQ 开放平台注册机器人,获取 BotAppID 和 Token 并填入 StoryClaw 控制台,让 AI 成员进入 QQ 群。

概述

QQ 机器人接入需要在 QQ 开放平台注册机器人账号,获取 BotAppID 和 Token,填入 StoryClaw 控制台完成绑定。
QQ 机器人目前仅支持 QQ 群使用,暂不支持 QQ 私聊场景。

前提条件

  • 已在 QQ 开放平台 完成开发者认证
  • 已在 StoryClaw 控制台创建并激活了至少一个 AI 成员

接入步骤

1. 在 QQ 开放平台创建机器人

登录 q.qq.com,进入「机器人」管理页面,点击「创建机器人」,填写机器人名称和介绍,选择「群机器人」类型,提交申请。

QQ 开放平台 — 创建机器人

2. 获取 BotAppID 和 Token

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

QQ 机器人凭据 — BotAppID 和 Token

3. 在控制台填入凭据

进入 StoryClaw 控制台 → ClawBot 设备 → 插件 → QQ Bot,将 BotAppID 和 Token 粘贴到对应输入框,选择要绑定的 AI 成员,点击「保存」。

4. 将机器人添加到 QQ 群

在 QQ 开放平台完成机器人审核并上线后,可通过机器人的 QQ 号将其邀请进群。群内 @ 机器人即可触发 AI 成员响应。

常见问题

Q:机器人不响应群消息

A:确认已在控制台完成 Token 配置,且 ClawBot 设备在线;群内需要 @ 机器人触发。

Q:Token 验证失败

A:在 QQ 开放平台重新生成 Token 并更新控制台中的配置。

On this page