让你的 QQ 和微信个人小号秒变 AI 助手 — OpenClaw IM Manager 开源实战

---

⚠️ 免责声明（必读）

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

🚫 严禁商用

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

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

⚠️ 使用风险

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

🔒 项目性质

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

📋 知识产权

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

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

---

Docker 一键部署，QQ + 微信双通道 AI 对话 + 可视化管理后台，扫码即用。

前言

想让自己的 QQ 号和微信号变成 AI 助手，随时随地帮你回复消息？本文介绍一个开源项目 OpenClaw IM Manager，基于 Docker Compose 编排，内嵌 NapCat（QQ 协议）+ wechatbot-webhook（微信 Web 协议）+ 管理后台，实现 QQ/微信个人号的 AI 对话、群管理、消息审核等功能。

GitHub 地址： https://github.com/zhaoxinyi02/openclaw-im-manager

效果展示

仪表盘 — QQ + 微信双通道实时状态

仪表盘一目了然地展示 QQ 和微信的连接状态、群/好友数量、AI 模型、运行时间，以及来自两个通道的实时事件流。

QQ Bot 管理

群列表、好友列表一览无余，还能直接在后台发送消息。

QQ 登录 & 微信登录

QQ 登录	微信登录

QQ 支持扫码、快速登录、账密登录三种方式；微信通过 wechatbot-webhook 扫码登录。

审核中心 & 设置

审核中心	设置

好友/入群请求一键审核；防撤回、戳一戳、入群欢迎等功能开关可视化配置。

架构设计

整个系统由两个 Docker 容器组成：

1. openclaw-qq：主容器，内含 NapCat（QQ 协议）、管理后台后端（Express + TypeScript）、前端（React + TailwindCSS）
2. openclaw-wechat：微信容器，运行 wechatbot-webhook，通过 HTTP 回调将微信消息转发给主容器

两个容器通过 Docker 内部网络通信，微信消息通过 RECVD_MSG_API 回调到主容器的 /api/wechat/callback 接口。

技术栈

层级	技术
QQ 协议	NapCat (OneBot11 WebSocket)
微信协议	wechatbot-webhook (Web 微信)
后端	TypeScript + Express + WebSocket
前端	React + Vite + TailwindCSS
AI 引擎	OpenClaw (支持 GPT-4o、Claude 等任意模型)
部署	Docker Compose
平台	Linux / macOS / Windows

快速部署

1. 安装前提

# 安装 Docker
curl -fsSL https://get.docker.com | sh

# 安装 OpenClaw
curl -fsSL https://get.openclaw.ai | bash
openclaw onboard
openclaw gateway start

2. 克隆并配置

git clone https://github.com/zhaoxinyi02/openclaw-im-manager.git
cd openclaw-im-manager
cp .env.example .env

编辑 .env 文件：

ADMIN_TOKEN=你的管理密码
QQ_ACCOUNT=你的QQ号
OWNER_QQ=主人QQ号
WECHAT_TOKEN=openclaw-wechat

3. 启动

docker compose up -d

4. 配置 OpenClaw 频道

chmod +x setup-openclaw.sh && ./setup-openclaw.sh

5. 登录使用

1. 浏览器访问 http://服务器IP:6199
2. 输入 ADMIN_TOKEN 登录
3. 左侧「QQ 登录」→ 手机 QQ 扫码
4. 左侧「微信登录」→ 手机微信扫码
5. 用另一个号给 Bot 发消息，收到 AI 回复即成功！

核心功能详解

双通道 AI 对话

QQ 和微信消息统一接入 OpenClaw AI 引擎，支持：

• QQ 私聊/群聊（发消息或 @机器人）
• 微信私聊自动回复
• 可配置任意 AI 模型（GPT-4o、Claude、Gemini 等）

QQ 增强功能

• 防撤回：消息撤回时通知主人原始内容
• 戳一戳回复：被戳时随机回复，回复列表可自定义
• 入群欢迎：新成员入群自动发送欢迎消息，支持 {nickname} 模板
• 自动审核：好友/入群申请按正则规则自动通过

管理后台

7 个功能页面，全部可视化操作：

页面	功能
仪表盘	QQ + 微信双通道状态、实时事件流
OpenClaw	在线编辑 AI 模型、频道、插件配置
QQ Bot	群列表、好友列表、在线发消息
QQ 登录	扫码/快速/账密三种登录方式
微信登录	扫码登录 + 发送测试消息
审核中心	好友/入群请求一键同意/拒绝
设置	所有功能开关可视化配置

跨平台支持

平台	启动命令	配置脚本
Linux	docker compose up -d	./setup-openclaw.sh
macOS	docker compose up -d	./setup-openclaw.sh
Windows	docker compose up -d	powershell -File setup-openclaw.ps1

微信容器 Token 注入方案

在开发过程中遇到一个坑：wechatbot-webhook 容器内部有 preStart.js 脚本，会读取内部 .env 文件中的 LOCAL_LOGIN_API_TOKEN，而不是 Docker 环境变量。

解决方案是在 docker-compose.yml 中覆盖 entrypoint，在启动前将 Token 写入内部 .env：

wechat:
  image: dannicool/docker-wechatbot-webhook
  entrypoint: /bin/sh
  command:
    - -c
    - |
      WTOKEN=$${LOGIN_API_TOKEN:-openclaw-wechat}
      if [ -f .env ]; then
        sed -i "s|^LOCAL_LOGIN_API_TOKEN=.*|LOCAL_LOGIN_API_TOKEN=$$WTOKEN|" .env
        grep -q "^LOCAL_LOGIN_API_TOKEN" .env || echo "LOCAL_LOGIN_API_TOKEN=$$WTOKEN" >> .env
      fi
      exec npm start

这样就能确保容器使用我们指定的 Token，而不是自动生成的随机值。

常见问题

Q: QQ 扫码后提示登录失败？
A: 确保 QQ 账号没有开启设备锁，或尝试使用快速登录。

Q: 微信提示不支持网页版登录？
A: 部分微信账号未开通网页版权限，需要使用较早注册的微信号。

Q: OpenClaw 连接不上？
A: 运行 ./setup-openclaw.sh 重新配置，然后 systemctl restart openclaw 重启。

Q: 如何查看日志？
A: docker compose logs -f 查看全部日志，docker compose logs -f wechat 只看微信。

总结

OpenClaw IM Manager 实现了 QQ + 微信双通道 AI 助手的一键部署，核心亮点：

• 双通道：QQ 和微信同时接入，统一管理
• 一键部署：Docker Compose 启动，无需手动配置协议
• 可视化：7 页管理后台，所有操作都能在浏览器完成
• 跨平台：Linux / macOS / Windows 均可运行
• 可扩展：基于 OpenClaw 生态，支持任意 AI 模型

欢迎 Star ⭐ 和 Fork！

GitHub： https://github.com/zhaoxinyi02/openclaw-im-manager