wechat-bot

一个机器人接管你的所有聊天软件，自动回复+社群分析

wechat-bot 是一个多平台 IM AI 智能体，支持 Telegram、WhatsApp、飞书和微信，连接 ChatGPT、Claude、Kimi、DeepSeek、Ollama 等主流大模型，实现自动回复、社群分析、联系人管理和不活跃好友检测。它基于 Wechaty 等库构建，用 JavaScript 编写，旨在为个人和社群提供统一的 AI 对话入口，解决多平台消息分散、回复效率低、社群运营繁琐等问题。核心能力包括：多平台接入、多模型切换、智能上下文回复、社群活跃度分析、好友管理自动化。项目星标过万，社区活跃，适合开发者快速部署私有 AI 助手。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 11394

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队wangrongding

所属国家

官网地址

GitHubhttps://github.com/wangrongding/wechat-bot

定价模式free

价格说明开源项目，MIT许可证，可自行部署，完全免费。

访问状态

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型chatgpt,openai,wechat,wechatbot,wechaty

GitHub 星标★ 11394

30天Star增速

HF 下载量

上线时间2021-12-15 00:00:00

最近更新2026-09-22 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 15 分钟部署方式：本地安装 6 步

环境要求

Node.js >= v18.0（推荐 LTS 版本，低版本可能运行失败）
已安装 npm，可正常访问 npm 源（国内可切换淘宝镜像）
一个可扫码登录的微信账号（Web 协议存在账号风险）
如需使用云模型，终端网络需能访问对应模型服务（必要时配置代理）
如需 Docker 部署，需本地已安装 Docker

安装与启动步骤

1安装依赖

在项目根目录执行安装，国内网络慢可先切换淘宝镜像；建议安装时不要同时设置 npm 代理镜像。
```
npm i
```
2生成配置文件

复制示例环境变量文件为 .env，后续所有白名单和模型参数都在这里修改。
```
cp .env.example .env
```
3填写白名单配置

编辑 .env，至少填写机器人昵称、私聊白名单和群白名单，否则收到消息不会触发回复。
4链接全局命令

执行 npm link 把项目注册为全局命令，之后才能在任意位置使用 wb 命令启动。
```
npm link
```
5启动微信机器人

执行后终端会出现二维码，用微信扫码登录，登录成功后机器人开始按白名单规则自动回复。
```
wb agent --im wechat --agent pi
```
6Docker 部署(可选)

先构建镜像再挂载 .env 启动容器，适合不想在宿主机装 Node 依赖的场景。
```
docker build . -t wechat-bot
docker run -d --rm --name wechat-bot -v $(pwd)/.env:/app/.env wechat-bot
```

关键配置

配置项	必填	说明	示例
`BOT_NAME`	是	机器人微信昵称，群聊需要 @ 该名称才会触发回复	`@Your WeChat nickname`
`ALIAS_WHITELIST`	是	允许私聊触发自动回复的好友备注/别名白名单	`Friend alias allowed for private chat`
`ROOM_WHITELIST`	是	允许机器人响应的群聊名称白名单	`Group name allowed for access`
`PI_BIN`	是	Pi agent 可执行文件名称或路径	`pi`
`PI_AGENT_ARGS`	是	启动 Pi agent 时传入的参数，默认单轮非交互回复	`--print --no-session`
`WECHAT_STORE_MESSAGES`	否	是否把微信消息落盘为本地 JSONL 记录	`true`

如何确认成功

运行 node ./cli.js --help 和 npm run test:analysis 均正常；启动后终端出现二维码，扫码登录成功即代表跑通。

常见问题

Q：运行时提示 Node 版本相关错误怎么办？

A：确认 Node.js 版本大于等于 v18.0，是旧版本请升级到 LTS 版本，然后删除 lock 文件和 node_modules 重新安装依赖。

Q：安装依赖时 Puppeteer 下载失败怎么办？

A：设置环境变量 PUPPETEER_SKIP_DOWNLOAD='true' 后重装。Mac 用 export，Windows 用 SET 命令设置。

Q：什么样的消息才会被自动回复？

A：私聊需发送者别名或昵称在 ALIAS_WHITELIST 中；群聊需群名在 ROOM_WHITELIST 中且消息 @ 了 BOT_NAME。非文本消息不会进入回复流程。

Q：云端模型调用超时或失败怎么办？

A：确认 API Key、余额、模型名正确，并保证终端网络能访问模型服务，必要时按 README 配置 https_proxy、http_proxy、all_proxy 代理。

Q：依赖安装很慢怎么办？

A：可临时切换镜像：npm config set registry https://registry.npmmirror.com，装完后建议改回官方源以免影响后续安装。

注意事项

微信 Web 协议存在账号风险，可能被警告或封禁，请仅在明确接受风险的账号和场景下使用。
务必把白名单和使用范围控制得尽量小，避免机器人回复不相关内容。
非文本消息（图片、文件等）不会自动送入回复管线，需要自行扩展。
Docker 构建时若 Node 反复超时，可先拉取本地 Node 镜像并修改 Dockerfile 中的 node:19 版本。

核心亮点

支持微信、Telegram、WhatsApp、飞书四平台，一套代码全接入
内置多种大模型适配，切换 ChatGPT/Claude/DeepSeek 等无需改代码
社群分析和不活跃好友检测功能实用，直击运营痛点

不足之处

微信端依赖 Web 协议，存在封号风险
文档偏技术向，非开发者上手门槛较高

适用场景

个人多平台消息统一自动回复
社群运营者做活跃度分析和成员管理
开发者快速搭建跨平台 AI 客服机器人

替代项目

Wechaty、ChatGPT-on-WeChat、nonebot2

项目介绍

wechat-bot 是智能体领域的开源项目，由 wangrongding 开发，2021 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（11,394）位列前 5%，在智能体分类的 2,499 个项目里位列前 5%。

近 44 天，它的 GitHub 星标从 11,252 增加到 11,394，净增 142。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-22。MIT许可证，可自行部署，完全免费。

它主要面向的使用场景是：个人多平台消息统一自动回复。同类可对比的替代方案包括 Wechaty、ChatGPT-on-WeChat、nonebot2。

上一篇：awesome-ai-sdks

下一篇：ArcRift