本项目仅供学习交流使用，严禁用于商业用途

使用本项目所产生的一切法律责任和风险，由使用者自行承担，与项目作者无关。

请遵守相关法律法规，合法合规使用本项目。

• 机器人管理后台

  • 前端项目: https://github.com/hp0912/wechat-robot-admin-frontend

  • 后端项目: https://github.com/hp0912/wechat-robot-admin-backend

• 机器人客户端和服务端

  • 机器人客户端: 本项目

  • 机器人服务端 (源代码不公开) 接口文档

• 公共服务

  • 公众号认证服务: https://github.com/hp0912/wechat-server fork的项目，微信公众号的后端，为管理后台(以及其他系统)提供微信登录验证功能

  • 词云服务: https://github.com/hp0912/word-cloud-server golang写的词云效果不太好，用python写了一个单独的服务

机器人服务端采用iPad协议，可以去马老板开的动物园淘一淘

本项目是一个智能机器人管理系统，提供了丰富的交互体验。

• AI聊天，chat-gtp deepseek qwen 系列等等

• AI绘图，豆包文生图，智谱文生图，即梦文生图，豆包图像编辑

• AI语音，文本转语音，长文本转语音

• 群聊欢迎新成员，支持文本、图片、表情包、链接形式

• 点歌

• 群聊退群提醒

• 拍一拍交互

• 群聊每日、每周、每月活跃排行榜，每日群聊词云

• 抖音短链接视频解析

• 群聊每日总结

• 群聊每日早报

• 收藏夹 (待开发)

• 查看朋友圈，查看指定人的朋友圈，自动评论、点赞

• 手动添加好友(搜索添加、从群聊添加)

• 手动通过好友验证，自动通过好友验证

• 手动同意进入群聊，自动拉人进入群聊

• 手动发起群聊

• 授权登录APP(王者荣耀、吃鸡等等)

• 配合【推送加】，支持掉线通知，推送到指定微信

• 支持发送文件消息

• 支持多种登录方式(iPad、Windows微信、车载微信、Mac微信)

• 支持Data62登录

• 支持A16登录

自部署

自部署前的准备

• 你得有自己的公众号，用来集成公众号扫码登录，本项目只集成了公众号扫码登录

• 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 新增支持通过登录密钥登录管理后台，默认设置：通过登录密钥登录

1. 访问 http://127.0.0.1:8090 微信服务器

2. 配置 微信服务器

如何配置，前往 https://github.com/hp0912/wechat-server 查看详细教程。

在微信服务器 设置 个人设置 生成访问令牌生成的令牌，填入docker-compose.yml的WECHAT_SERVER_TOKEN的环境变量中，将你自己的公众号二维码链接填入WECHAT_OFFICIAL_ACCOUNT_AUTH_URL环境变量中。

3. 重启服务

docker compose up -d
docker-compose up -d

4. 访问 http://127.0.0.1:8080 机器人管理后台

5. 使用个人微信扫码登录 / 输入登录密钥登录 (默认密钥： 12345678)

6. 新建机器人

部署在远程服务器

自部署前的准备 (跟本地部署一样，只不过服务器安装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 pnpm@8.15.9 --activate

pnpm -v

# clone 前端项目
git clone git@github.com:hp0912/wechat-robot-admin-frontend.git

# 进入项目目录
cd wechat-robot-admin-frontend

# 安装依赖
pnpm install

# 生成类型文件
pnpm run build-types

# 启动项目
pnpm run dev

# clone 机器人管理后台后端项目
git clone git@github.com: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 git@github.com: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.go

services:
  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设置
系统设置
容器日志
系统概览
发布朋友圈
聊天记录
群成员
群操作

mainiu@MEmini-82AC:/vol1/wechat/wechat-robot-client/.deploy/local$

安装完成会在.deploy/local/certs目录下生成两个文件 cert.crt cert.key

• 正确做法（给 wechat-nginx 加 HTTPS）
  1. 生成证书（示例含 IP SAN，自签会有提示；更好用域名+mkcert/内网 CA）

openssl req -x509 -newkey rsa:2048 -nodes -keyout cert.key -out cert.crt -days 365 \
  -subj "/CN=robot.local" -addext "subjectAltName=DNS:robot.local,IP:192.168.1.8"

2. 挂载证书并开放 8443（容器内用 9443）到 wechat-nginx：

# docker-compose.yml (local)
wechat-nginx:
  ports:
    - "8080:9000"
    - "8443:9443"
  volumes:
    - ./nginx.conf:/etc/nginx/conf.d/default.conf
    - ./certs:/etc/nginx/certs:ro   # 新增：挂载证书

3. 在 nginx.conf 增加 HTTPS server：

server {
  listen 9443 ssl;
  listen [::]:9443 ssl;

  ssl_certificate     /etc/nginx/certs/cert.crt;
  ssl_certificate_key /etc/nginx/certs/cert.key;
}
```bash
chmod 644 certs/cert.crt
chmod 600 certs/cert.key