跳转至

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

  1. 启动机器人后发送任意消息
  2. 查看日志中的发送者ID
  3. 将ID添加到config.yamlsuperUsers

步骤2: 配置Hook框架

  1. 确保微信Hook框架正常运行
  2. 确认框架的HTTP服务地址和端口
  3. 更新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. 机器人无响应

# 检查进程状态
ps aux | grep wxbot

# 检查端口占用
netstat -tulpn | grep 7601

# 查看错误日志
tail -f logs/wxbot.log

2. 框架连接失败

# 测试框架连接
curl -I http://localhost:8080

# 检查配置文件
cat config.yaml | grep -A 5 framework

# 查看连接日志
grep "StarBotPro" logs/wxbot.log

3. 插件功能异常

# 检查插件配置
cat plugins.yaml

# 重新生成插件
make plugins

# 检查数据库
ls -la data/plugins/

获取帮助

  • 📖 完整文档: 查看详细文档
  • 🐛 问题反馈: GitHub Issues
  • 💬 交流群组: 查看README中的QQ群
  • 📊 监控仪表板: http://localhost:7601/monitor.html

🎉 开始使用Enhanced功能

配置完成后,您就可以享受Enhanced版本的强大功能:

✨ 立即体验

  1. 发送 猜成语 - 体验Enhanced游戏统计
  2. 发送 签到 - 体验连续奖励系统
  3. 访问监控页面 - 查看实时系统状态
  4. 发送 /菜单 - 探索所有可用功能

🚀 进阶功能

  • 配置定时任务 - 自动发送早报、提醒等
  • 设置群组管理 - 自动管理群组和好友
  • 自定义插件 - 开发专属功能插件
  • 数据分析 - 利用统计数据分析用户行为

Enhanced版本让您的微信群聊更加智能和有趣! 🎊