从 1 到 2：让 OpenClaw Agent 接管 QQ 的硬核指南_发布版
从 1 到 2让 OpenClaw Agent 接管 QQ 的硬核指南_发布版04-273.《OpenClaw (Docker手工部署版) 终极避坑与实战指南》03-23收起作者杨易 赛博龙虾环境RackNerd VPS (Linux) OpenClaw Kernel (Docker) NapCatQQ (Docker)目标突破 Telegram 严苛的 PC 端风控限制使用 QQ 小号完美接入 OpenClaw实现带有长文本思考、人设继承、全双工 WebSocket 通讯的 24 小时私人管家。在折腾了几十个小时、经历了无数次报错、甚至和 AI Agent 发生“逻辑斗智斗勇”之后我们终于打通了这套“脑机接口”并完成了底层架构的“统一网关路由”升级。为了不让后来者重蹈覆辙特整理此份血泪史。️ 终极架构速览 (同一大脑多端共享)最终跑通的完美架构如下宿主机 Docker 网络搭建起隔离但互通的虚拟网络。NapCatQQ 容器负责模拟 iPad/Linux 登录 QQ 小号通过 OneBot v11 协议对外暴露 WebSocket (3001 端口) 作为“耳朵和嘴巴”。OpenClaw Kernel 容器运行 Agent 大脑中枢。内部挂载一个 Python 桥接脚本QQ Ears它不再直接请求大模型 API而是作为统一网关路由遇到消息直接调用底层openclaw agent命令。这使得 QQ 端完美继承了官方 Telegram 机器人的长期记忆、系统人设与本地工具链 核心避坑指南按掉坑顺序排列坑一OpenClaw 的安全机制与“文件覆盖陷阱”表现Agent 假死不回话或者明明修改了宿主机的 Python 脚本并保存运行出来的依然是旧版本的代码报错。真相OpenClaw 严格禁止 Agent 运行复合后台命令。Docker 容器是极其封闭的集装箱。在宿主机/root/下修改并保存的文件绝对不会自动同步到容器内的/home/node/目录。解法每次修改代码后必须执行“极客三件套”强行覆盖并重启内存Bash# 1. 强行越权把宿主机的新文件塞进容器 sudo docker cp /root/qq_ears_brain.py openclaw_kernel:/home/node/qq_ears_brain.py # 2. 强制杀掉旧容器里的幽灵进程清理内存 sudo docker restart openclaw_kernel # 3. 前台点火监工 (没问题后再加 -d 放入后台) sudo docker exec -it openclaw_kernel python3 /home/node/qq_ears_brain.py坑二灵魂隔离与 Linux “位置法则” (告别手搓 API)表现QQ 端成了失忆的“复读机”性格与 Telegram 端截然不同且执行openclaw agent命令时频繁报错unknown option --no-color。真相自己写代码直连 DeepSeek API会丢失 OpenClaw 强大的上下文记忆和工具链。Linux 命令行的严苛法则全局选项--no-color必须紧跟在主程序后面子命令agent之前。位置一错全盘崩溃。解法实现“统一网关路由”。砍掉 API 密钥直接通过asyncio.create_subprocess_exec召唤底层内核并绝对精准地排列参数顺序openclaw,--no-color,agent。坑三企鹅厂的风控玄学与“幽灵假死”如何处理 QQ 掉线表现终端完美打印✅ 上线通知已发送代码无任何报错但你的大号 QQ 死活收不到消息发消息也不回。真相NapCat 遇到了“幽灵假死”。本地 Token 尚未过期所以不报错也不弹二维码但腾
