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

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:
本项目仅供学习交流使用,严禁用于商业用途
使用本项目所产生的一切法律责任和风险,由使用者自行承担,与项目作者无关。
请遵守相关法律法规,合法合规使用本项目。
-
机器人管理后台
-
机器人客户端和服务端
-
公共服务
-
公众号认证服务: 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 新增支持通过登录密钥登录管理后台,默认设置:通过登录密钥登录
-
访问 http://127.0.0.1:8090 微信服务器
-
配置 微信服务器
如何配置,前往 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.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设置 |
|
系统设置 |
|
容器日志 |
|
系统概览 |
|
发布朋友圈 |
|
聊天记录 |
|
群成员 |
|
群操作 |
|
For Tasks:
Click tags to check more tools for each tasksFor Jobs:
Alternative AI tools for wechat-robot-client
Similar Open Source Tools

wechat-robot-client
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.

ZcChat
ZcChat is an AI desktop pet suitable for Galgame characters, featuring long-term memory, expressive actions, control over the computer, and voice functions. It utilizes Letta for AI long-term memory, Galgame-style character illustrations for more actions and expressions, and voice interaction with support for various voice synthesis tools like Vits. Users can configure characters, install Letta, set up voice synthesis and input, and control the pet to interact with the computer. The tool enhances visual and auditory experiences for users interested in AI desktop pets.

AivisSpeech
AivisSpeech is a Japanese text-to-speech software based on the VOICEVOX editor UI. It incorporates the AivisSpeech Engine for generating emotionally rich voices easily. It supports AIVMX format voice synthesis model files and specific model architectures like Style-Bert-VITS2. Users can download AivisSpeech and AivisSpeech Engine for Windows and macOS PCs, with minimum memory requirements specified. The development follows the latest version of VOICEVOX, focusing on minimal modifications, rebranding only where necessary, and avoiding refactoring. The project does not update documentation, maintain test code, or refactor unused features to prevent conflicts with VOICEVOX.

langchain4j-aideepin-web
The langchain4j-aideepin-web repository is the frontend project of langchain4j-aideepin, an open-source, offline deployable retrieval enhancement generation (RAG) project based on large language models such as ChatGPT and application frameworks such as Langchain4j. It includes features like registration & login, multi-sessions (multi-roles), image generation (text-to-image, image editing, image-to-image), suggestions, quota control, knowledge base (RAG) based on large models, model switching, and search engine switching.

ezwork-ai-doc-translation
EZ-Work AI Document Translation is an AI document translation assistant accessible to everyone. It enables quick and cost-effective utilization of major language model APIs like OpenAI to translate documents in formats such as txt, word, csv, excel, pdf, and ppt. The tool supports AI translation for various document types, including pdf scanning, compatibility with OpenAI format endpoints via intermediary API, batch operations, multi-threading, and Docker deployment.

XYBotV2
XYBot V2 is a feature-rich WeChat robot framework that supports various interactive functions and gameplays. It provides AI chat, daily news updates, song requests, weather queries, and gaming functionalities like Gomoku and Warthunder player lookup. The tool is open-source and intended for learning and research purposes only, not for commercial or illegal activities. Users must comply with relevant laws and respect WeChat's copyrights and privacy. The tool's functionalities can be extended through a plugin system, allowing for dynamic loading/unloading of plugins.

chatgpt-webui
ChatGPT WebUI is a user-friendly web graphical interface for various LLMs like ChatGPT, providing simplified features such as core ChatGPT conversation and document retrieval dialogues. It has been optimized for better RAG retrieval accuracy and supports various search engines. Users can deploy local language models easily and interact with different LLMs like GPT-4, Azure OpenAI, and more. The tool offers powerful functionalities like GPT4 API configuration, system prompt setup for role-playing, and basic conversation features. It also provides a history of conversations, customization options, and a seamless user experience with themes, dark mode, and PWA installation support.

HiveChat
HiveChat is an AI chat application designed for small and medium teams. It supports various models such as DeepSeek, Open AI, Claude, and Gemini. The tool allows easy configuration by one administrator for the entire team to use different AI models. It supports features like email or Feishu login, LaTeX and Markdown rendering, DeepSeek mind map display, image understanding, AI agents, cloud data storage, and integration with multiple large model service providers. Users can engage in conversations by logging in, while administrators can configure AI service providers, manage users, and control account registration. The technology stack includes Next.js, Tailwindcss, Auth.js, PostgreSQL, Drizzle ORM, and Ant Design.

