wechat-robot-client

wechat-robot-client

微信机器人,支持AI聊天、AI绘图、点歌、群聊排行榜、群聊总结、欢迎群聊新成员、退群监控等等有趣玩法

Stars: 54

Visit
 screenshot

The Wechat Robot Client is an intelligent robot management system that provides rich interactive experiences. It includes features such as AI chat, drawing, voice, group chat functionalities, song requests, daily summaries, friend circle viewing, friend adding, group chat management, file messaging, multiple login methods support, and more. The system also supports features like sending files, various login methods, and integration with other apps like '王者荣耀' and '吃鸡'. It offers a comprehensive solution for managing Wechat interactions and automating various tasks.

README:

机器人客户端

免责声明

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

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

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

项目依赖关系

机器人服务端采用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.ymlWECHAT_SERVER_TOKEN的环境变量中,将你自己的公众号二维码链接填入WECHAT_OFFICIAL_ACCOUNT_AUTH_URL环境变量中。

  1. 重启服务
docker compose up -d
docker-compose up -d
  1. 访问 http://127.0.0.1:8080 机器人管理后台

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

  3. 新建机器人

自部署进阶篇

部署在远程服务器

自部署前的准备 (跟本地部署一样,只不过服务器安装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.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设置 全局AI设置
系统设置 系统设置
容器日志 容器日志
系统概览 系统概览
发布朋友圈 发布朋友圈
聊天记录 聊天记录
群成员 群成员
群操作 群操作

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for wechat-robot-client

Similar Open Source Tools

For similar tasks

For similar jobs