本项目仅供学习交流使用，严禁用于商业用途
使用本项目所产生的一切法律责任和风险，由使用者自行承担，与项目作者无关。
请遵守相关法律法规，合法合规使用本项目。
官方交流群已经满 200 人，添加好友(备注: WeChat-Robot)加入官方交流群，基于风控考虑没开启自动通过好友，晚上统一处理。
| 官方交流群 | 微信赞赏码 |
|---|---|
|
|
-
机器人管理后台
-
机器人客户端和服务端
-
公共服务
-
公众号认证服务: https://github.com/hp0912/wechat-server fork的项目，微信公众号的后端，为管理后台(以及其他系统)提供微信登录验证功能
-
词云服务: https://github.com/hp0912/word-cloud-server golang写的词云效果不太好，用python写了一个单独的服务
-
即梦绘图: https://github.com/hp0912/jimeng-api 即梦AI绘图逆向免费 api
-
MCP 服务: https://github.com/hp0912/wechat-robot-mcp-server 官方内置 MCP 服务
-
UUID生成器: registry.cn-shenzhen.aliyuncs.com/houhou/wechat-uuid:latest
-
Mac 扫码登录自动过滑块: registry.cn-shenzhen.aliyuncs.com/houhou/wechat-slider:latest
-
机器人服务端采用iPad协议，可以去马老板开的动物园淘一淘
本项目是一个智能机器人管理系统，提供了丰富的交互体验。
-
AI聊天，chat-gtp deepseek qwen 系列等等
-
AI绘图，豆包文生图，智谱文生图，即梦文生图，图生图，文生视频、图生视频
-
AI语音，文本转语音，长文本转语音
-
群聊欢迎新成员，支持文本、图片、表情包、链接形式
-
点歌
-
群聊退群提醒
-
拍一拍交互
-
群聊每日、每周、每月活跃排行榜，每日群聊词云
-
抖音短链接视频解析
-
群聊每日总结
-
群聊每日早报
-
收藏夹 (待开发)
-
查看朋友圈，查看指定人的朋友圈，自动评论、点赞
-
手动添加好友(搜索添加、从群聊添加)
-
手动通过好友验证，自动通过好友验证
-
手动同意进入群聊，自动拉人进入群聊
-
手动发起群聊
-
授权登录APP(王者荣耀、吃鸡等等)
-
配合【推送加】，支持掉线通知，推送到指定微信
-
支持发送文件消息
-
支持多种登录方式(iPad、Windows微信、车载微信、Mac微信)
-
支持Data62登录
-
支持A16登录
-
Mac 扫码登录支持自动过滑块。
-
完整的 MCP 协议支持
自部署
自部署前的准备
你得有自己的公众号，用来集成公众号扫码登录，本项目只集成了公众号扫码登录2025/08/29 新增支持通过登录密钥登录管理后台 (默认密钥： 12345678)
自己会安装 docker 和 docker-compose
直接使用现成系统
访问 https://wechat-sz.houhoukang.com/ 使用微信扫码登录管理后台，进入后台后创建微信机器人实例。使用微信扫码登录机器人（iPad）。
风险提示：本机器人服务器在广东，非广东地区的慎重使用，微信异地登陆有概率被风控。
# 克隆本项目
git clone git@github.com:hp0912/wechat-robot-client.git
# 进入部署目录
cd ./wechat-robot-client/.deploy/local
# 先创建一个docker网络，如果以前没创建过的话
docker network create wechat-robot
# 通过docker-compose启动容器，下面两个命令，哪个能用就用哪个
docker compose up -d
docker-compose up -d
# 可选进阶方案，使用 docker secrets 存储密钥，看不懂配置的可以不管这部份
docker compose -f docker-compose2.yml up -d
docker-compose -f docker-compose2.yml up -d# 如果在升级版本过程中出现问题，可以执行下面的命令重置，会丢失历史数据
# 如果严格走升级流程是不会出现问题的，也用不到暴力重置
# windows系统上请在Git Bash上面(或者 WSL 终端)执行下面的命令
./reset.sh
# windows 系统备用方案
./reset.bat
非必须，2025/08/29 新增支持通过登录密钥登录管理后台，默认设置：通过登录密钥登录
-
配置 微信服务器
如何配置，前往 https://github.com/hp0912/wechat-server 查看详细教程。
在微信服务器
设置个人设置生成访问令牌生成的令牌，填入docker-compose.yml的WECHAT_SERVER_TOKEN的环境变量中，将你自己的公众号二维码链接填入WECHAT_OFFICIAL_ACCOUNT_AUTH_URL环境变量中。
- 重启服务
docker compose up -d
docker-compose up -d
-
访问 http://127.0.0.1:8080 机器人管理后台
-
使用个人微信扫码登录 / 输入登录密钥登录 (默认密钥： 12345678)
-
新建机器人
部署在远程服务器
自部署前的准备 (跟本地部署一样，只不过服务器安装docker有点门槛)
你得有自己的公众号，用来集成公众号扫码登录，本项目只集成了公众号扫码登录2025/08/29 新增支持通过登录密钥登录管理后台
服务器安装 docker 和 docker-compose
服务器安装 nginx
域名解析，将你的自定义域名解析到你自己的服务器(有公网IP)
# 克隆本项目
git clone git@github.com:hp0912/wechat-robot-client.git
# 先创建一个docker网络，如果以前没创建过的话
docker network create wechat-robot
# 进入部署目录
cd ./wechat-robot-client/.deploy/server
# 通过docker-compose启动容器，下面两个命令，哪个能用就用哪个
docker compose up -d
docker-compose up -d修改nginx配置
.deploy/server/nginx.conf这个文件配置了服务转发规则，wechat-server.xxx.com(改成你自己的域名) 域名转发到3000端口，也就是docker-compose.yml里面的wechat-server服务。
wechat-robot.xxx.com(改成你自己的域名) 域名，api/v1开头的路由转发到3002端口，也就是docker-compose.yml里面的wechat-robot-admin-backend服务，剩下路由转发到3001端口，也就是docker-compose.yml里面的wechat-robot-admin-fontend服务将这个文件覆盖服务器上的
/etc/nginx/sites-available/default
重启nginx服务
sudo service nginx restart
使用 Let's Encrypt 的 certbot 配置 HTTPS
需要先配置好域名解析
# Ubuntu 安装 certbot：
sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/bin/certbot
# 生成证书 & 修改 Nginx 配置
sudo certbot --nginx
# 根据指示进行操作
# 重启 Nginx
sudo service nginx restart
配置微信服务器，获取WECHAT_SERVER_TOKEN参考本地部署
其他，参考本地部署
# 关注本项目 Release，如果有数据库升级脚本，先执行数据库升级脚本
# 管理后台前端、管理后台后端服务 手动拉取 docker 镜像
docker pull registry.cn-shenzhen.aliyuncs.com/houhou/wechat-robot-admin-frontend:latest
docker pull registry.cn-shenzhen.aliyuncs.com/houhou/wechat-robot-admin-backend:latest
# 通过 docker-compose 重建容器，下面两个命令，哪个能用就用哪个
docker compose up -d
docker-compose up -d
# 机器人客户端、机器人服务端，没有通过 docker-compose 管理，是通过管理后台自动创建的
# 请在机器人详情界面，右上角`更新镜像`按钮，先点击更新镜像，然后再依次点击`删除客户端容器` `删除服务端容器` `创建服务端容器` `创建客户端容器`，该系列操作不会对机器人登录态造成影响
# 开发前准备，确保自己的Nodejs版本在18以及以上，pnpm版本需要限定在8.x，pnpm版本太高，pnpm-lock.yaml 文件会不兼容
# Node.js 16.10 及以上自带了 corepack，它可以帮助你管理和切换 pnpm（以及 yarn）的版本
# 启用 corepack（如果还没启用）
corepack enable
corepack prepare [email protected] --activate
pnpm -v
# clone 前端项目
git clone [email protected]:hp0912/wechat-robot-admin-frontend.git
# 进入项目目录
cd wechat-robot-admin-frontend
# 安装依赖
pnpm install
# 生成类型文件
pnpm run build-types
# 启动项目
pnpm run dev# clone 机器人管理后台后端项目
git clone [email protected]:hp0912/wechat-robot-admin-backend.git
# 进入项目目录
cd wechat-robot-admin-backend
# 下载依赖，翻墙的话会快一点 -> export https_proxy=http://127.0.0.1:7897 http_proxy=http://127.0.0.1:7897 all_proxy=socks5://127.0.0.1:7897
go mod download
# 指定开发模式，这里是mac，win设置环境变量的方式自行探索
export GO_ENV=dev
# 将根目录下的 .env.example 文件复制一份，复制后的文件的文件名改为 .env，按注释说明修改环境变量
# 启动项目
go run main.go# clone 机器人管理后台后端项目
git clone [email protected]:hp0912/wechat-robot-client.git
# 进入项目目录
cd wechat-robot-client
# 下载依赖，翻墙的话会快一点 -> export https_proxy=http://127.0.0.1:7897 http_proxy=http://127.0.0.1:7897 all_proxy=socks5://127.0.0.1:7897
go mod download
# 指定开发模式，这里是mac，win设置环境变量的方式自行探索
export GO_ENV=dev
# 将根目录下的 .env.example 文件复制一份，复制后的文件的文件名改为 .env，按注释说明修改环境变量
# 启动项目
go run main.goservices:
ipad-test:
image: registry.cn-shenzhen.aliyuncs.com/houhou/wechat-ipad:latest
container_name: ipad-test
restart: always
networks:
- wechat-robot
ports:
- '3010:9000'
environment:
WECHAT_PORT: 9000
REDIS_HOST: wechat-admin-redis
REDIS_PORT: 6379
REDIS_PASSWORD: 123456
REDIS_DB: 0
WECHAT_CLIENT_HOST: 127.0.0.1:9001# 机器人服务端，也就是iPad协议，不提供源码，可以通过docker镜像启动，上面是一个 docker-compose.yml 示例
# 向宿主机暴露3010端口，和机器人客户端的 WECHAT_SERVER_HOST 环境变量是相对应的
# WECHAT_CLIENT_HOST REDIS_DB 和机器人客户端环境变量相对应
# redis db 地址、密码别写错了| 功能 | 效果图 |
|---|---|
| 机器人列表 |
|
| 机器人详情 |
|
| 全局AI设置 |
|
| 完整的 MCP 协议支持 |
|
| 系统设置 |
|
| 容器日志 |
|
| 系统概览 |
|
| 发布朋友圈 |
|
| 聊天记录 |
|
| 群成员 |
|
| 群操作 |
|