Long-Novel-GPT
Long-Novel-GPT is a long novel generator based on large language models like GPT. It utilizes a hierarchical outline/chapter/text structure to maintain the coherence of long novels. It optimizes API calls cost through context management and continuously improves based on self or user feedback until reaching the set goal. The tool aims to continuously refine and build novel content based on user-provided initial ideas, ultimately generating long novels at the level of human writers.

llm-jp-eval
LLM-jp-eval is a tool designed to automatically evaluate Japanese large language models across multiple datasets. It provides functionalities such as converting existing Japanese evaluation data to text generation task evaluation datasets, executing evaluations of large language models across multiple datasets, and generating instruction data (jaster) in the format of evaluation data prompts. Users can manage the evaluation settings through a config file and use Hydra to load them. The tool supports saving evaluation results and logs using wandb. Users can add new evaluation datasets by following specific steps and guidelines provided in the tool's documentation. It is important to note that using jaster for instruction tuning can lead to artificially high evaluation scores, so caution is advised when interpreting the results.

wealth-tracker
Wealth Tracker is a personal finance management tool designed to help users track their income, expenses, and investments in one place. With intuitive features and customizable categories, users can easily monitor their financial health and make informed decisions. The tool provides detailed reports and visualizations to analyze spending patterns and set financial goals. Whether you are budgeting, saving for a big purchase, or planning for retirement, Wealth Tracker offers a comprehensive solution to manage your money effectively.

AivisSpeech-Engine
AivisSpeech-Engine is a powerful open-source tool for speech recognition and synthesis. It provides state-of-the-art algorithms for converting speech to text and text to speech. The tool is designed to be user-friendly and customizable, allowing developers to easily integrate speech capabilities into their applications. With AivisSpeech-Engine, users can transcribe audio recordings, create voice-controlled interfaces, and generate natural-sounding speech output. Whether you are building a virtual assistant, developing a speech-to-text application, or experimenting with voice technology, AivisSpeech-Engine offers a comprehensive solution for all your speech processing needs.

new-api
New API is an open-source project based on One API with additional features and improvements. It offers a new UI interface, supports Midjourney-Proxy(Plus) interface, online recharge functionality, model-based charging, channel weight randomization, data dashboard, token-controlled models, Telegram authorization login, Suno API support, Rerank model integration, and various third-party models. Users can customize models, retry channels, and configure caching settings. The deployment can be done using Docker with SQLite or MySQL databases. The project provides documentation for Midjourney and Suno interfaces, and it is suitable for AI enthusiasts and developers looking to enhance AI capabilities.

new-api
New API is a next-generation large model gateway and AI asset management system that provides a wide range of features, including a new UI interface, multi-language support, online recharge function, key query for usage quota, compatibility with the original One API database, model charging by usage count, channel weighted randomization, data dashboard, token grouping and model restrictions, support for various authorization login methods, support for Rerank models, OpenAI Realtime API, Claude Messages format, reasoning effort setting, content reasoning, user-specific model rate limiting, request format conversion, cache billing support, and various model support such as gpts, Midjourney-Proxy, Suno API, custom channels, Rerank models, Claude Messages format, Dify, and more.

meet-libai
The 'meet-libai' project aims to promote and popularize the cultural heritage of the Chinese poet Li Bai by constructing a knowledge graph of Li Bai and training a professional AI intelligent body using large models. The project includes features such as data preprocessing, knowledge graph construction, question-answering system development, and visualization exploration of the graph structure. It also provides code implementations for large models and RAG retrieval enhancement.
For similar tasks

chatgpt-exporter
A script to export the chat history of ChatGPT. Supports exporting to text, HTML, Markdown, PNG, and JSON formats. Also allows for exporting multiple conversations at once.

WeChatMsg
WeChatMsg is a tool designed to help users manage and analyze their WeChat data. It aims to provide users with the ability to preserve their precious memories and create a personalized AI companion. The tool allows users to extract and export various types of data from WeChat, such as text, images, contacts, and more. Additionally, it offers features like analyzing chat data and generating visual annual reports. WeChatMsg is built on the idea of empowering users to take control of their data and foster emotional connections through technology.

wechat-robot-client
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.

QFurina
QFurina is a powerful and easily extensible Python QQ robot backend service that provides a range of automation and interactive features. It supports multiple messaging platforms and has a robust plugin system, allowing users to easily expand and customize functionality.

