公告

XYBotV1已停止更新，请前往XYBotV2 https://github.com/HenryXiaoYang/XYBotV2

XYBot 微信机器人

XYBot是一个可运行于Linux和Windows的基于Hook的微信机器人。😊 具有高度可自定义性，支持自我编写插件。🚀

XYBot提供了多种功能，包括获取天气🌤️、获取新闻📰、Hypixel玩家查询🎮、战争雷霆玩家查询🎮、随机图片📷、随机链接🔗、五子棋♟️、签到✅、查询积分📊、积分榜🏆、积分转送💰、积分抽奖🎁、积分红包🧧等。🎉

XYBot还提供了AI相关的功能，包括ChatGPT🗣️，Dalle🎨。🤖

XYBot拥有独立的经济系统，其中基础货币称为”积分“。💰

XYBot还提供了管理员功能，包括修改积分💰、修改白名单📝、重置签到状态🔄、获取机器人通讯录📚、热加载/卸载/重载插件🔄等。🔒

XYBot详细的部署教程可以在项目的Wiki中找到。📚 同时，XYBot还支持自我编写插件，用户可以根据自己的需求和创造力编写自定义插件，进一步扩展机器人的功能。💡

✅高度可自定义！ ✅支持自我编写插件！

公告

由于需要频繁的更新维护，XYBot版本号格式将会发生变化，v0.0.7后面的版本号将会按照以下格式进行更新：

v大版本(hook/微信版本变动时更改).功能版本.Bug修复版本

例如：

• v1.0.1是v1.0.0的Bug修复版本
• v1.1.0是v1.0.0的功能版本
• v1.1.1是v1.1.0的Bug修复版本

功能列表

用户功能:

• 获取天气🌤️
• 获取新闻📰
• ChatGPT🗣️
• Dalle🎨
• Hypixel玩家查询🎮
• 战争雷霆玩家信息查询💣
• 随机图图📷
• 随机链接🔗
• 五子棋♟️
• 签到✅
• 查询积分📊
• 积分榜🏆
• 积分转送💰
• 积分抽奖🎁
• 积分红包🧧

管理员功能:

• 修改积分💰
• 修改白名单📝
• 重置签到状态🔄
• 获取机器人通讯录📚
• 热加载/卸载/重载插件🔄
• 查看已加载插件ℹ️

XYBot 文档 📄

文档中有完整的功能介绍，部署教程，配置教程，插件编写教程。

🔗XYBot 文档

功能演示

菜单

随机图片

ChatGPT

私聊ChatGPT

天气查询

五子棋

快速开始🚀

Linux/Docker

docker pull henryxiaoyang/xybot:latest

docker run -d --name XYBot \
  -e WC_AUTO_RESTART=yes \
  -p 4000:8080 \
  --add-host dldir1.qq.com:127.0.0.1 \
  -v XYBot:/home/app/XYBot/ \
  -v XYBot-wechatfiles:/home/app/WeChat\ Files/ \
  --tty \
  henryxiaoyang/xybot:latest

Windows

需要 Git 与 Python3 与 微信3.9.10.27

git clone https://github.com/HenryXiaoYang/XYBot.git
cd XYBot
pip install -r requirements.txt

# 请手动启动微信

# 启动微信后执行
python start.py

自我编写插件🧑‍💻

请参考模板插件：

🔗模板插件仓库️

XYBot交流群

🔗图片会被缓存，点我查看最新二维码

捐赠

你的赞助是我创作的动力！🙏

FAQ❓❓❓

ARM架构能不能运行?🤔️

不行

用的什么微信版本?🤔️

3.9.10.27😄

最长能运行多久？🤔️

XYBot内置了防微信自动退出登录功能，可以保持长时间运行。

特别感谢

https://github.com/ChisBread 感谢提供了Docker容器相关的信息！

https://github.com/lich0821 感谢这个项目的作者写的wcferry！

⭐️Star History⭐️

XYBot 微信机器人快速上手指南

XYBot 是一个基于 Hook 技术的高度可自定义微信机器人，支持 Linux 和 Windows 平台。它内置了丰富的功能（如 ChatGPT、Dalle、天气查询、游戏对战等）以及独立的经济系统，并支持用户自行编写插件。

注意：XYBot V1 已停止更新，本指南基于最新稳定版本编写。如需使用新版架构，请前往 XYBotV2。

环境准备

在开始之前，请确保满足以下系统要求和前置依赖：

系统要求

• 操作系统：Linux (推荐 Docker 部署) 或 Windows
• 架构限制：仅支持 x86_64 架构，不支持 ARM 架构。
• 微信版本：必须安装 微信 PC 版 3.9.10.27 (其他版本可能导致无法运行)。

前置依赖

方案 A：Linux (Docker)

• 已安装 Docker 和 Docker Compose。
• 无需手动安装 Python 或微信客户端，容器内已集成。

方案 B：Windows (原生部署)

• Git：用于克隆代码仓库。
• Python 3：推荐版本 3.12.7 (下载地址)。
• 微信 PC 版：必须手动下载并安装特定版本 WeChatSetup-3.9.10.27.exe。

---

安装步骤

根据你的操作系统选择以下任一方式进行安装。

方式一：Linux / Docker (推荐)

使用 Docker 一键部署，自动处理依赖和环境配置。

1. 拉取最新镜像：

   docker pull henryxiaoyang/xybot:latest
   

2. 启动容器：

   docker run -d --name XYBot \
     -e WC_AUTO_RESTART=yes \
     -p 4000:8080 \
     --add-host dldir1.qq.com:127.0.0.1 \
     -v XYBot:/home/app/XYBot/ \
     -v XYBot-wechatfiles:/home/app/WeChat\ Files/ \
     --tty \
     henryxiaoyang/xybot:latest
   

   说明：该命令将映射数据卷以保存聊天记录和配置，并开启微信自动重启功能。

方式二：Windows 原生部署

1. 克隆项目代码：

   git clone https://github.com/HenryXiaoYang/XYBot.git
   cd XYBot
   

2. 安装 Python 依赖：

   pip install -r requirements.txt
   

   (国内用户若下载缓慢，可添加 -i https://pypi.tuna.tsinghua.edu.cn/simple 使用清华源)

3. 手动启动微信：

   • 打开已安装的 微信 3.9.10.27。
   • 扫码登录账号。
   • 保持微信窗口在前台运行，不要关闭。

4. 启动机器人： 在登录后的微信状态下，回到命令行执行：

   python start.py
   

---

基本使用

启动成功后，机器人将自动监听微信消息。你可以通过私聊或群聊与机器人互动。

1. 查看功能菜单

在微信中向机器人发送以下指令（或直接发送帮助关键词，视具体配置而定），即可查看可用功能列表：

菜单

预期回复：包含天气、新闻、AI 对话、游戏、积分系统等功能的列表。

2. 体验 AI 对话 (ChatGPT)

确保已在配置文件中填入有效的 API Key，然后在微信中直接发送问题：

你好，请介绍一下你自己

预期回复：机器人将调用 ChatGPT 接口返回回答。

3. 查询天气

发送城市名称即可获取实时天气：

北京天气

预期回复：包含温度、天气状况等信息的卡片或文本。

4. 管理员操作 (可选)

如果你是管理员，可以进行插件热加载或积分管理：

重载插件

注意：管理员权限需在配置文件中设置白名单。

---

下一步建议：

• 详细配置（如 API Key 设置、数据库连接）请参考 XYBot 官方文档。
• 想要扩展功能？参考 插件开发模板 编写你自己的插件。