本文将详细介绍如何通过 OpenClaw(原名 Clawdbot/MoltBot)实现 QQ 机器人接入。整体操作流程并不复杂,只需按以下关键步骤逐步执行即可顺利完成配置。
接入前提条件
当前教程仅适用于 2026.2.2-3 及以上版本。你可前往 LS 控制台的「应用管理」页面查看当前版本号进行确认。

若你正在使用旧版本,可通过重装功能切换至新版镜像。需要特别提醒:重装操作将清空原有实例数据且无法恢复,因此请务必提前备份重要数据后再执行重装。
此外,在进行 QQ 配置之前,请先参考模型配置文档完成模型设置,切勿颠倒操作顺序。
配置 QQ 开放平台
请登录 QQ 开放平台,操作步骤如下:
1. 已有账号的用户直接输入账号密码登录即可。
2. 新用户请点击「立即注册」,按照页面提示填写个人信息,完成账号注册。

登录成功后,点击左侧导航栏中的「机器人」选项,创建一个全新的机器人,或直接选择已有的机器人进行配置。

进入机器人详情页后,找到「开发管理」页面,将 LS 服务器的公网 IP 地址添加到 IP 白名单中,然后点击保存。

公网 IP 的获取方式:在 LS 服务器的「概要信息」页面即可直接查看。

仍在「开发管理」页面中,找到当前机器人的 AppID 和 AppSecret,将其复制并妥善保存,后续配置步骤需要用到这些信息。

接下来请在 LS 控制台完成消息平台配置:
点击「Channel 配置」,在下拉列表中选择 QQ,然后填入刚才获取的 AppKey 和 AppSecret,最后点击「应用」即可。

进入「机器人沙箱配置」页面,为 QQ 群和 QQ 账号分别添加相应权限。请注意:目前 QQ 群因官方系统维护暂时无法添加,具体恢复时间请关注 QQ 机器人平台的最新公告。


所有配置完成后,点击二维码图标,将弹出的二维码分享给群成员,对方扫码即可添加机器人并开始对话。

实际效果展示
添加机器人后的界面效果

与机器人进行对话的实际效果
