OpenClaw(原 Clawdbot)作为一款强大的开源 AI Agent,不仅支持常用的 Telegram 和 Discord,对于国内开发者来说,接入 QQ 实现 AI 自动化处理也是非常实用的场景。今天分享如何通过腾讯云轻量应用服务器(Lighthouse)一键部署并快速对接 QQ 机器人。
![]()
一、 云端环境部署
推荐使用腾讯云轻量应用服务器 (Lighthouse),它提供了 OpenClaw 的专用应用镜像,可以实现免 Docker 配置的一键部署。
创建实例:进入 Lighthouse 控制台,选择“应用模板”,在 AI 智能体分类中勾选 OpenClaw (Clawdbot)。
当然如果你是用的是非腾讯服务器,恰好使用的是 1Panel,同样也可以快捷的安装 OpenClaw,而且现在各大厂商基本都支持 OpenClaw 的快速安装了。
地域建议:若主要用于对接 QQ,建议优先选择国内地域,以确保与腾讯 API 通信的稳定性。
配置模型:部署完成后,在应用管理界面配置你的 LLM API Key(如 DeepSeek、GLM 等)。
二、 QQ 机器人配置
在接入前,需要先在 QQ开放平台 准备好机器人凭证。
![]()
创建机器人:注册 QQ开放平台 并完成实名认证,创建一个新的机器人应用。
获取凭证:记录下应用的 AppID 和 AppSecret。
设置 IP 白名单:在 QQ开放平台的 app 页面,找到对应的机器人,点击进入可以查看配置信息(内测阶段忽略即可,不需要发布也可以使用)。

沙箱设置:由于 QQ 侧政策,目前主要支持单聊场景测试,需将自己的 QQ 号加入沙箱测试名单(默认自动增加 QQ号)。
三、 通道接入与上线
Lighthouse OpenClaw 提供了直观的配置界面,同时也支持命令行操作。
面板配置:在 Lighthouse 应用管理中打开 OpenClaw 配置页,找到 OpenClaw Channel (通道配置)。

填入参数:选择 QQ 接入入口,填入刚才获取的 AppID 和 AppSecret。

安装 QQ 机器人插件:若镜像未预装,可通过终端执行:
openclaw plugins install @sliverp/qqbot@latest
重启生效:保存配置并执行
openclaw gateway restart。
1Panel 用户可以参考以下步骤:
登录 1Panel 面板,进入 “应用中心” -> “已安装”。
找到 OpenClaw 应用,点击 “详情” 或直接点击右侧的 “终端” 按钮。
进入终端后,确保你处于 OpenClaw 的执行环境。
安装 QQ 机器人插件。在容器终端内执行:
openclaw plugins install @sliverp/qqbot@latest
注:安装过程会下载依赖,请耐心等待。安装完成后,可用 openclaw plugins list 查看是否出现 QQ Bot 且状态为 loaded。
配置 QQ 频道信息
执行命令添加账号凭证(将 你的AppID 和 你的AppSecret 替换为真实值):
openclaw channels add --channel qqbot --token "你的AppID:你的AppSecret"
提示:如果命令执行成功,会提示 Added QQ Bot account 'default'。
并执行
openclaw gateway restart重启生效。1Panel 特有注意事项
持久化目录:1Panel 默认会将 OpenClaw 的配置文件挂载在宿主机的 /opt/1panel/apps/openclaw/data(具体视安装路径而定)。如果以后需要手动修改配置,可以直接在 1Panel 的 “文件” 管理器中编辑该目录下的 openclaw.json。
容器更新:如果你通过 1Panel 更新了 OpenClaw 版本,插件可能需要重新安装(取决于你的挂载策略)。建议将插件目录也进行挂载持久化。
网络模式:确保 OpenClaw 容器可以正常访问外网(尤其是 GitHub 和腾讯 API),否则插件下载或消息接收会失败。
四、 测试验证
使用你的 QQ 账号私聊机器人发送测试指令(如 /start 或简单的问候)。如果机器人能够根据配置的 LLM 逻辑进行实时回复,则表示接入成功。
![]()
五、 核心注意事项
• 网络安全:OpenClaw 具有强大的文件与浏览器控制能力,请务必在隔离的云环境运行,严禁在包含敏感数据的本地宿主机直接运行。
• 群聊限制:受平台政策影响,QQ 机器人的群聊配置目前可能受限,建议优先以单聊或频道模式作为主要交互场景。
未经允许不得转载:前端资源网 - w3h5 » 腾讯云服务器安装OpenClaw快速接入QQ机器人指南
前端资源网 - w3h5