小白必看：WeChat Bot环境配置详细教程

【免费下载链接】wechat-bot 🤖一个基于 WeChaty 结合 DeepSeek / ChatGPT / Kimi / 讯飞等Ai服务实现的微信机器人 ，可以用来帮助你自动回复微信消息，或者管理微信群/好友，检测僵尸粉等... 项目地址: https://gitcode.com/GitHub_Trending/we/wechat-bot

引言：为什么需要WeChat Bot？

你还在为微信消息回复不及时而烦恼吗？还在手动管理多个微信群聊感到力不从心吗？本文将带你一步步搭建属于自己的微信机器人，实现自动回复消息、管理群聊/好友、检测不活跃用户等功能。通过本教程，你将掌握Node.js环境配置、API密钥获取、机器人启动等核心技能，即使零基础也能轻松上手。

一、环境准备

1.1 系统要求

操作系统	最低版本要求	推荐配置
Windows	Windows 10 64位	Windows 11 64位
macOS	macOS 10.15	macOS 12+
Linux	Ubuntu 18.04	Ubuntu 20.04+

1.2 安装Node.js

WeChat Bot需要Node.js环境支持，推荐使用LTS版本（>=18.0.0）。

Windows/macOS安装步骤：

1. 访问Node.js官网：https://nodejs.org/
2. 下载LTS版本安装包
3. 双击安装，勾选"Add to PATH"选项

Linux安装步骤：

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node -v  # 应输出v18.x.x或更高版本
npm -v   # 应输出8.x.x或更高版本

1.3 安装Git

# Windows
# 访问https://git-scm.com/下载安装包

# macOS
brew install git

# Ubuntu/Debian
sudo apt install git

二、获取项目代码

2.1 克隆仓库

git clone https://gitcode.com/GitHub_Trending/we/wechat-bot.git
cd wechat-bot

2.2 目录结构说明

wechat-bot/
├── src/                # 源代码目录
│   ├── wechaty/        # WeChaty相关功能
│   ├── openai/         # OpenAI服务集成
│   ├── deepseek/       # DeepSeek服务集成
│   └── ...             # 其他AI服务集成
├── .env.example        # 环境变量示例文件
├── package.json        # 项目依赖配置
├── cli.js              # 命令行入口文件
└── Dockerfile          # Docker部署配置

三、安装依赖

3.1 使用npm安装

# 切换npm镜像（国内用户推荐）
npm config set registry https://registry.npmmirror.com

# 安装依赖
npm install

3.2 使用yarn安装（推荐）

# 安装yarn
npm install -g yarn

# 切换yarn镜像
yarn config set registry https://registry.npmmirror.com

# 安装依赖
yarn install

3.3 常见问题解决

依赖安装失败？

# 清除npm缓存
npm cache clean --force

# 删除node_modules和package-lock.json
rm -rf node_modules package-lock.json

# 重新安装
npm install

puppeteer安装失败？

# 跳过Chromium下载
export PUPPETEER_SKIP_DOWNLOAD=true  # Linux/macOS
# 或
set PUPPETEER_SKIP_DOWNLOAD=true     # Windows

四、配置AI服务

4.1 复制环境变量文件

cp .env.example .env

4.2 配置文件说明

# .env文件主要配置项说明
BOT_NAME='@你的机器人名称'       # 机器人在群聊中的名称（需包含@）
ALIAS_WHITELIST='好友1,好友2'  # 私聊白名单
ROOM_WHITELIST='群聊1,群聊2'   # 群聊白名单
SERVICE_TYPE=''                # 默认AI服务类型

4.3 选择并配置AI服务（任选其一）

4.3.1 DeepSeek配置

1. 访问DeepSeek开放平台：https://platform.deepseek.com/
2. 创建API密钥
3. 在.env文件中添加：

DEEPSEEK_API_KEY='你的API密钥'
DEEPSEEK_MODEL='deepseek-ai/DeepSeek-R1'
SERVICE_TYPE='deepseek'

4.3.2 ChatGPT配置

1. 访问OpenAI平台：https://platform.openai.com/
2. 创建API密钥
3. 在.env文件中添加：

