QQ 频道

新建一个 QQ 频道

需要在手机 QQ 中新建一个频道,这个频道将作为你的机器人工作的频道。如果你已有一个小于 20 人的频道也可以直接使用。

操作步骤:

  1. 点击手机 QQ 右上角加号按钮
  2. 点击【创建频道】字样,按照指引完成频道创建
  3. 创建完成后就可以在底部的 频道 Tab 看到这个频道

新建频道时的模板、头像、名字等均可以随你的喜好任意填写。

没有频道 Tab?

频道目前处于内测阶段,如果你之前没有加入过任何频道,则有可能没有这个 Tab。你可以点击加入我们的官方频道open in new window,就会自动长出频道 Tab。

如果仍然无法加入,可能你是 QQ 内测的受害者,可以让朋友帮忙申请下。频道功能预计在今年(2023)下半年全量开放。

还有一种可能是你之前把频道 Tab 关了。可以打开手机 QQ 的 设置 -> 辅助功能 -> 主页底部导航栏设置,检查频道开关是否打开。

注意

建立完频道后不要立刻拉一堆人(或机器人)进来,因为后续添加机器人时需要频道人数小于 20 人。待创建流程结束,你自己的跑团机器人加入后就不受影响了。

建立完频道之后,你需要确认下频道中是否存在文字子频道(现版本又称聊天区、讨论组等)。目前也可以在手机 QQ 中新建文字子频道:

(由于频道经常改版,如实际情况与图片所展示的不符,请自行探索看看。另外也可以在登录机器人的步骤中创建文字子频道,详见后续步骤)

注册 QQ 开放平台帐号

注册开放平台帐号是为了后面申请机器人使用。

打开 QQ 开放平台open in new window,点击【立即注册】,帐号类型选择【个人】,随后按表单提示一步步进行即可。

创建机器人

使用上一步注册的帐号登录 QQ 开放平台open in new window,点击【创建机器人】按钮。随后跟随步骤操作即可。名称、头像和介绍可以按自己的喜好填写。

创建 QQ 机器人按钮

创建按钮不可点?

如果遇到 bug 创建按钮不可点,也可以登录后直接通过这个链接open in new window进入创建页面

机器人创建成功后,会跳转到机器人后台的配置页面。

QQ 机器人配置

如果前面步骤中你的 QQ 号和实名认证信息正确对应,【频道 ID】中会自动出现你之前创建的频道,选择该频道即可。

【机器人类型】请选择【私域机器人】,不要变动。

加入机器人

机器人创建成功后,就可以把它加入到我们先前创建的频道中。我们在手机 QQ 中先选中先前创建的频道,点击右上方【三横线】图标,调出频道设置。然后点击【机器人】打开机器人列表。

QQ 机器人列表

请用你的火眼金睛在下面的机器人列表中找到你刚刚创建的机器人,点击添加到频道中。机器人权限维持默认就可以。

找不到机器人?

如果在机器人列表中找不到你的机器人,可能有以下几种原因:

  1. 看错了频道。请确认你正在添加机器人的频道和机器人的沙箱频道(即创建机器人时选择的频道)是同一个频道。
  2. 频道人数超过限制。请确认你的频道人数小于 20 人。(机器人也算人头数)
  3. 机器人还在审核中。理论上这一步审核是很快的,可以等一段时间再看看。

如果确实设置正确,且经过长时间仍然无法找到机器人,则可能是 QQ bug,可以去 QQ 机器人的官方社区open in new window,找小助理反馈问题。

QQ 频道的能力限制

由于 QQ 官方的安全管控较为严格,机器人会存在不少限制支持,在此提前列出,可配合后续登录机器人步骤时配合查阅。

IP 白名单限制

目前新注册的机器人在使用正式环境登录时,必须在 QQ 开放平台配置 IP 白名单,否则无法连接到机器人。

IP 白名单配置方法:

程序启动后会在命令行中打印出当前公网 IP 地址。可将该地址配置到 QQ 开放平台【开发设置】→【IP白名单】 中,再进行连接操作。

有关 IP 白名单的说明

如果你使用个人电脑(非服务器)运行机器人,电脑的 IP 地址可能会因为重启、重新联网等情况发生变更。如果遇到”接口访问源IP不在白名单“的错误,你可能需要重新设置 IP 白名单。

如果你在这方面遇到问题,或不想频繁设置 IP 白名单,可选择使用【沙箱环境】。

沙箱环境

沙箱环境无需配置 IP 白名单,不受 IP 的限制,但在 QQ 频道中机器人消息会强制带有 [sandbox] 前缀。

另外沙箱环境机器人默认收不到频道的私聊消息。需要在 QQ 开放平台【沙箱配置】→ 【在频道私信配置】中,把对应的用户添加进去,才可以和机器人进行私聊。

私信主动消息条数限制

主动消息是指机器人主动给你发消息。通常的一问一答模式不受限制。但在暗骰时,你在频道里发送指令,而机器人需要主动私聊发送结果,就属于主动消息。

在频道私信时,主动消息存在条数限制:

  • 每个机器人每天可以对一个用户发 2 条主动消息
  • 每个机器人每天累计可以发 200 条主动消息

其中第一条限制是很容易达到的。如果你发现突然接收不到私信,且命令行中打印出 push dm message reach limit 字样的错误信息,就代表触发了限制。

此时,需要你在私聊中主动给机器人发送一条任意消息。这样可以在接下来的 5 分钟内,让机器人以被动消息形式发送,绕过这个限制。

下一步

恭喜你已经完成了最麻烦的部分!下一步,根据你的操作系统,选择对应的运行方式:

Windows 运行

macOS 运行

Linux 部署

Last Updated: