一、所需资料
腾讯QQ账号
需要完成实名认证的QQ账号
已完成OpenClaw部署
确保OpenClaw已在你的服务器上运行
二、接入QQ教程
第一步：注册QQ开放平台
- 访问 QQ开放平台
- 设置超级管理员账号
- 填写主体信息（个人或企业）
- 完成人脸认证验证身份
第二步：创建QQ Bot机器人
- 登录QQ开放平台控制台
- 点击"创建机器人"
- 填写机器人名称、简介、头像
- 获取 AppID 和 AppSecret
💡 重要提示
请妥善保存AppID和AppSecret，这是配置OpenClaw的关键凭证。
第三步：沙箱配置
单聊测试
设置与QQ机器人单独聊天，验证基础功能
群聊测试
设置将QQ机器人加入群聊，测试群组功能
第四步：为OpenClaw配置模型和通道
bash
# 配置模型API Key
openclaw config set model.apiKey your_api_key
# 添加QQ通道
openclaw channel add qq \
--app-id YOUR_APP_ID \
--app-secret YOUR_APP_SECRET三、与QQ机器人互动
配置完成后，你可以在QQ中与机器人进行单聊或群聊：
单聊模式
直接搜索机器人名称，添加好友后私聊
群聊模式
将机器人邀请进群，群成员@机器人即可对话
支持的消息类型
| 方向 | 类型 | 说明 |
|---|---|---|
| 接收 | 文本 | 普通文字消息 |
| 图片 | 图片消息，支持AI分析 | |
| 文件 | 文档、压缩包等文件 | |
| 回复 | 文本 | 普通文字回复 |
| 图片 | 图片回复 | |
| Markdown | 富文本格式回复 | |
| 语音消息 | 文字转语音回复 | |
| 历史引用 | 引用历史消息回复 | |
| 主动 | 主动消息 | 机器人主动推送消息 |
四、常见问题
🚀 机器人回复"该机器人去火星了"
解决方案：
- 检查AppID和AppSecret是否正确配置
- 确认OpenClaw Gateway服务是否正常运行
- 查看防火墙是否允许QQ开放平台的回调请求
- 检查日志中的错误信息：
openclaw logs --channel qq - 尝试重新授权：
openclaw channel reconnect qq
💡 其他问题排查
- 确保QQ账号已完成实名认证
- 检查机器人是否已发布上线
- 验证沙箱环境配置是否正确