QQ 频道
新建一个 QQ 频道
需要在手机 QQ 中新建一个频道，这个频道将作为你的机器人工作的频道。如果你已有一个小于 20 人的频道也可以直接使用。
操作步骤：
- 点击手机 QQ 右上角加号按钮
- 点击【创建频道】字样，按照指引完成频道创建
- 创建完成后就可以在底部的 频道 Tab 看到这个频道
新建频道时的模板、头像、名字等均可以随你的喜好任意填写。
注意
建立完频道后不要立刻拉一堆人（或机器人）进来，因为后续添加机器人时需要频道人数小于 20 人。待创建流程结束，你自己的跑团机器人加入后就不受影响了。
建立完频道之后，你需要确认下频道中是否存在文字子频道（现版本又称聊天区、讨论组等。由于频道经常改版，本文档内容可能不是最新的，请自行探索看看）。
2025/04/14 更新：官方又双叒叕砍了文字子频道功能，目前新建立的频道无法创建文字子频道了（旧的频道，已经有文字子频道的，还可以正常使用）。
如果新的频道仍然想要文字功能，可以新建一个语音子频道，在语音子频道中仍然可以使用文字聊天和机器人。语音子频道建立方法：
- 手机 QQ 中，在频道页面，点击右上角三横线图标，选择【频道管理】→【应用管理】，点击右上角【管理】按钮，将【语音房】tag 添加到上方，并保存。
- 在【语音房】板块中新建子频道即可。
注册 QQ 开放平台帐号
注册开放平台帐号是为了后面申请机器人使用。
打开 QQ 开放平台，点击【立即注册】，帐号类型选择【个人】，随后按表单提示一步步进行即可。
创建机器人
使用上一步注册的帐号登录 QQ 开放平台，点击【创建机器人】按钮。随后跟随步骤操作即可。名称、头像和介绍可以按自己的喜好填写。
机器人创建成功后，会跳转到机器人后台的配置页面。
如果前面步骤中你的 QQ 号和实名认证信息正确对应，【频道 ID】中会自动出现你之前创建的频道，选择该频道即可。
【机器人类型】请选择【私域机器人】。
【机器人类型】请选择【私域机器人】。
【机器人类型】请选择【私域机器人】。
加入机器人
机器人创建成功后，就可以把它加入到我们先前创建的频道中。我们在手机 QQ 中先选中先前创建的频道，点击右上方【三横线】图标，调出频道设置。然后点击【机器人】打开机器人列表。
请用你的火眼金睛在下面的机器人列表中找到你刚刚创建的机器人，点击添加到频道中。机器人权限维持默认就可以。
找不到机器人？
如果在机器人列表中找不到你的机器人，可能有以下几种原因：
- 看错了频道。请确认你正在添加机器人的频道和机器人的沙箱频道（即创建机器人时选择的频道）是同一个频道。
- 频道人数超过限制。请确认你的频道人数小于 20 人。（机器人也算人头数）
- 机器人还在审核中。理论上这一步审核是很快的，可以等一段时间再看看。
如果确实设置正确，且经过长时间仍然无法找到机器人，则可能是 QQ bug，可以去 QQ 机器人的官方社区，找小助理反馈问题。
登录机器人
完成了创建机器人并加入群的步骤后，接下来就可以下载机器人软件，并登录机器人进行使用了。
登录所需的参数说明：
登录 QQ 开放平台，选择自己创建的机器人，在右边的菜单中找到【开发】->【开发设置】。将 AppID、Token 和 AppSecret 分别复制到登录界面的输入框中。其中 AppSecret 首次使用需要自己生成并保存。
正式环境 vs 沙箱环境：参考下文 QQ 频道的能力限制
高级设置（通常无需修改）：
连接方式可选 WebSocket 或 Webhook。Webhook 方式需要将机器人部署到公网，并配置 https 域名，使用门槛较高，大多数用户无此条件。故默认使用 WebSocket 方式。
QQ 频道的能力限制
由于 QQ 官方的安全管控较为严格，机器人会存在不少限制支持，在此提前列出，可配合后续登录机器人步骤时配合查阅。
IP 白名单限制
目前新注册的机器人在使用正式环境登录时，必须在 QQ 开放平台配置 IP 白名单，否则无法连接到机器人；命令行会提示“接口访问源IP不在白名单”的错误。
IP 白名单配置方法：
程序启动后会在命令行中打印出当前公网 IP 地址。可将该地址配置到 QQ 开放平台【开发设置】→【IP白名单】 中，再进行连接操作。
有关 IP 白名单的说明
如果你使用个人电脑（非服务器）运行机器人，电脑的 IP 地址可能会因为重启、重新联网等情况发生变更。如果遇到“接口访问源IP不在白名单”的错误，你可能需要重新设置 IP 白名单。
如果你在这方面遇到问题，或不想频繁设置 IP 白名单，可选择使用【沙箱环境】。
沙箱环境
沙箱环境无需配置 IP 白名单，不受 IP 的限制，但在 QQ 频道中机器人消息会强制带有 [sandbox] 前缀。
另外沙箱环境机器人默认收不到频道的私聊消息。需要在 QQ 开放平台【沙箱配置】→ 【在频道私信配置】中，把对应的用户添加进去，才可以和机器人进行私聊。