快速开始
从注册完成到机器人在群里回复第一条消息,通常需要完成:兑换额度 → 开通机器人 → 配置接入 → 安装插件 → 测试。
第 1 步:兑换额度
如果还没有机器人额度:
- 进入「卡密兑换」
- 输入购买的卡密
- 确认兑换
- 查看「我的机器人」是否出现可开通额度
不同卡密对应不同时长/额度,以兑换页面显示为准。
第 2 步:开通机器人
- 进入「我的机器人」
- 点击「新增机器人」/「开通机器人」
- 填写机器人名称
- 选择官方机器人或普通机器人接入方式
- 保存
开通后会得到:
- 机器人名称
- 机器人 slug(Webhook 路径的一部分)
- AppID / AppSecret 配置入口
- 插件配置入口
第 3 步:接入 QQ 官方机器人
在 QQ 开放平台创建机器人,获取:
- AppID
- AppSecret
- 事件订阅地址
在平台机器人编辑页填写 AppID / AppSecret,保存后平台会生成 Webhook 地址:
text
https://你的域名/qq/webhook/{slug}把该地址填入 QQ 开放平台的回调配置,并订阅群消息、私聊消息、成员事件等所需事件。
第 4 步:安装插件
- 进入「插件生态」
- 打开「插件商店」
- 选择插件 → 安装
- 进入「我的插件」
- 确认插件已启用
- 为具体机器人打开开关
内置插件和商店插件是两套来源:
- 内置插件:平台自带,按机器人独立开关
- 商店插件:用户/官方开发,需要安装后使用
第 5 步:测试
把机器人拉进测试群,发送:
text
@机器人 菜单或插件文档中写明的触发指令。
如果没反应,按顺序检查:
- 机器人是否在线
- Webhook 是否验证通过
- 群是否在平台授权范围内
- 插件是否启用
- 插件是否对该机器人生效
- 「收发日志」是否收到消息
- 服务端是否有错误日志
第 6 步:配置群管/审核
按需进入机器人插件配置:
- 群管:禁言、踢人、撤回、违禁词
- 入群审核:欢迎语、验证、超时处理
- 消息统计:活跃人数、发言排行
- 定时任务:定时群发、提醒
- 关键词/工作流:自动回复和复杂流程
