Docker 快速搭建微信机器人零门槛部署你的微信 AI 助手【免费下载链接】wechat-bot Multi-platform IM AI Agent for Telegram, WhatsApp, Lark, and WeChat. Connects ChatGPT / Claude / Kimi / DeepSeek / Ollama / Pi for auto-replies, community analysis, contact management, and inactive-friend detection.项目地址: https://gitcode.com/GitHub_Trending/we/wechat-bot你在开会技术群里有人抛了个问题没人接话你休息时客户发来的消息也悬着等不到回音。这类人不在场的空白正适合交给一台 7×24 在线的微信机器人。wechat-bot 就是一个基于 WeChaty 的开源微信 AI 助手用 Docker 一键搭建微信AI助手后它接上 DeepSeek、OpenAI、Kimi、讯飞、豆包、通义、Ollama 等主流大模型替你盯群、回话、发消息。读完这篇 Docker 部署微信机器人的指南你能做到从零跑起 wechat-bot 容器扫码完成微信登录配好 .env把任意一家 AI 服务接进来用白名单和关键词规则控制机器人只在你想要的场景开口遇到构建或登录故障时按排错清单快速定位。核心能力速览这个微信机器人能替你干哪些活先说清楚它能干什么再决定要不要花时间部署。wechat-bot 的核心能力包括私聊自动回复好友发来消息AI 即时应答群聊 触发只在被 时响应不打扰群里的正常交流群管理踢人、禁言、关键词过滤好友管理自动通过好友请求、维护备注消息处理语音转文字、图片识别定时任务到点自动发消息、发提醒异常账号检测发现并标记异常好友。三个典型用法你可以对照自己的需求挑一个群技术助手常驻技术交流群被 后回答常见问题顺手过滤刷屏关键词个人日程助手每天定时推送提醒帮你盯住日程节点营销通知新成员进群自动发欢迎语触发特定关键词时推送活动信息。五分钟快速部署从环境到扫码登录环境要求动手前核对一下机器配置项目最低要求推荐配置操作系统Windows 10/11、macOS 12、LinuxUbuntu 20.04 LTSDocker 版本20.1024.0.0内存2GB4GB可用存储1GB5GB网络可联网稳定连接安装 Docker按你的系统选一行即可# Ubuntu / Debian sudo apt update sudo apt install -y docker.io docker-compose sudo systemctl enable --now docker # CentOS sudo yum install -y docker-ce docker-ce-cli containerd.io sudo systemctl enable --now docker # macOS brew install --cask dockerWindows 用户到 Docker 官网下载 Docker Desktop 安装包装完登录就能用。装完后记得把自己加进 docker 组sudo usermod -aG docker $USER并重新登录避免每次都敲 sudo。获取项目代码git clone https://gitcode.com/GitHub_Trending/we/wechat-bot cd wechat-bot配置 .env关键配置项说明把模板复制成正式配置然后填入你的 AI 密钥和白名单cp .env.example .env配置项说明示例AI 服务密钥各服务商的 API Key按你选的服务商填即可OPENAI_API_KEYsk-xxxAI_SERVICE指定用哪家 AI改这一个值即可切换AI_SERVICEdeepseekBOT_NAME群聊中被 时匹配的名称BOT_NAME我的机器人ALIAS_WHITELIST私聊白名单名单外好友不回复ALIAS_WHITELIST小A,小BROOM_WHITELIST群聊白名单只对指定群生效ROOM_WHITELIST技术交流群AUTO_REPLY_PREFIX可选的回复前缀留空即可AUTO_REPLY_PREFIX避坑提示AI 密钥只填你要用的那一家其余留空BOT_NAME必须与机器人在群里显示的名字完全一致群 回复才能生效。构建并启动容器两个镜像版本任选其一标准版兼容性好Alpine 版体积更小# 标准 Debian 镜像约 1.2GB docker build -t wechat-bot . # Alpine 精简镜像约 600MB docker build -f Dockerfile.alpine -t wechat-bot:alpine .镜像构建完成后启动并跟踪日志docker run -d --name wechat-bot -v $(pwd)/.env:/app/.env --restart unless-stopped wechat-bot docker logs -f wechat-bot关键点首次启动建议先看日志确认没有报错再放手让它后台运行。扫码登录日志里会打印出微信登录二维码用手机微信扫码机器人就上线了docker run -it --rm --name wechat-bot -v $(pwd)/.env:/app/.env wechat-bot npm run dev交互式运行能直接看到终端里的二维码适合第一次部署时调试。进阶玩法切换 AI、Compose 部署、自定义回复切换 AI 服务改.env里的AI_SERVICE即可可选值deepseek、openai、kimi、xunfei、doubao、tongyi、dify、ollama、302ai、claude。改完重启容器生效各家 API 文档里都能拿到对应的密钥。Docker Compose 部署需要多容器管理或日志轮转时写一份docker-compose.ymlservices: wechat-bot: build: . container_name: wechat-bot restart: unless-stopped volumes: - ./.env:/app/.env environment: - TZAsia/Shanghai logging: driver: json-file options: { max-size: 10m, max-file: 3 }然后docker-compose up -d一键拉起日志超过 10MB 自动滚动最多保留 3 个文件。自定义回复规则在 src/wechaty/sendMessage.js 里可以插入自己的逻辑比如关键词优先直答、其余交给 AIasync function onMessage(msg) { const text msg.text() if (text.includes(你好)) { return msg.say(你好我是群里的 AI 助手) } return aiReply(msg) }更多消息处理细节可以看 WeChaty 相关源码 和 平台模块。踩坑排错现象 → 原因 → 解法部署过程中最常见的问题基本都集中在这几类。构建超时一条命令换国内镜像现象docker build卡在 npm 安装依赖上半天没动静。原因容器内访问国外 npm 源和 apt 源太慢。解决镜像文件内置了国内源参数加个 build-arg 就能切过去docker build --build-arg APT_SOURCEaliyun -t wechat-bot .登录二维码不显示改用交互模式现象后台docker run -d启动后找不到二维码也没地方扫。原因二维码画在终端输出里后台模式看不到 stdout。解决用-it交互式运行二维码会直接打印在终端docker run -it --rm --name wechat-bot -v $(pwd)/.env:/app/.env wechat-bot npm run dev扫码后登录失败或被警告现象扫码后提示登录异常或账号频繁被提示风险。原因新注册账号权限受限频繁登录登出也会触发风控。解决换老一点的账号保持网络稳定减少重复扫码频率。若提示不支持的客户端可尝试换用 wechat4u puppetnpm install wechaty-puppet-wechat4u。AI 调用失败先跑 test 脚本定位现象消息发过去机器人没回或报调用错误。原因密钥过期、容器网络不通、余额不足或部分服务有地区限制。解决在容器里跑对应服务的测试脚本先确认密钥本身可用docker exec -it wechat-bot npm run test-openai同样的方式可以测讯飞test-xunfei、Kimitest-kimi等再逐层排查网络与额度。小结到这里你的微信 AI 助手已经能 7×24 在线值班了私聊自动回、群里被 秒回、定时任务照跑。接下来往哪扩由你决定——接自己的知识库、把群讨论汇总成日报或把 更新日志 里的新特性用起来。如果这篇指南帮到了你点个赞、收藏一下方便下次部署时翻出来。附录目录结构与资源wechat-bot/ ├── Dockerfile # 标准镜像构建 ├── Dockerfile.alpine # Alpine 精简镜像 ├── package.json ├── cli.js # 命令行入口 ├── README.md # 项目说明 └── src/ ├── wechaty/ # 消息收发与回复逻辑 ├── platforms/wechat/ # 微信消息存储与命令路由 ├── deepseek/ openai/ kimi/ xunfei/ ... # 各 AI 服务商适配 └── config/env.js # 环境变量读取项目说明完整功能与用法文档更新日志版本变更记录微信平台模块消息存储、命令路由源码【免费下载链接】wechat-bot Multi-platform IM AI Agent for Telegram, WhatsApp, Lark, and WeChat. Connects ChatGPT / Claude / Kimi / DeepSeek / Ollama / Pi for auto-replies, community analysis, contact management, and inactive-friend detection.项目地址: https://gitcode.com/GitHub_Trending/we/wechat-bot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Docker 快速搭建微信机器人：零门槛部署你的微信 AI 助手
Docker 快速搭建微信机器人零门槛部署你的微信 AI 助手【免费下载链接】wechat-bot Multi-platform IM AI Agent for Telegram, WhatsApp, Lark, and WeChat. Connects ChatGPT / Claude / Kimi / DeepSeek / Ollama / Pi for auto-replies, community analysis, contact management, and inactive-friend detection.项目地址: https://gitcode.com/GitHub_Trending/we/wechat-bot你在开会技术群里有人抛了个问题没人接话你休息时客户发来的消息也悬着等不到回音。这类人不在场的空白正适合交给一台 7×24 在线的微信机器人。wechat-bot 就是一个基于 WeChaty 的开源微信 AI 助手用 Docker 一键搭建微信AI助手后它接上 DeepSeek、OpenAI、Kimi、讯飞、豆包、通义、Ollama 等主流大模型替你盯群、回话、发消息。读完这篇 Docker 部署微信机器人的指南你能做到从零跑起 wechat-bot 容器扫码完成微信登录配好 .env把任意一家 AI 服务接进来用白名单和关键词规则控制机器人只在你想要的场景开口遇到构建或登录故障时按排错清单快速定位。核心能力速览这个微信机器人能替你干哪些活先说清楚它能干什么再决定要不要花时间部署。wechat-bot 的核心能力包括私聊自动回复好友发来消息AI 即时应答群聊 触发只在被 时响应不打扰群里的正常交流群管理踢人、禁言、关键词过滤好友管理自动通过好友请求、维护备注消息处理语音转文字、图片识别定时任务到点自动发消息、发提醒异常账号检测发现并标记异常好友。三个典型用法你可以对照自己的需求挑一个群技术助手常驻技术交流群被 后回答常见问题顺手过滤刷屏关键词个人日程助手每天定时推送提醒帮你盯住日程节点营销通知新成员进群自动发欢迎语触发特定关键词时推送活动信息。五分钟快速部署从环境到扫码登录环境要求动手前核对一下机器配置项目最低要求推荐配置操作系统Windows 10/11、macOS 12、LinuxUbuntu 20.04 LTSDocker 版本20.1024.0.0内存2GB4GB可用存储1GB5GB网络可联网稳定连接安装 Docker按你的系统选一行即可# Ubuntu / Debian sudo apt update sudo apt install -y docker.io docker-compose sudo systemctl enable --now docker # CentOS sudo yum install -y docker-ce docker-ce-cli containerd.io sudo systemctl enable --now docker # macOS brew install --cask dockerWindows 用户到 Docker 官网下载 Docker Desktop 安装包装完登录就能用。装完后记得把自己加进 docker 组sudo usermod -aG docker $USER并重新登录避免每次都敲 sudo。获取项目代码git clone https://gitcode.com/GitHub_Trending/we/wechat-bot cd wechat-bot配置 .env关键配置项说明把模板复制成正式配置然后填入你的 AI 密钥和白名单cp .env.example .env配置项说明示例AI 服务密钥各服务商的 API Key按你选的服务商填即可OPENAI_API_KEYsk-xxxAI_SERVICE指定用哪家 AI改这一个值即可切换AI_SERVICEdeepseekBOT_NAME群聊中被 时匹配的名称BOT_NAME我的机器人ALIAS_WHITELIST私聊白名单名单外好友不回复ALIAS_WHITELIST小A,小BROOM_WHITELIST群聊白名单只对指定群生效ROOM_WHITELIST技术交流群AUTO_REPLY_PREFIX可选的回复前缀留空即可AUTO_REPLY_PREFIX避坑提示AI 密钥只填你要用的那一家其余留空BOT_NAME必须与机器人在群里显示的名字完全一致群 回复才能生效。构建并启动容器两个镜像版本任选其一标准版兼容性好Alpine 版体积更小# 标准 Debian 镜像约 1.2GB docker build -t wechat-bot . # Alpine 精简镜像约 600MB docker build -f Dockerfile.alpine -t wechat-bot:alpine .镜像构建完成后启动并跟踪日志docker run -d --name wechat-bot -v $(pwd)/.env:/app/.env --restart unless-stopped wechat-bot docker logs -f wechat-bot关键点首次启动建议先看日志确认没有报错再放手让它后台运行。扫码登录日志里会打印出微信登录二维码用手机微信扫码机器人就上线了docker run -it --rm --name wechat-bot -v $(pwd)/.env:/app/.env wechat-bot npm run dev交互式运行能直接看到终端里的二维码适合第一次部署时调试。进阶玩法切换 AI、Compose 部署、自定义回复切换 AI 服务改.env里的AI_SERVICE即可可选值deepseek、openai、kimi、xunfei、doubao、tongyi、dify、ollama、302ai、claude。改完重启容器生效各家 API 文档里都能拿到对应的密钥。Docker Compose 部署需要多容器管理或日志轮转时写一份docker-compose.ymlservices: wechat-bot: build: . container_name: wechat-bot restart: unless-stopped volumes: - ./.env:/app/.env environment: - TZAsia/Shanghai logging: driver: json-file options: { max-size: 10m, max-file: 3 }然后docker-compose up -d一键拉起日志超过 10MB 自动滚动最多保留 3 个文件。自定义回复规则在 src/wechaty/sendMessage.js 里可以插入自己的逻辑比如关键词优先直答、其余交给 AIasync function onMessage(msg) { const text msg.text() if (text.includes(你好)) { return msg.say(你好我是群里的 AI 助手) } return aiReply(msg) }更多消息处理细节可以看 WeChaty 相关源码 和 平台模块。踩坑排错现象 → 原因 → 解法部署过程中最常见的问题基本都集中在这几类。构建超时一条命令换国内镜像现象docker build卡在 npm 安装依赖上半天没动静。原因容器内访问国外 npm 源和 apt 源太慢。解决镜像文件内置了国内源参数加个 build-arg 就能切过去docker build --build-arg APT_SOURCEaliyun -t wechat-bot .登录二维码不显示改用交互模式现象后台docker run -d启动后找不到二维码也没地方扫。原因二维码画在终端输出里后台模式看不到 stdout。解决用-it交互式运行二维码会直接打印在终端docker run -it --rm --name wechat-bot -v $(pwd)/.env:/app/.env wechat-bot npm run dev扫码后登录失败或被警告现象扫码后提示登录异常或账号频繁被提示风险。原因新注册账号权限受限频繁登录登出也会触发风控。解决换老一点的账号保持网络稳定减少重复扫码频率。若提示不支持的客户端可尝试换用 wechat4u puppetnpm install wechaty-puppet-wechat4u。AI 调用失败先跑 test 脚本定位现象消息发过去机器人没回或报调用错误。原因密钥过期、容器网络不通、余额不足或部分服务有地区限制。解决在容器里跑对应服务的测试脚本先确认密钥本身可用docker exec -it wechat-bot npm run test-openai同样的方式可以测讯飞test-xunfei、Kimitest-kimi等再逐层排查网络与额度。小结到这里你的微信 AI 助手已经能 7×24 在线值班了私聊自动回、群里被 秒回、定时任务照跑。接下来往哪扩由你决定——接自己的知识库、把群讨论汇总成日报或把 更新日志 里的新特性用起来。如果这篇指南帮到了你点个赞、收藏一下方便下次部署时翻出来。附录目录结构与资源wechat-bot/ ├── Dockerfile # 标准镜像构建 ├── Dockerfile.alpine # Alpine 精简镜像 ├── package.json ├── cli.js # 命令行入口 ├── README.md # 项目说明 └── src/ ├── wechaty/ # 消息收发与回复逻辑 ├── platforms/wechat/ # 微信消息存储与命令路由 ├── deepseek/ openai/ kimi/ xunfei/ ... # 各 AI 服务商适配 └── config/env.js # 环境变量读取项目说明完整功能与用法文档更新日志版本变更记录微信平台模块消息存储、命令路由源码【免费下载链接】wechat-bot Multi-platform IM AI Agent for Telegram, WhatsApp, Lark, and WeChat. Connects ChatGPT / Claude / Kimi / DeepSeek / Ollama / Pi for auto-replies, community analysis, contact management, and inactive-friend detection.项目地址: https://gitcode.com/GitHub_Trending/we/wechat-bot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
