【全网首发！】OpenClaw QQ Manager v2.0：Docker 一键部署，让你的 QQ 个人号秒变 AI 助手

本项目 OpenClaw IM Manager 是一个开源学习项目，仅供技术研究和学习交流使用。

🚫 严禁商用

本项目采用 CC BY-NC-SA 4.0 许可证，明确禁止任何商业用途，包括但不限于：

• 付费服务、收费机器人、会员制服务
• 出售、转卖、打包售卖
• 任何形式的盈利活动（广告、打赏、会员费等）

⚠️ 使用风险

• 使用第三方客户端登录 /微信 可能违反腾讯服务协议，存在封号风险
• 强烈建议使用小号测试，切勿使用主力账号
• 使用者需 自行承担一切风险和法律责任

🔒 项目性质

• 本项目 未进行任何逆向工程、协议激活成功教程、反编译 等操作
• 仅将已有开源组件（NapCat、wechatbot-webhook、OpenClaw）通过 Docker 整合
• 不包含任何 或微信的协议实现代码
• 作者 openclaw docker 教程未从本项目中获取任何经济收益

📋 知识产权

• 、微信是深圳市腾讯计算机系统有限公司的注册商标
• 本项目与腾讯公司无任何关联
• 所有第三方组件遵循其各自的开源许可证

下载/使用本项目即表示您已阅读并同意 完整免责声明。如不同意，请勿使用。

想让你的 个人号拥有 AI 对话能力？私聊自动回复、群聊 @回复、防撤回、入群欢迎……这些功能只需要一个 Docker 容器就能全部搞定。

OpenClaw Manager v2.0 是一个开源项目，将 NapCat（ 协议层）、OpenClaw（AI 引擎）和管理后台整合到一个 Docker 容器中，实现真正的一键部署。

GitHub 地址：https://github.com/zhaoxinyi02/openclaw–plugin

相比 v1.0，v2.0 做了大量改进：

你能得到什么？

• 私聊/群聊 AI 自动回复（对接 OpenClaw Agent，支持任意 AI 模型）
• 防撤回、戳一戳回复、入群欢迎、自动审核等个人号功能
• Web 管理后台： 登录、配置 OpenClaw、管理 Bot、审核请求
• 不需要单独安装 NapCat，一个容器全搞定
• 登录 session 持久化，重启不掉线

关键设计：

• NapCat 作为容器主进程运行（需要 Xvfb 虚拟显示器运行 桌面客户端）
• 管理后台作为后台进程，通过容器内部 WS 连接 NapCat
• 管理后台提供 WS 代理路径，让宿主机的 OpenClaw 能连接到容器内的 NapCat
• 登录 session 通过 Docker Volume 持久化

没装 OpenClaw？ 执行以下命令：

第一步：克隆项目

第二步：配置环境变量

必须修改的配置：

第三步：一键启动

首次启动需要构建镜像，约 2-5 分钟。容器会自动完成：

1. 解压并配置 NapCat
2. 配置 OneBot11 WebSocket
3. 安装 Channel 插件到 OpenClaw extensions
4. 在 openclaw.json 中注册 频道配置
5. 启动管理后台

第四步：扫码登录

1. 浏览器打开
2. 输入你设置的 密码登录
3. 左侧菜单点击 「 登录」
4. 手机 扫描二维码
5. 登录成功后左上角显示 昵称和号码

第五步：配置 OpenClaw 连接

OpenClaw 需要通过管理后台的 WS 代理连接 NapCat：

第六步：测试

用另一个 号给机器人发私聊消息，收到 AI 回复就说明部署成功！

1. NapCat 登录 API 代理

NapCat WebUI 使用 进行认证。管理后台代理 NapCat 的 HTTP API，实现登录功能集成：

2. OneBot WebSocket 代理

NapCat 的 OneBot WS 只监听容器内 ，Docker 端口映射无法转发。解决方案是在管理后台的 HTTP 服务器上添加 路径的 WS 代理：

3. QR 码本地渲染

NapCat 返回的是 URL 而非图片，使用 库在前端将 URL 转为二维码：

4. Session 持久化

通过 Docker Volume 持久化 登录数据，重启不掉线：

仪表盘

• NapCat 连接状态、Bot 昵称、 号
• 群数量、好友数量
• OpenClaw 配置状态、当前 AI 模型
• 实时事件流

登录（v2.0 新增）

集成三种登录方式，无需单独访问 NapCat WebUI：

• 扫码登录：二维码本地渲染，扫码后自动检测登录状态
• 快速登录：选择已登录过的账号一键登录
• 账密登录：输入 号和密码（MD5 在服务端计算，安全可靠）

OpenClaw 配置

• 在线查看/编辑 openclaw.json
• 快速查看模型、频道、插件状态

Bot 管理

• 群列表、好友列表
• 在线发送消息（私聊/群聊）
• 重连 NapCat

审核中心

• 好友/入群请求列表
• 一键同意/拒绝

设置

• 主人 号
• 防撤回开关
• 戳一戳回复（开关 + 自定义回复列表）
• 入群欢迎（开关 + 模板 + 延迟）
• 自动审核（好友/群，正则规则）
• 通知开关（成员变动、管理员变动、禁言等）

Q: 管理后台显示”NapCat 未连接”？

A: 还没登录。去 登录页面扫码即可。

Q: 扫码登录后发消息没有 AI 回复？

A: 检查 OpenClaw 是否正确连接：

如果没有，确认 中 为 。

Q: 重启容器后需要重新扫码吗？

A: 不需要， 登录 session 已持久化到 Docker Volume。

Q: 如何更换 AI 模型？

A: 管理后台 → OpenClaw 配置 → 编辑 字段。

Q: 如何更新到新版本？

Q: 如何查看日志？

OpenClaw Manager v2.0 实现了真正的一键部署体验：

1. 克隆项目 → 2. 配置密码 → 3. → 4. 扫码登录 → 5. 开始使用

整个过程不超过 5 分钟。

核心亮点：

• 零配置：自动检测 OpenClaw、自动注册 插件、自动配置频道
• 一键部署： 搞定一切
• 功能完整：AI 对话 + 防撤回 + 戳一戳 + 欢迎 + 审核 + 通知
• 管理方便：Web 管理后台，在线配置一切
• 稳定可靠：Session 持久化，WS 代理解决网络问题

如果觉得有用，欢迎 Star ⭐ 支持：https://github.com/zhaoxinyi02/openclaw–plugin