OpenClaw 接入 QQ 机器人完整教程
AIHub获悉,腾讯 QQ 已正式开放 OpenClaw 官方接入能力,用户可以直接创建 QQ 机器人并绑定 OpenClaw,实现通过 QQ 与 AI Agent 对话。 配置完成后,你可以: - 在 QQ 私聊 AI
- 在群聊 @AI
- 通过 QQ 执行自动化任务
- 用 QQ 控制本地 AI Agent
- 支持Markdown、图片、语音、文件等多媒体消息收发,手机端QQ、桌面端QQ均可使用。
整个接入流程非常简单,只需要 4 步即可完成配置。  一、OpenClaw + QQ 机器人是什么
OpenClaw 是一个开源 AI Agent,可以在本地或服务器运行,通过消息平台接收指令并自动执行任务。 现在 QQ 官方提供了 QQ Bot 接口插件,可以让 OpenClaw 接入 QQ 平台,实现: - QQ 私聊 AI
- QQ 群聊 AI
- QQ 频道 AI
- 自动化消息处理
QQ Bot 插件支持: - C2C 私聊消息
- 群聊 @机器人
- 频道消息
- 自动重连和消息去重等功能。
简单理解: - QQ → QQ机器人 → OpenClaw Gateway → AI模型
二、接入前准备
在开始之前,需要准备: 1 已安装 OpenClaw
如果还没有安装,可以参考: OpenClaw 可以运行在: - Mac
- Windows
- Linux
- VPS服务器
- Docker
2 一个 QQ 账号
用于创建机器人。 3 一个运行中的 OpenClaw
需要保证: 返回正常。 三、创建 QQ 机器人
打开 QQ 官方机器人入口: - https://q.qq.com/qqbot/openclaw/login.html
然后按照步骤操作。 第一步:扫码登录
使用手机 QQ 扫码登录开发者平台。 如果没有实名认证,需要先完成实名认证。 第二步:创建机器人
点击: 然后填写: 创建完成后系统会生成: 每个 QQ 账号最多可以创建 5 个机器人。  四、获取 QQ 机器人密钥
进入 开发管理页面。 可以看到: OpenClaw 使用的 Token 格式为: 例如: 这个 Token 用于 OpenClaw 连接 QQ Bot。 五、配置 OpenClaw
接下来需要在 OpenClaw 中添加 QQ 配置。 打开 OpenClaw 配置文件。 添加: - QQ_BOT_TOKEN=AppID:AppSecret
例如: - QQ_BOT_TOKEN=102146862:xxxxxx
保存配置。 六、重启 OpenClaw
运行: 然后检查状态: 如果显示运行正常,说明 QQ 已连接成功。 七、测试 QQ AI 机器人
打开 QQ。 搜索刚创建的机器人。 发送消息,例如: 如果配置成功,OpenClaw AI 会自动回复。 八、群聊使用方法
你可以把机器人加入 QQ 群。 然后在群里使用: 例如: AI 会自动回复。 九、QQ AI 机器人的能力
接入 OpenClaw 后,QQ 机器人不仅可以聊天,还可以执行任务。 例如: AI 助理
自动化任务
群管理助手
十、常见问题
QQ 机器人没有回复
可能原因: - Token 配置错误
- OpenClaw Gateway 未运行
- 机器人未启用
检查: QQ 机器人可以加入群吗
可以。 只要把机器人邀请进群即可。 一个 QQ 可以创建多少机器人
最多 5 个机器人。 十一、安全建议
OpenClaw 具有执行系统命令的能力,因此需要注意: - 不要给 AI root 权限
- 不要暴露 OpenClaw 面板
- 定期更新 OpenClaw
OpenClaw 是一个开源 AI Agent,可以自动执行任务,因此错误配置可能带来安全风险。 总结
腾讯 QQ 官方开放 OpenClaw 接入后,现在可以直接在 QQ 中使用 AI Agent。 完整流程: - 创建QQ机器人
- 获取AppID和AppSecret
- 配置OpenClaw
- 启动Gateway
- QQ聊天测试
完成后,你就可以通过 QQ 控制 AI 助手。
|