OpenClaw + QQBot：5分钟把 AI 接到 QQ 群

OpenClaw 系列教程第 8 篇，聊聊怎么把 AI 助手接进 QQ，让它帮你自动回复消息、处理客服咨询、发定时通知。

你能学到什么？

• ✅ 5分钟配置 QQ 机器人接入 OpenClaw
• ✅ 私聊、群聊、语音、文件全部能力的使用方法
• ✅ 搭建 FAQ 机器人 + 定时提醒的真实配置
• ✅ 常见报错的排障指南（"去火星了"、收不到消息等）

先说痛点

如果你同时管着几个 QQ 群，大概率遇到过这些情况：

• 群友反复问同一个问题（「怎么重置密码」「活动什么时候开始」），你回复到想吐
• 重要通知要一个一个 @人，发完自己都怀疑有没有漏
• 想让大家定时交周报，但没有工具提醒，只能靠手动催

现在有了 QQBot 插件，这些都可以自动化。

一、QQBot 插件能做什么？

先搞清楚这个插件的能力边界：

不支持什么？

• 主动给人发消息（QQ 平台限制，机器人不能私聊未主动联系它的用户）
• 监听所有群消息而不 @（会触发 QQ 的限流机制）

二、5分钟接入：真实安装步骤

第一步：创建 QQ 机器人

1. 打开 q.qq.com^[1]，用手机 QQ 扫码登录
2. 点击「创建机器人」→「企业自建机器人」
3. 填写名称和简介，提交后进入详情页
4. 在「凭证与基础信息」里找到 AppID 和 AppSecret，复制保存

第二步：一键安装（最简单方式）

在服务器上运行这一行命令，把 YOUR_APPID 和 YOUR_SECRET 换成你刚才复制的：

curl -fsSL https://raw.githubusercontent.com/tencent-connect/openclaw-qqbot/main/scripts/upgrade-via-npm.sh \
  | bash -s -- --appid YOUR_APPID --secret YOUR_SECRET

脚本会自动：安装插件 → 配置 Token → 重启 Gateway

第三步：验证连接

在 QQ 里找到你的机器人，给它发一条：

你好

AI 回复了说明接入成功。如果没反应，看最后一节的排障指南。

三、进阶配置：手动安装

如果一键脚本不生效（比如网络问题），可以手动安装：

# 1. 安装插件
openclaw plugins install @tencent-connect/openclaw-qqbot@latest

# 2. 配置 QQ 频道
openclaw channels add --channel qqbot --token "YOUR_APPID:YOUR_SECRET"

# 3. 重启 Gateway
openclaw gateway restart

配置完成后，在 ~/.openclaw/openclaw.json 里能看到 channels.qqbot 节点。

四、群聊实战配置

基础群聊（@机器人触发）

群友在群里发：

@你的机器人 你好

机器人就会回复，无需其他配置。

开启上下文（连续对话）

默认每次 @ 都是独立对话。如果想开启上下文（在群里多轮对话）：

在 OpenClaw 配置文件里，给 QQ 渠道加上 context 参数：

"channels": {
  "qqbot": {
    "enabled": true,
    "context": true,
    "maxContext": 10
  }
}

专属机器人角色（客服场景）

你想让机器人在某些群里扮演「售后客服」，在另一些群里扮演「产品助手」？可以为不同群配置不同的 systemPrompt：

"channels": {
  "qqbot": {
    "accounts": {
      "群号1": {
        "systemPrompt": "你是一个售后客服，熟悉所有退货退款政策，回复要专业简洁。"
      },
      "群号2": {
        "systemPrompt": "你是一个产品专家，专注于介绍产品功能和使用技巧。"
      }
    }
  }
}

五、智能客服场景搭建

FAQ 自动回复

最常见的用法：常见问题让 AI 自动回答，人工只处理复杂问题。

配置步骤：

1. 在 OpenClaw 里配置知识库（可以是飞书文档、本地文件夹、或 Alist 挂载的网盘）
2. 给 QQ 渠道配置客服角色 Prompt：

你是公司客服助手，熟悉产品使用指南和常见问题。
用户提问时先检索知识库，只回答文档里有的内容。
回答要简洁，格式清晰，重要信息用加粗标注。

1. 效果：用户问「怎么重置密码」，AI 自动从知识库检索并回答

定时推送提醒

结合 OpenClaw cron，可以做主动提醒：

# 每天早上9点推送到群
cron: "0 9 * * *"
message: "📢 早安！今日待办：\n1. 周报提交\n2. 会议纪要review"

# 每周五下午6点提醒周报
cron: "0 18 * * 5"
message: "📋 周五提醒：记得提交本周工作总结到飞书文档"

在 OpenClaw 配置文件里加入 cron 任务，机器人会在指定时间主动发消息到指定群。

六、斜杠指令

机器人内置了几个指令，私聊发送即可使用：

七、常见问题排障

报错「去火星了」

表现：发消息给机器人，提示「对方已经去火星了，暂时无法接收消息」

原因：AppID/AppSecret 配置错误或未生效

解决：

1. 确认 Token 格式正确：AppID:AppSecret（注意是英文冒号）
2. 重启 Gateway：openclaw gateway restart
3. 确认 QQ 机器人已「发布」状态（不是开发中）

机器人完全无响应

排查顺序：

# 1. 确认插件已安装
openclaw plugins list | grep qqbot

# 2. 查看 Gateway 日志
tail -f ~/.openclaw/logs/gateway.log

# 3. 确认频道已启用
openclaw channels list

收不到群消息

1. 确认机器人已加入群聊
2. 群消息必须 @机器人 才会触发（除非配置了监听模式）
3. 检查 QQ 安全中心是否拦截了机器人消息

/bot-upgrade 升级失败

脚本方式安装的插件不支持此方式升级。手动升级：

openclaw plugins update @tencent-connect/openclaw-qqbot@latest
openclaw gateway restart

总结

QQBot 插件让 AI 助手直接进入 QQ 生态：

• ✅ 5分钟接入，零门槛
• ✅ 私聊/群聊/语音/文件全覆盖
• ✅ 配合知识库 = FAQ 机器人
• ✅ 配合 cron = 定时提醒推送
• ✅ 热更新：发条消息就能升级插件

引用链接