OpenClaw 对接 QQ 机器人教程:本地与云端部署
详细讲解了如何使用 OpenClaw 开源平台对接 QQ 机器人。内容包括环境准备(Docker 安装、大模型 API 配置)、两种接入方案(QQ 开放平台官方 Bot 与个人号通过 NapCat 接入)的具体操作步骤、常见问题避坑指南以及进阶技能扩展方法。适合希望搭建本地或云端 AI 自动化助手的开发者参考。

详细讲解了如何使用 OpenClaw 开源平台对接 QQ 机器人。内容包括环境准备(Docker 安装、大模型 API 配置)、两种接入方案(QQ 开放平台官方 Bot 与个人号通过 NapCat 接入)的具体操作步骤、常见问题避坑指南以及进阶技能扩展方法。适合希望搭建本地或云端 AI 自动化助手的开发者参考。

还记得以前玩 QQ 机器人吗?那时候得写一堆乱七八糟的代码,还得防着被系统检测,搞得跟做贼似的。现在好了,OpenClaw 这个开源神器直接把门槛砍到了脚底板——你只需要会复制粘贴,就能让 AI 住进你的 QQ,帮你回消息、抓数据、写周报,甚至帮你打游戏挂机。
OpenClaw 的前身叫 Clawdbot,后来又改名叫 Moltbot,现在定名为 OpenClaw。它是一个本地优先的 AI 自动化平台,核心逻辑是'让 AI 帮你干杂活'。今天这篇教程,手把手教你把它对接进 QQ,不管是本地笔记本还是腾讯云服务器,都能跑起来。
在动手之前,你得先想清楚要走哪条路。OpenClaw 对接 QQ 目前有两套方案:
这是正规军路线。你去 QQ 开放平台注册个开发者账号,创建一个机器人,拿到 AppID、AppSecret、Token 这三件套,然后配置到 OpenClaw 里。好处是稳定、合法合规,坏处是只能单聊和频道,不能直接在普通 QQ 群里玩(除非申请特殊权限)。
这是更实用的方案。通过 NapCat(以前叫 go-cqhttp)这类第三方框架,把你的个人 QQ 号改造成机器人,然后对接 OpenClaw。好处是可以在普通 QQ 群里@你使用,体验更自然;坏处是……只要你别拿去做违法乱纪的事。
建议两手准备:先用官方 Bot 练手,熟悉了再部署个人号方案。下面我会把两种方法都讲透。
不管你选哪种方案,都需要先准备好 OpenClaw 的运行环境。
如果你用腾讯云,阿里云那边已经有现成的镜像,一键部署就行。如果是本地或者别的云厂商,用 Docker 最省事:
拉取最新镜像
docker pull openclaw/openclaw:latest
运行容器
docker run -d --name openclaw -p 18789:18789 -v ~/.openclaw:/root/.openclaw openclaw/openclaw:latest
安装完成后,浏览器访问 http://你的 IP:18789,能看到控制台就说明成了。
OpenClaw 本身不带大脑,需要接个大模型。推荐用阿里云百炼,新用户送 7000 万 tokens,够你玩几个月了。拿到 API Key 后,配置文件里填一下:
进入配置目录
cd ~/.openclaw
编辑配置文件
cat > openclaw.json <<'EOF'
{
"models": {
"providers": {
"bailian": {
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"apiKey": "sk-你的 APIKey",
"models": [{"id": "qwen3-max-2026-01-23", "name": "通义千问 3", "reasoning": false}]
}
}
}
}
EOF
注意:reasoning 一定要设成 false,否则百炼模型返回的内容会是空的,这是个坑。
这个方案适合想正儿八经做个服务的朋友,比如给公司做个内部问答助手。
进入机器人管理页面,在'开发管理'里找到:
把这三个东西粘到记事本里,等会儿要用。
在'安全配置'里添加你的服务器公网 IP,这是为了防止别人盗用你的机器人。然后在'沙箱测试'里添加你的个人 QQ 号,只有这个号能在测试阶段跟机器人聊天。
回到服务器,安装 QQ 官方插件并配置:
安装 QQ 官方插件
openclaw plugins install qqbot
配置凭证(把引号里的内容换成你的)
openclaw config set channels.qq.enabled true
openclaw config set channels.qq.appId "你的 AppID"
openclaw config set channels.qq.appSecret "你的 AppSecret"
openclaw config set channels.qq.token "你的 Token"
openclaw config set channels.qq.sandbox true # 沙箱模式,测试完改 false
openclaw config set channels.qq.allowPrivateChat true
重启服务
openclaw gateway restart
打开手机 QQ,搜索你的机器人名字,添加好友后发消息'你好',如果收到回复,恭喜你,对接成功了!
官方 Bot 虽然正规,但限制太多。如果你想在普通 QQ 群里@机器人使用,或者让机器人帮你管理群,就得用个人号方案。这里我们用到 NapCat,它是目前最稳定的 QQ 协议库之一。
NapCat 可以理解为 QQ 的'外挂',它模拟 QQ 客户端登录,然后提供一个 HTTP/WebSocket 接口给 OpenClaw 调用。用 Docker 部署最简单:
运行 NapCat 容器(把 123456789 换成你的 QQ 号)
docker run -d --name napcat --restart=always -p 3001:3001 -p 6099:6099 mlikiowa/napcat-docker:latest QQ=123456789
第一次运行会生成二维码,用 QQ 手机版扫码登录。登录成功后,这个 QQ 号就处于'机器人模式'了。
查看容器 IP(OpenClaw 需要连这个地址)
docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' napcat
通常会输出类似 172.17.0.3 的地址,记住它。
安装个人号适配插件
openclaw plugins install qq-personal-bot
配置连接信息(IP 填上一步查到的)
openclaw config set channels.qq-personal.enabled true
openclaw config set channels.qq-personal.host "172.17.0.3"
openclaw config set channels.qq-personal.port 3001
openclaw config set channels.qq-personal.allowPrivateChat true
openclaw config set channels.qq-personal.allowGroupAt true # 允许群聊@
重启
openclaw gateway restart
把登录了 NapCat 的 QQ 号拉进一个群,@它说'帮我总结今天的群聊消息',如果它开始干活,说明整套流程跑通了。
sandbox: false,否则只有你自己能看到机器人,别人搜不到。对接成功只是开始,想让机器人变得有用,还得给它装'技能'。OpenClaw 有个技能市场叫 ClawHub,可以一键安装各种插件:
安装网页抓取技能
clawhub install web-scraper
安装文件管理技能
clawhub install file-manager
安装日历提醒技能
clawhub install calendar-manager
装完后,你就可以在 QQ 里直接发指令:
这些技能都是开源的,会编程的还可以自己写插件,用 JavaScript 或 Python 都行,文档在 GitHub 上很全。
现在你已经拥有了一个 24 小时在线的 QQ AI 助手。不管是让它帮你监控网站数据、自动回复客户咨询,还是单纯在群里展示,这套方案都足够稳定和省心了。
记住,技术本身不难,难的是动手去做。跟着这篇教程一步步来,有坑我也已经帮你填平了。如果过程中遇到问题,多看看日志(openclaw logs 命令),大部分错误信息都写得很明白。
最后提醒一句:玩机器人可以,但别拿去做骚扰别人、批量发广告这类讨打的事。技术无罪,但用技术的人要有底线。祝你的 OpenClaw 之旅愉快!

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 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