← 返回控制台

使用说明

从开放平台建机器人到群里跑起来，一共 12 步。

一、在开放平台创建机器人

  1. 打开 q.qq.com，用任意 QQ 账号登录。
  2. 按提示点击创建机器人，名字自己取，简介随便填。
  3. 注册后必须认证邮箱，认证完成才能继续。
  4. 主体类型选择「个人」，按页面提示逐步确认。
  5. 进入机器人后台，打开「开发设置」，找到 AppID 与 AppSecret，两个都记下来。
AppSecret 只显示一次，建议立刻复制保存；丢了只能重置。

二、在本站绑定机器人

  1. 回到 控制台，注册账号并登录。
  2. 进入「机器人设置」，填入刚保存的 AppID 和 AppSecret。
  3. 点「保存绑定」。系统会自动生成你的专属回调地址，并尝试连接网关。
  4. 绑定成功后会弹出回调地址，复制它。

三、把回调地址填回开放平台

  1. 回到开放平台 → 机器人管理 → 开发设置 → 事件订阅与回调，点「Webhook」进入。
  2. 接入方式选择 Webhook，把刚复制的回调地址粘贴到「回调地址」。
  3. 接收事件配置选择 全部接收，最后点「保存接收事件」。
⚠️ 一定要确认勾选的是「全部接收」，否则收不到群消息。

四、配置 IP 白名单

  1. 开发设置 → 「添加 IP」。
  2. 把服务端出口 IP 填进去（本地部署填 127.0.0.1 或你的公网 IP）。
⚠️ 白名单 IP 必须配置，这点很重要——没加白名单时发消息、踢人接口都会失败。

五、拉机器人进群并取 ID

  1. 用你的 QQ 把机器人拉进群，并在群里把它设成管理员（禁言/踢人需要）。
  2. 在群里发 取ID，机器人会回复三行：我的ID（你的 openid）· 机器人ID · 群ID。
  3. 把「我的ID」填进「机器人设置 → 主人 ID」，每行一个，可填多个。
同一个人在不同群的 openid 不同，每个群都要单独取一次。

六、激活卡密并授权群

  1. 在「机器人设置 → 卡密授权」输入卡密，点「激活」。
  2. 激活后下方会列出机器人见过的群，选中要用的群，点「添加授权」。
  3. 续费时先在上方选中一张已激活的卡密，再输入续费卡密点「续费」。
⚠️ 激活是增加可授权群名额，一张卡密 3 个群。到期后所有功能自动关闭。

七、功能速查

自动问答添加精确问 关键词 答案 / 添加模糊问 关键词 答案 / 查看问答列表
禁言开启禁言 / 关闭禁言 / 禁言 @成员 10 / 解除禁言 @成员
警告警告 @成员 / 查询警告 / 设置警告上限 3
踢人踢 @成员 / 踢黑 @成员 / 拉黑 @成员
监控撤回开启群防撤回 / 关闭群防撤回 / 查看监控撤回状态
扩展系统权限、定时、循环、统计、审核、黑白名单、违禁词、刷屏、开关、DNF

八、卡密类型与规则

卡密类型周卡 7 天 · 月卡 30 天 · 季卡 90 天 · 半年卡 180 天 · 年卡 365 天
授权群数每张卡密 3 个群
到期提醒提前 3 天 + 到期当天
注册赠送默认 1 天试用（管理员可改）
官方接口限制说明：QQ 开放平台的「撤回消息」只能撤回机器人自己发送的消息，撤回普通成员消息必然失败，因此命中拦截时默认改为禁言（默认 60 秒，0 表示只提示）。「踢出群成员」接口需要平台白名单权限，无权限时自动降级为禁言 30 天。