AI 微信机器人搭建指南
🤖 什么是 AI 微信助手?
AI 微信助手是一个基于 WeChaty 框架开发的智能机器人,它能够:
- 自动回复消息:群聊@机器人或私聊白名单好友时智能响应
- 支持多种 AI 模型:从国内的 DeepSeek、豆包到国外的智能对话模型
- 本地化部署:通过 Ollama 支持本地大模型,保护隐私更安全
- 灵活配置:按群聊/好友白名单、关键词前缀触发回复
🚀 环境准备与项目获取
首先确保你的电脑满足以下要求:
- Node.js ≥ v18.0(推荐 LTS 版本)
- npm 或 yarn 包管理器
- 任意一种 AI 服务的 API Key
git clone <repository_url>
cd wechat-bot
AI 服务配置:多模型自由选择
DeepSeek 免费版配置(推荐新手使用):
- 访问 DeepSeek 开放平台获取 API Key
- 在.env 文件中添加:
DEEPSEEK_FREE_TOKEN="你的 API Key"
复制配置文件模板:
cp .env.example .env
其他热门选择:
- 豆包:50 万免费 tokens,支持图片输入
- 302.AI:支持支付宝充值,替代国外智能对话模型的 API
- 通义千问:阿里云出品,性能稳定可靠
启动与登录
# 安装项目依赖
npm install
# 启动 AI 微信助手
npm run dev
启动后会出现微信扫码界面,用手机扫码登录即可开始使用。
🛠️ 核心功能详解
智能回复系统
AI 微信助手支持多种触发方式:
- 群聊@机器人:在群聊中@你的机器人即可获得智能回复
- 私聊白名单:只有指定的好友才能与机器人对话
- 关键词前缀:设置特定前缀触发 AI 回复,避免误触发
多模型无缝切换
项目内置多种 AI 服务接口,你可以根据需求自由切换:
- 免费选择:DeepSeek、豆包等提供免费额度
- 付费选择:国外智能对话模型等优质服务
- 本地部署:Ollama 支持本地大模型运行
个性化配置
在.env 文件中自定义你的机器人行为:
# 私聊白名单设置
ALIAS_WHITELIST="张三,李四"
# 群聊白名单设置
ROOM_WHITELIST="技术交流群,家人群"
# 机器人唤醒词
BOT_NAME="@我的智能助手"

