WxBot Enhanced 快速开始指南¶
🚀 5分钟快速部署Enhanced版本微信机器人
🎯 适用人群¶
- ✅ 新手用户: 第一次接触微信机器人
- ✅ 快速体验: 想要快速体验Enhanced功能
- ✅ 生产部署: 需要稳定的生产环境部署
- ✅ 开发者: 插件开发和定制需求
📋 系统要求¶
最低要求¶
- 操作系统: Windows 10+ / macOS 10.15+ / Linux (Ubuntu 18.04+)
- 内存: 512MB RAM
- 磁盘: 100MB 可用空间
- 网络: 稳定的互联网连接
推荐配置¶
- 操作系统: Windows 11 / macOS 12+ / Linux (Ubuntu 20.04+)
- 内存: 1GB RAM
- 磁盘: 1GB 可用空间
- CPU: 2核心以上
依赖要求¶
- 微信Hook框架: StarBotPro (推荐) / Dean DLL / VLW
- Docker: Docker 20.10+ (Docker部署)
- Go: Go 1.21+ (源码编译)
🚀 快速部署方案¶
方案一:Windows一键部署 ⭐ 推荐新手¶
# 1. 下载Enhanced Windows版本
git clone https://github.com/ruk1ng001/wxbot.git
cd wxbot/wxbot-windows-enhanced
# 2. 配置机器人参数
notepad config.yaml # 编辑配置文件
# 3. 一键启动
start.bat
✅ 优势: 零依赖、开箱即用、自带监控界面
方案二:Docker部署 ⭐ 推荐生产¶
# 1. 一键启动脚本
bash -c "$(curl -fsSL https://raw.fastgit.org/Ruk1ng001/wxbot/hook/docker/run.sh)"
# 2. 访问监控界面
open http://localhost:7601/monitor.html
✅ 优势: 容器化、自动重启、健康检查、资源隔离
方案三:源码编译 ⭐ 推荐开发者¶
# 1. 克隆仓库
git clone https://github.com/ruk1ng001/wxbot.git
cd wxbot
# 2. 生成插件导入
make plugins
# 3. 编译运行
go run main.go
✅ 优势: 完全可定制、最新代码、开发友好
⚙️ 配置文件详解¶
config.yaml 核心配置¶
# 🤖 机器人基础信息
robot:
name: "我的Enhanced机器人"
avatar: ""
# 🔗 框架连接配置
framework:
name: "StarBotPro" # 推荐使用Enhanced优化版本
host: "http://localhost:8080" # 您的Hook框架地址
token: "your-access-token" # 框架访问令牌(如需要)
# 👑 超级管理员配置
superUsers:
- "your-wechat-id" # 替换为您的微信ID
# 🌐 服务器配置
server:
port: 7601 # Enhanced版本端口(含监控)
# 💬 命令前缀配置
commandPrefix: "/" # 管理命令前缀
# 📊 Enhanced特性配置
enhanced:
monitoring:
enabled: true # 启用实时监控
webDashboard: true # 启用Web仪表板
alerting: true # 启用告警系统
database:
path: "data/wxbot.db" # SQLite数据库路径
backup: true # 启用自动备份
logging:
level: "info" # 日志级别
file: "logs/wxbot.log" # 日志文件路径
plugins.yaml 插件配置¶
# 🎮 Enhanced游戏插件(推荐全部启用)
- "github.com/ruk1ng001/wxbot/plugins/caichengyu" # 猜成语Enhanced
- "github.com/ruk1ng001/wxbot/plugins/chengyujielong" # 成语接龙Enhanced
- "github.com/ruk1ng001/wxbot/plugins/music" # 音乐猜题Enhanced
- "github.com/ruk1ng001/wxbot/plugins/xiehouyu" # 歇后语Enhanced
- "github.com/ruk1ng001/wxbot/plugins/signin" # 签到系统Enhanced
# 🤖 AI智能插件
- "github.com/ruk1ng001/wxbot/plugins/chatgpt" # ChatGPT聊天
# 🔧 实用工具插件
- "github.com/ruk1ng001/wxbot/plugins/weather" # 天气查询
- "github.com/ruk1ng001/wxbot/plugins/zaobao" # 每日早报
- "github.com/ruk1ng001/wxbot/plugins/movies" # 影片搜索
- "github.com/ruk1ng001/wxbot/plugins/crazykfc" # KFC疯狂星期四
# 🤝 社交管理插件
- "github.com/ruk1ng001/wxbot/plugins/friendadd" # 自动加好友
- "github.com/ruk1ng001/wxbot/plugins/groupmanager" # 群管理
- "github.com/ruk1ng001/wxbot/plugins/spywithdraw" # 撤回监听
# 🛠️ 系统管理插件
- "github.com/ruk1ng001/wxbot/plugins/manager" # 系统管理
- "github.com/ruk1ng001/wxbot/plugins/score" # 积分系统
🔧 首次配置步骤¶
步骤1: 获取微信ID¶
- 启动机器人后发送任意消息
- 查看日志中的发送者ID
- 将ID添加到
config.yaml的superUsers中
步骤2: 配置Hook框架¶
- 确保微信Hook框架正常运行
- 确认框架的HTTP服务地址和端口
- 更新
config.yaml中的framework.host
步骤3: 验证连接¶
# 检查框架连接状态
curl http://localhost:7601/wxbot/monitor/health
# 预期返回
{
"status": "healthy",
"framework": "connected",
"timestamp": "2025-07-27T15:30:00Z"
}
步骤4: 测试基础功能¶
在微信中向机器人发送: - /菜单 - 查看所有可用插件 - 猜成语 - 测试Enhanced游戏功能 - 天气 北京 - 测试工具类插件
📊 监控和管理¶
Web监控仪表板¶
访问地址:http://localhost:7601/monitor.html
功能特性: - 📈 实时性能监控: CPU、内存、消息处理量 - 🎮 游戏统计: Enhanced插件游戏数据统计 - ⚠️ 告警管理: 系统告警和故障提醒 - 👥 用户分析: 活跃用户、群组统计 - 🔧 系统管理: 插件状态、配置管理
常用管理命令¶
# 查看运行状态
curl http://localhost:7601/wxbot/monitor/metrics
# 查看告警信息
curl http://localhost:7601/wxbot/monitor/alerts
# 重启服务(Docker)
docker restart wxbot-enhanced
# 查看实时日志(Docker)
docker logs -f wxbot-enhanced
🎮 Enhanced游戏功能展示¶
猜成语Enhanced¶
用户: 猜成语
机器人: [发送成语图片]
用户: 一心一意
机器人: 🎉 恭喜答对!
📊 您的战绩:
总游戏: 15局 | 胜率: 73.3%
当前连胜: 3局 | 最佳连胜: 8局
技能等级: 中级 | 积分: +10
成语接龙Enhanced¶
用户: 成语接龙
机器人: 开始成语接龙!请说一个成语
用户: 一马当先
机器人: 先声夺人
用户: 人定胜天
机器人: 天长地久
🏆 游戏结束!本轮回合: 4轮
您的成语接龙统计: 胜率 82% | 平均回合 6.5
实时统计功能¶
用户: 猜成语统计
机器人: 🎯 您的猜成语统计
📊 基础数据:
• 总游戏数: 45局
• 获胜次数: 33局
• 胜率: 73.3%
• 技能等级: 高级
⚡ 答题分析:
• 平均答题时间: 28.5秒
• 最快答题: 8秒
• 擅长类型: 历史典故类
🏆 排名信息:
• 群内排名: 第2名
• 月度排名: 第5名
🔍 故障排除¶
常见问题¶
1. 机器人无响应¶
2. 框架连接失败¶
# 测试框架连接
curl -I http://localhost:8080
# 检查配置文件
cat config.yaml | grep -A 5 framework
# 查看连接日志
grep "StarBotPro" logs/wxbot.log
3. 插件功能异常¶
获取帮助¶
- 📖 完整文档: 查看详细文档
- 🐛 问题反馈: GitHub Issues
- 💬 交流群组: 查看README中的QQ群
- 📊 监控仪表板: http://localhost:7601/monitor.html
🎉 开始使用Enhanced功能¶
配置完成后,您就可以享受Enhanced版本的强大功能:
✨ 立即体验¶
- 发送
猜成语- 体验Enhanced游戏统计 - 发送
签到- 体验连续奖励系统 - 访问监控页面 - 查看实时系统状态
- 发送
/菜单- 探索所有可用功能
🚀 进阶功能¶
- 配置定时任务 - 自动发送早报、提醒等
- 设置群组管理 - 自动管理群组和好友
- 自定义插件 - 开发专属功能插件
- 数据分析 - 利用统计数据分析用户行为
Enhanced版本让您的微信群聊更加智能和有趣! 🎊