QQBot配置与开发 — 消息收发、群管理、定时提醒、多平台联动
QQ是中国最大的即时通讯平台之一。通过OpenClaw的QQBot集成，你可以让AI Agent在QQ群里自动回复、推送消息、设置提醒，甚至管理群成员。
凌晨3点27分，你的QQ机器人在群里准时推送了一条AI新闻日报。没有人知道它是个AI，因为它说话比群主还有梗。
| 功能 | 说明 | 工具 |
|---|---|---|
| 消息收发 | 发送文本/图片/文件到QQ群或私聊 | message / qqbot_remind |
| 定时提醒 | 设置定时提醒，到点自动推送 | qqbot_remind |
| 群管理 | 入群审批、成员管理 | QQ开放平台API |
| 多平台联动 | QQ+飞书+Discord同步消息 | 多channel配置 |
| 自然语言交互 | 用户在QQ里直接和Agent对话 | OpenClaw核心 |
AppID 和 AppSecret# 在OpenClaw配置文件中添加QQBot
# ~/.openclaw/config.yaml
channels:
qqbot:
enabled: true
appId: "你的AppID"
appSecret: "你的AppSecret"
# 消息回调配置
callbackUrl: "https://your-domain.com/api/qqbot/callback"
# 群聊配置
groups:
- id: "群号"
name: "AI技术群"
enabled: true// 发送文本到QQ群
message({
action: "send",
channel: "qqbot",
target: "group:群号",
message: "🤖 今日AI日报已更新！点击查看：https://miaoquai.com/news/"
})
// 发送到私聊
message({
action: "send",
channel: "qqbot",
target: "user:用户QQ号",
message: "你订阅的OpenClaw版本更新提醒：v2026.6.6已发布"
})// 创建提醒
qqbot_remind({
action: "add",
content: "每日AI新闻日报推送时间到！",
time: "0 8 * * *", // 每天8点
to: "qqbot:group:群号",
name: "daily-news-reminder"
})
// 查看所有提醒
qqbot_remind({ action: "list" })
// 删除提醒
qqbot_remind({
action: "remove",
jobId: "提醒任务ID"
})// 每天早上8点推送AI新闻
qqbot_remind({
action: "add",
content: "生成今日AI新闻日报并推送到QQ群",
time: "0 8 * * *",
name: "ai-news-daily"
})// 结合cron任务监控网站
cron({
action: "add",
job: {
name: "site-monitor",
schedule: { kind: "every", everyMs: 300000 }, // 每5分钟
sessionTarget: "isolated",
payload: {
kind: "agentTurn",
message: "检查miaoquai.com是否正常访问，如果异常发送QQ告警"
}
}
})// Agent收到QQ群消息后自动回复
// 用户在群里@机器人提问 → Agent分析问题 → 返回答案
// 配置关键词触发：
// "工具推荐" → 返回最新AI工具推荐
// "今日新闻" → 返回AI新闻摘要
// "教程" → 返回相关教程链接// 一条消息同时发到QQ群、飞书群、Discord
const message = "🔥 OpenClaw v2026.6.6发布！安全大加固，14个PR合并"
message({ action: "send", channel: "qqbot", target: "group:123456", message })
message({ action: "send", channel: "feishu", target: "chat:oc_xxx", message })
message({ action: "send", channel: "discord", target: "1483699648890802201", message })| 格式 | 说明 | 示例 |
|---|---|---|
| 文本 | 纯文本消息 | "Hello World" |
| 图片 | 发送图片 | media: "/path/to/image.png" |
| 文件 | 发送文件 | media: "/path/to/file.pdf" |
| @某人 | 提及群成员 | "@用户名 请查看" |
| 回复 | 回复特定消息 | replyTo: "messageId" |
检查QQ开放平台的消息订阅配置，确保已开启"群消息"事件订阅，并正确配置了回调URL。
确认AppID和AppSecret正确，机器人已加入目标群，且有发送消息的权限。
在OpenClaw的Agent配置中设置触发规则，或者使用cron定时扫描群消息并响应。