botgroup.chat
botgroup.chat is a multi-person AI chat application based on React and Cloudflare Pages for free one-click deployment. It supports multiple AI roles participating in conversations simultaneously, providing an interactive experience similar to group chat. The application features real-time streaming responses, customizable AI roles and personalities, group management functionality, AI role mute function, Markdown format support, mathematical formula display with KaTeX, aesthetically pleasing UI design, and responsive design for mobile devices.

uAgents
uAgents is a Python library developed by Fetch.ai that allows for the creation of autonomous AI agents. These agents can perform various tasks on a schedule or take action on various events. uAgents are easy to create and manage, and they are connected to a fast-growing network of other uAgents. They are also secure, with cryptographically secured messages and wallets.

venom
Venom is a high-performance system developed with JavaScript to create a bot for WhatsApp, support for creating any interaction, such as customer service, media sending, sentence recognition based on artificial intelligence and all types of design architecture for WhatsApp.

Whatsapp-Ai-BOT
This WhatsApp AI chatbot is built using NodeJS technology and powered by OpenAI. It leverages the advanced deep learning models of ChatGPT, Playground, and DALL·E from OpenAI to provide a unique text-based and image-based conversational experience for users. The bot has two main features: ChatGPT (text) and DALL-E (Text To Image). To use these features, simply use the commands /ai, /img, and /sc respectively. The bot's code is encrypted to protect it from prying eyes, but the key to unlock the full potential of this amazing creation can be obtained by contacting the developer. The bot is free to use, but a PRIME version is available with additional features such as history mode, prime support, and customizable options.
For similar jobs

sweep
Sweep is an AI junior developer that turns bugs and feature requests into code changes. It automatically handles developer experience improvements like adding type hints and improving test coverage.

teams-ai
The Teams AI Library is a software development kit (SDK) that helps developers create bots that can interact with Teams and Microsoft 365 applications. It is built on top of the Bot Framework SDK and simplifies the process of developing bots that interact with Teams' artificial intelligence capabilities. The SDK is available for JavaScript/TypeScript, .NET, and Python.

ai-guide
This guide is dedicated to Large Language Models (LLMs) that you can run on your home computer. It assumes your PC is a lower-end, non-gaming setup.

classifai
Supercharge WordPress Content Workflows and Engagement with Artificial Intelligence. Tap into leading cloud-based services like OpenAI, Microsoft Azure AI, Google Gemini and IBM Watson to augment your WordPress-powered websites. Publish content faster while improving SEO performance and increasing audience engagement. ClassifAI integrates Artificial Intelligence and Machine Learning technologies to lighten your workload and eliminate tedious tasks, giving you more time to create original content that matters.

chatbot-ui
Chatbot UI is an open-source AI chat app that allows users to create and deploy their own AI chatbots. It is easy to use and can be customized to fit any need. Chatbot UI is perfect for businesses, developers, and anyone who wants to create a chatbot.

BricksLLM
BricksLLM is a cloud native AI gateway written in Go. Currently, it provides native support for OpenAI, Anthropic, Azure OpenAI and vLLM. BricksLLM aims to provide enterprise level infrastructure that can power any LLM production use cases. Here are some use cases for BricksLLM: * Set LLM usage limits for users on different pricing tiers * Track LLM usage on a per user and per organization basis * Block or redact requests containing PIIs * Improve LLM reliability with failovers, retries and caching * Distribute API keys with rate limits and cost limits for internal development/production use cases * Distribute API keys with rate limits and cost limits for students

uAgents
uAgents is a Python library developed by Fetch.ai that allows for the creation of autonomous AI agents. These agents can perform various tasks on a schedule or take action on various events. uAgents are easy to create and manage, and they are connected to a fast-growing network of other uAgents. They are also secure, with cryptographically secured messages and wallets.

griptape
Griptape is a modular Python framework for building AI-powered applications that securely connect to your enterprise data and APIs. It offers developers the ability to maintain control and flexibility at every step. Griptape's core components include Structures (Agents, Pipelines, and Workflows), Tasks, Tools, Memory (Conversation Memory, Task Memory, and Meta Memory), Drivers (Prompt and Embedding Drivers, Vector Store Drivers, Image Generation Drivers, Image Query Drivers, SQL Drivers, Web Scraper Drivers, and Conversation Memory Drivers), Engines (Query Engines, Extraction Engines, Summary Engines, Image Generation Engines, and Image Query Engines), and additional components (Rulesets, Loaders, Artifacts, Chunkers, and Tokenizers). Griptape enables developers to create AI-powered applications with ease and efficiency.