Skip to content

快速开始 ​

从注册完成到机器人在群里回复第一条消息,通常需要完成:兑换额度 → 开通机器人 → 配置接入 → 安装插件 → 测试。

第 1 步:兑换额度 ​

如果还没有机器人额度:

  1. 进入「卡密兑换」
  2. 输入购买的卡密
  3. 确认兑换
  4. 查看「我的机器人」是否出现可开通额度

不同卡密对应不同时长/额度,以兑换页面显示为准。

第 2 步:开通机器人 ​

  1. 进入「我的机器人」
  2. 点击「新增机器人」/「开通机器人」
  3. 填写机器人名称
  4. 选择官方机器人或普通机器人接入方式
  5. 保存

开通后会得到:

  • 机器人名称
  • 机器人 slug(Webhook 路径的一部分)
  • AppID / AppSecret 配置入口
  • 插件配置入口

第 3 步:接入 QQ 官方机器人 ​

在 QQ 开放平台创建机器人,获取:

  • AppID
  • AppSecret
  • 事件订阅地址

在平台机器人编辑页填写 AppID / AppSecret,保存后平台会生成 Webhook 地址:

text
https://你的域名/qq/webhook/{slug}

把该地址填入 QQ 开放平台的回调配置,并订阅群消息、私聊消息、成员事件等所需事件。

第 4 步:安装插件 ​

  1. 进入「插件生态」
  2. 打开「插件商店」
  3. 选择插件 → 安装
  4. 进入「我的插件」
  5. 确认插件已启用
  6. 为具体机器人打开开关

内置插件和商店插件是两套来源:

  • 内置插件:平台自带,按机器人独立开关
  • 商店插件:用户/官方开发,需要安装后使用

第 5 步:测试 ​

把机器人拉进测试群,发送:

text
@机器人 菜单

或插件文档中写明的触发指令。

如果没反应,按顺序检查:

  1. 机器人是否在线
  2. Webhook 是否验证通过
  3. 群是否在平台授权范围内
  4. 插件是否启用
  5. 插件是否对该机器人生效
  6. 「收发日志」是否收到消息
  7. 服务端是否有错误日志

第 6 步:配置群管/审核 ​

按需进入机器人插件配置:

  • 群管:禁言、踢人、撤回、违禁词
  • 入群审核:欢迎语、验证、超时处理
  • 消息统计:活跃人数、发言排行
  • 定时任务:定时群发、提醒
  • 关键词/工作流:自动回复和复杂流程

推荐下一步 ​

薇薇官机平台 · ZL 系列插件