OpenClaw 接入 QQ Bot 完整指南:让你的 AI 助手入驻 QQ
TL;DR: OpenClaw 2026.3.31 正式支持 QQ Bot,可以接入 QQ 私聊、群聊,支持图片、语音、视频、文件等富媒体消息,还支持语音识别、日程提醒、Markdown 格式化等功能。
背景
QQ 是国内最主流的即时通讯工具之一,拥有大量技术社区用户。在此之前,OpenClaw 已经支持了钉钉、Slack、Telegram、飞书等渠道,这次更新终于把 QQ 也纳入了版图。
这次 QQ Bot 支持是由腾讯官方团队贡献的(@sliverp),直接对接 QQ 官方 Bot API,不是第三方桥接,稳定性有保障。
功能特性一览
| 功能 | 说明 |
|---|---|
| 🔒 多场景支持 | C2C 私聊、群 @消息 |
| 🖼️ 富媒体 | 支持收发图片、语音、视频、文件 |
| 🎙️ 语音识别(STT) | 语音消息自动转文字,AI 像处理文字一样处理语音 |
| 🔥 一键热升级 | 在私聊窗口发 /bot-upgrade 即可升级,无需登录服务器 |
| ⏰ 定时推送 | 通过 OpenClaw cron 定时主动发消息 |
| 🔗 URL 直链 | 私聊支持直接 URL 发送,无限制 |
| ⌨️ Typing 指示器 | 对方能看到「Bot 正在输入…」状态 |
| 📝 Markdown 格式 | 支持完整的 Markdown 渲染 |
| 💬 引用消息上下文 | 能识别 QQ 的 REFIDX_* 引用并注入引用内容到 AI 上下文 |
| 📦 大文件支持 | 最大支持 100MB 文件自动分片上传 |
安装前提
1. 创建 QQ 机器人
前往 QQ 开放平台 创建应用,获取:
- App ID
- App Secret
2. 安装插件
openclaw plugins install @sliverp/qqbot
3. 配置
在 openclaw.json 中添加:
channels:
qq:
enabled: true
appId: "YOUR_APP_ID"
appSecret: "YOUR_APP_SECRET"
# 多账号支持
accounts:
- appId: "YOUR_APP_ID_1"

