✦ 机器人接入教程
GET STARTED

从申请到接入,一步一步完成

租赁提供本系统的托管使用权,不包含QQ账号、平台审核资格、QQ官方机器人权限或模型API余额。先在测试群验证,再开启自动管理。

建议优先选择

一、官方QQ机器人 · 申请 / 注册 / 接入

  1. 打开QQ开放平台,使用自己的QQ登录,按照平台当前要求完成开发者注册及主体认证。不要把QQ密码、验证码交给他人。
  2. 在平台的机器人管理区域创建应用,填写名称、头像、简介等资料,按平台提示提交审核。具体可用类型、认证材料和审核结果以你的控制台为准,租赁后台不能代替申请或保证审核通过。
  3. 在自己机器人的开发设置中查找AppID和AppSecret。AppID是机器人应用编号,AppSecret是密钥;如果平台仅显示一次,请妥善保存。不要填写QQ登录密码,也不要发在群里。
  4. 在本系统客户中心开通套餐后,点击「添加我的机器人」→选择「官方机器人」,填入名称、AppID、AppSecret并保存。本租赁入口使用官方网关直连接入,不要求你给本入口另配HTTPS事件回调;平台如要求其他安全项仍按其提示配置。
  5. 在QQ开放平台设置测试范围、可用群场景及需要的能力,把机器人加入你有权管理的测试群。平台权限不支持的撤回、禁言、欢迎事件,本系统不能绕过。
  6. 点击客户中心「启动」。显示进程运行不等于QQ已在线,结合连接状态和日志核验。先测试普通回复,再配置关键词和欢迎提醒。
  7. 官方群OpenID不等于数字QQ群号。打开机器人配置,输入目标QQ群号并点击「生成群激活指令」。让目标群的群主/管理员在群中发送生成的一次性指令;身份验证成功后自动追加管理群。验证窗口以页面实际提示为准。
  8. 确认管理群及免检成员后保存。仅在获得群管理权限后,使用明确的测试广告验证撤回及禁言;测试对象使用你自己的测试账号,不要拿无关群成员试验。

平台菜单会调整;教程提供通用流程,不承诺所有账号都具有相同能力。官方入口:QQ开放平台。请以平台当时的规则和权限说明为准。

二、普通QQ · OneBot 11接入文档

本后台不提供QQ登录协议,也不能帮你绕过平台风控。第三方框架不是QQ官方服务,使用前自行评估账号安全及平台规则,建议使用专用测试账号。

  1. 准备能持续运行的电脑/服务器及你自己的QQ账号。选择支持OneBot 11 HTTP API和HTTP签名事件上报的实现;参考NapCat项目文档。只从项目可信发布渠道获取安装包,不使用来历不明的一键包。
  2. 按照对应框架说明安装并由你本人扫码登录。保持框架在线;本后台托管机器人逻辑,不会自动代替第三方QQ框架登录,也不会把你手机的QQ变成云服务器。
  3. 在框架启用HTTP API服务,设置足够长的access_token;事件上报启用HTTP POST并设置Secret。参数具体名称以实现为准。此后台需要兼容的X-Signature: sha1=...签名上报,不能靠关闭验签来兼容不支持的框架。
  4. 在客户中心添加「普通QQ」,填写登录的QQ号、HTTP API地址、Token及签名Secret。Token和Secret需分别与框架对应项一致,不是QQ密码。
  5. 同一服务器部署时,管理员可在核验端口归属后使用回环HTTP地址,例如http://127.0.0.1:3000;客户框架在其他机器时需使用可信HTTPS网络或管理员配置的私有网络。不要把OneBot API裸露到公网,也不要通过用户输入的IP直接放行全部访问。
  6. 保存后页面显示「HTTP事件上报」地址,把它填入框架的HTTP客户端/事件上报URL(不是WebSocket地址)。公网回调应经反向代理使用HTTPS。若框架和租赁后台不在同一台机器,127.0.0.1不能当作对方地址。
  7. 联系租赁管理员核验这个OneBot API仅属于你,并批准该地址。未审批或地址发生变化时不能启动,防止访问平台内部或其他客户的机器人。
  8. 填写需要管理的数字QQ群号。普通QQ管理群留空会管理所有收到事件的群,建议明确指定。确保机器人在群内有相应管理权限;不能处罚群主或权限不足的管理员。
  9. 启动后在自己的测试群验证回复、事件上报、撤回及禁言,并检查日志。QQ掉线、接口地址变化、Token/Secret不一致或框架故障,都需要先修复接入,不能仅看进程状态。

OneBot 11协议参考:OneBot 11协议项目。QQ框架和平台的可用性可能变化,租赁不保证第三方框架永不掉线或账号永不受限。

三、付款和续费

  1. 在客户中心注册独立账号,选择月付或年付,系统按服务端价格生成订单。核对收款人及金额后扫码付款,备注订单号。
  2. 管理员核对真实到账和交易流水后开通。付款截图不是到账证明,系统不会凭截图自动加时;订单24小时有效,过期未核实请联系管理员,切勿重复付款。
  3. 按自然月/年计费,续费从当前到期日与审核开通时间两者中较晚的时间开始;月末日期向目标月份最后一天对齐。订单中的价格和机器人额度在下单时固定。
  4. 到期暂停机器人运行但保留配置,客户仍可登录查询订单;续费核实后可以重新启动。管理员暂停新订单不缩短已开通租期。

安全提醒:只在租赁后台填写自己的应用/API凭证;不要提供QQ登录密码、邮箱验证码或支付密码。公开部署请启用HTTPS、限制管理入口访问并做好私有数据备份。

教程维护日期:2026-11-02。平台相关步骤以官方最新控制台为准;未代替用户完成平台注册、审核或群权限实测。