QQ Bot 控制台
配置机器人、管理频道论坛、定时发送消息
☾
仪表盘
配置
发送消息
论坛管理
频道管理
定时任务
发送日志
-
配置状态
-
定时任务
-
今日发送
-
累计发送
-
成功
-
失败
快速操作
立即发消息
论坛发帖
新建定时任务
配置机器人
机器人配置
未检测
AppID
*
AppSecret
*
使用沙箱环境
沙箱环境仅能操作沙箱频道/群(成员不超过20人)，正式环境需提交审核上线
保存配置
测试连接
接入方式
选择接入方式
仅 API（主动发消息 + 定时任务）
Webhook 回调（接收消息 + 自动记录群/好友）
WebSocket 长连接（需要单独运行 ws_bot.php）
Webhook 回调路径
在 QQ 开放平台后台填写的回调地址为:
https://你的域名
/api/webhook.php
Webhook 配置步骤
确保网站已配置 HTTPS（必须有有效 SSL 证书）
在
QQ 开放平台
回调配置
页面填写回调地址
回调地址允许的端口:
80, 443, 8080, 8443
保存后 QQ 平台会发送验证请求，本端点会自动完成 Ed25519 签名验证
验证通过后，机器人被拉群/好友添加时，会自动记录群和好友到目标列表
WebSocket 说明
需要单独运行
php ws_bot.php
保持长连接
支持实时接收所有消息事件
断线自动重连 (指数退避)
机器人被拉群/好友添加时，会自动记录到目标列表
保存接入方式
发送消息
发帖到论坛
发送消息
目标类型
群聊
频道子频道
C2C 单聊
频道私信
选择目标
-- 请先选择目标类型 --
目标 ID
消息类型
文本消息
Markdown
Ark 模板
Embed
消息内容
*
Markdown 内容
*
支持 **粗体**、~~删除线~~、[链接](url)、`代码` 等 QQ Markdown 语法
模板 ID (template_id)
*
键值对 (kv)
+ 添加键值对
标题 (title)
描述 (prompt)
缩略图 URL (thumbnail)
字段列表 (fields)
+ 添加字段
图片 URL
仅频道子频道支持附带图片 URL（平台会自动转存）；C2C/群聊可通过 URL 发送图片
立即发送
刷新目标列表
发帖到论坛
论坛子频道
-- 请选择论坛子频道 --
仅显示频道下的论坛/话题子频道，如果没有请先点击刷新
帖子标题
*
内容格式
纯文本
HTML
Markdown
帖子内容
*
发布帖子
刷新子频道列表
帖子列表
选择论坛子频道
-- 请选择论坛子频道 --
刷新子频道
请选择一个论坛子频道查看帖子
已加入的频道
加载中...
子频道列表
全部
文字
语音
论坛
分组
请先选择频道
频道成员
请先选择频道
频道角色
请先选择频道
定时任务列表
加载中...
新建定时任务
任务名称
*
目标类型
群聊
频道子频道
C2C 单聊
频道私信
选择目标
-- 请先选择目标类型 --
目标 ID
消息内容
*
Cron 表达式
*
0 9 * * *
每天 9:00
0 9 * * 1
每周一 9:00
0 9 1 * *
每月 1 号 9:00
*/30 * * * *
每 30 分钟
0 */2 * * *
每 2 小时
创建任务
发送日志
加载中...