腾讯开放平台已提供 OpenClaw 接入入口,通过几条命令即可完成配置。安装完 OpenClaw 后,执行以下命令:
openclaw plugins install @sliverp/[email protected]
openclaw channels add --channel qqbot --token
openclaw gateway restart
OpenClaw 接入 QQ 机器人配置指南。主要步骤包括安装 QQ Bot 插件、获取应用凭证、配置 IP 白名单及启动网关服务。重点提示家用宽带因动态 IP 导致连接不稳定,推荐使用云服务器部署以确保稳定性。支持私聊、群聊@、图片文件收发等功能。

腾讯开放平台已提供 OpenClaw 接入入口,通过几条命令即可完成配置。安装完 OpenClaw 后,执行以下命令:
openclaw plugins install @sliverp/[email protected]
openclaw channels add --channel qqbot --token
openclaw gateway restart
⚠️ 重要提示:如果是家用宽带,没有申请固定 IP 地址的话,大可以放弃这种方式。由于 QQ 开发平台的白名单限制,机器人会非常不稳定,频繁掉线。建议使用云服务器或有固定 IP 的环境部署。
在完成 OpenClaw 安装后,除了飞书,我们还可以通过 QQ 机器人来控制你的 AI 助手。本文将介绍如何将 OpenClaw 接入 QQ 机器人平台。
但在此之前,必须提醒大家:QQ 机器人对网络环境要求极高。
在开始之前,必须坦诚地告诉你:
| 环境 | 推荐程度 | 说明 |
|---|---|---|
| 云服务器(阿里云/腾讯云) | ✅ 推荐 | 有固定 IP,稳定 |
| 企业宽带(固定 IP) | ✅ 推荐 | 稳定,但成本高 |
| 家用宽带(动态 IP) | ❌ 不推荐 | 不稳定,频繁掉线 |
如果你使用的是家用宽带,建议直接放弃 QQ 机器人方案,改用飞书或其他方式。
打开浏览器,访问 QQ 开放平台。 使用你的 QQ 号登录。
进入「应用管理」页面 点击「创建机器人」 填写应用名称(如:OpenClaw-QQ) 提交审核(沙箱模式下可添加测试用户)
创建成功后,在应用详情页获取:
💡 Token 格式为:
AppID:AppSecret(用冒号连接)
在 QQ 开放平台的应用设置中,找到「服务器配置」或「白名单设置」:
⚠️ 如果你的 IP 会变化,每次变更后都需要来这里更新白名单。
在终端执行以下命令:
openclaw plugins install @sliverp/[email protected]
等待 1-2 分钟,插件会自动下载安装。
⚠️ 安装过程需要一些时间,小内存机器请耐心等待
openclaw channels add
选择 qqbot,按提示输入 Token。
openclaw channels add --channel qqbot --token "AppID:AppSecret"
编辑 ~/.openclaw/openclaw.json:
{
"channels": {
"qqbot": {
"enabled": true,
"appId": "你的 AppID",
"clientSecret": "你的 AppSecret"
}
}
}
openclaw gateway restart
openclaw gateway --port 18789 --verbose
⚠️ 群聊中需要 @机器人 才能触发回复
| 功能 | 支持情况 |
|---|---|
| C2C 私聊 | ✅ 支持 |
| 群聊 @消息 | ✅ 支持 |
| 频道消息 | ✅ 支持 |
| 图片收发 | ✅ 支持 |
| 文件发送 | ✅ 支持 |
| Markdown 格式 | ✅ 支持 |
| 定时推送 | ✅ 支持 |
| 输入状态提示 | ✅ 支持 |
Q:机器人显示离线?
Q:收不到群消息?
Q:IP 频繁变更怎么办?
QQ 机器人接入 OpenClaw 本身并不复杂,但网络环境的限制是最大的痛点。
如果你有云服务器,配置好 IP 白名单后基本可以稳定使用。但如果你只有家用宽带,建议直接放弃这个方案——频繁的 IP 变更会让你疲于奔命,白名单永远跟不上变化。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online