OPENAI_API_KEY='你的API密钥'
OPENAI_MODEL='gpt-4o'
SERVICE_TYPE='ChatGPT'

4.3.3 其他AI服务配置

豆包配置：

DOUBAO_API_KEY='你的API密钥'
DOUBAO_MODEL='doubao-seed-1-6-thinking-250615'
SERVICE_TYPE='doubao'

Kimi配置：

KIMI_API_KEY='你的API密钥'
SERVICE_TYPE='Kimi'

讯飞配置：

XUNFEI_APP_ID='你的APP ID'
XUNFEI_API_KEY='你的API Key'
XUNFEI_API_SECRET='你的API Secret'
SERVICE_TYPE='Xunfei'

五、启动机器人

5.1 基本启动方式

# 使用npm
npm run dev

# 使用yarn
yarn dev

5.2 指定AI服务启动

# 启动Kimi服务
npm run start -- --serve Kimi

# 启动DeepSeek服务
npm run start -- --serve deepseek

5.3 扫码登录

启动后会在控制台显示二维码，使用微信扫码登录：

[二维码图片]
Start to log in wechat...

5.4 验证安装

# 测试消息发送
npm run test

六、Docker部署（高级）

6.1 构建镜像

docker build -t wechat-bot .

6.2 运行容器

docker run -d --name wechat-bot -v $(pwd)/.env:/app/.env wechat-bot

6.3 查看日志

docker logs -f wechat-bot

七、白名单配置

7.1 私聊白名单

# .env文件中配置
ALIAS_WHITELIST='张三,李四'  # 用逗号分隔多个好友名称

7.2 群聊白名单

# .env文件中配置
ROOM_WHITELIST='技术交流群,学习小组'  # 用逗号分隔多个群聊名称

7.3 自动回复前缀

# 仅当消息以指定前缀开头时才自动回复
AUTO_REPLY_PREFIX='bot:'  # 例如仅回复以"bot:"开头的消息

八、常见问题解决

8.1 Node.js版本问题

# 查看当前Node.js版本
node -v

# 如果版本过低，使用nvm安装指定版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
nvm install 18
nvm use 18

8.2 网络连接设置

# 设置网络连接（需要网络工具支持）
export https_proxy=http://127.0.0.1:你的网络端口
export http_proxy=http://127.0.0.1:你的网络端口

8.3 API密钥错误

• 确保API密钥没有多余的空格
• 检查API密钥是否过期
• 验证账户是否有可用额度

8.4 微信登录问题

• 确保使用的是微信小号，避免主号被限制
• 扫码后如果长时间无响应，尝试删除WechatEveryDay.memory-card.json文件后重试

九、功能扩展

9.1 添加自定义回复逻辑

修改src/wechaty/sendMessage.js文件：

// 在defaultMessage函数中添加自定义逻辑
if (content.includes('你好')) {
  await contact.say('你好！我是WeChat Bot，很高兴为你服务！');
  return;
}

9.2 集成新的AI服务

1. 在src目录下创建新的服务目录（如newai）
2. 实现getNewAiReply函数
3. 在src/wechaty/serve.js中添加服务映射

十、总结与展望

通过本教程，你已经成功搭建了WeChat Bot的运行环境。现在你可以：

• 使用AI服务自动回复微信消息
• 管理微信群聊和好友
• 扩展自定义功能满足个性化需求

未来，WeChat Bot将支持更多AI服务和功能，欢迎通过项目仓库提交Issue和PR，一起完善这个项目！

附录：参考资源

• WeChaty官方文档：https://wechaty.js.org/
• DeepSeek开放平台：https://platform.deepseek.com/
• OpenAI API文档：https://platform.openai.com/docs/api-reference

【免费下载链接】wechat-bot 🤖一个基于 WeChaty 结合 DeepSeek / ChatGPT / Kimi / 讯飞等Ai服务实现的微信机器人 ，可以用来帮助你自动回复微信消息，或者管理微信群/好友，检测僵尸粉等... 项目地址: https://gitcode.com/GitHub_Trending/we/wechat-bot