OpenClaw 接入 QQ 机器人：私聊、群聊、富媒体全搞定

OpenClaw 官方推出了 @tencent-connect/openclaw-qqbot 插件，让你的 AI 助手接入 QQ——私聊、群聊、富媒体，一个插件全搞定。

功能特性

• 🔒 多场景支持：C2C 私聊、群聊 @消息、频道消息、频道私信
• 🖼️ 富媒体消息：支持图片、语音、视频、文件的收发
• 🎙️ 语音能力 (STT/TTS)：语音转文字自动转录 & 文字转语音回复
• ⏰ 定时推送：支持定时任务触发后主动推送消息
• 🔗 URL 无限制：私聊可直接发送 URL
• ⌨️ 输入状态：实时显示"Bot 正在输入中…"状态
• 📝 Markdown：完整支持 Markdown 格式消息

第一步：在 QQ 开放平台创建机器人

1、前往 QQ 开放平台，用手机 QQ 扫描页面二维码即可注册/登录。若尚未注册，扫码后系统会自动完成注册并绑定你的 QQ 账号。

2、手机 QQ 扫码后选择同意，即完成注册，进入 QQ 机器人配置页。

3、点击创建机器人，即可直接新建一个 QQ 机器人。

4、在机器人页面中找到 AppID 和 AppSecret，分别点击右侧复制按钮，保存好。AppSecret 不支持明文保存，离开页面后再查看会强制重置，请务必妥善保存。

⚠️ 机器人创建后会自动出现在你的 QQ 消息列表中，并发送第一条消息。但在完成下面的配置之前，发消息会提示"该机器人去火星了"，属于正常现象。

第二步：安装插件

打开终端，执行以下命令：

openclaw plugins install @tencent-connect/openclaw-qqbot

第三步：配置 OpenClaw

方式一：通过命令行配置（推荐）

openclaw channels add --channel qqbot --token "AppID:AppSecret"

把 AppID 和 AppSecret 替换成你自己的。

方式二：编辑配置文件

编辑 ~/.openclaw/openclaw.json，在 channels 中添加：

{
  "channels": {
    "qqbot": {
      "enabled": true,
      "appId": "你的 AppID",
      "clientSecret": "你的 AppSecret"
    }
  }
}

第四步：启动与测试

openclaw gateway restart

打开 QQ，找到你的机器人，发条消息试试！

将机器人添加到 QQ 群（个人不支持群聊添加机器人）

有两种方式：

1. 机器人创建群：在 QQ 开放平台创建机器人时，可以创建一个以机器人为群主的群。
2. 邀请机器人加入现有群：如果你是群主/管理员，在手机 QQ 打开群聊 → 群设置 → 群机器人 → 选择你的机器人添加。

⚠️ 需要先在 QQ 开放平台 → 你的机器人 → 场景能力 → 开启「群聊」权限。

进阶功能

发送图片

AI 可以通过 <qqimg>路径</qqimg> 发送图片，支持本地文件路径和网络 URL。

格式支持：jpg/png/gif/webp/bmp

发送语音

AI 可以通过 <qqvoice>路径</qqvoice> 发送语音消息。

格式支持：mp3/wav/silk/ogg，无需安装 ffmpeg。

常见问题

Q: 发消息提示"该机器人去火星了"？
A: 说明配置还没完成或 Gateway 没启动，检查配置并重启 Gateway。

Q: 如何添加多个机器人？
A: 在配置文件中使用 accounts 字段配置多账户，详见插件 README。

相关链接

• openclaw-qqbot GitHub
• QQ 开放平台
• OpenClaw 文档