10 分钟搭好微信机器人：wechat-assistant-pro 新手部署与配置避坑指南

束娆俏

156人浏览 · 2026-08-21 21:33:01

束娆俏 · 2026-08-21 21:33:01 发布

10 分钟搭好微信机器人：wechat-assistant-pro 新手部署与配置避坑指南

【免费下载链接】wechat-assistant-pro 智能微秘书客户端，搭配项目地址: https://gitcode.com/GitHub_Trending/we/wechat-assistant-pro

wechat-assistant-pro 是智能微秘书的客户端项目，一个基于 Wechaty 框架的微信机器人部署项目。它面向零编程基础的人：敲 3 条命令、改 1 处配置，就能跑起一个会自动回复、定时推送、同步群消息的微信机器人。全程不到 10 分钟，所有功能都在网页界面里完成，不用写代码。

它是什么

这个项目是智能微秘书的"手脚"：客户端跑在你的电脑或服务器上负责登录微信，功能配置全部放在平台的网页端。两者配合后，机器人可以：对接 ChatGPT、Dify、FastGPT、Coze 等大模型对话；跑定时任务（每日说、新闻、倒计时提醒、固定素材发送）；按关键词自动回复并过滤敏感词；跨群消息同步和批量群发；在素材中心统一管理文字、图片、文件、小程序和 H5 链接；通过开放 API 让外部系统向微信发消息。

部署：4 步从 0 到跑起来

第一步：环境准备

安装 Node 18 及以上版本，用 node -v 检查。Windows 需要 Win10 以上，Mac 和 CentOS 都没问题。如果不想折腾环境，可以跳过本步直接走官方 Docker 镜像。

第二步：获取代码并装依赖

git clone https://gitcode.com/GitHub_Trending/we/wechat-assistant-pro
cd wechat-assistant-pro
npm install

依赖安装慢或卡住时，换 npm 镜像源重试即可。

第三步：填密钥

在智能微秘书平台注册账号，到"个人中心"拿到 APIKEY 和 APISECRET 两个值。

打开 src/index.js，把文件里两处占位符替换成你拿到的两个密钥即可，只改这一行配置。

第四步：首次运行并登录

npm run start

终端会打出登录二维码，用微信扫一下，或者到平台的"小助手配置→登录状态"页面扫码。扫码成功后机器人上线，部署就结束了。之后所有功能都在网页端配置。

用起来：4 种典型玩法

每次改完配置，都要给机器人发"更新"两个字拉取最新配置，下面 4 个玩法都遵守这个规则。

让它会聊天

接一个大模型，让机器人像人一样对话。在平台"智能配置"里选 ChatGPT、Dify、FastGPT、Coze 中的一种，填上对应的 API Key，还可以自定义角色 Prompt 和限制对话次数。保存后发"更新"，之后在聊天里 @ 它就能接话。

让它定时推送

打开"小助手配置→定时任务"，页面分三类：每日说（天气加一句随心情话）、群资讯（选新闻分类和推送时间）、固定素材定时发送。填好时间保存，之后每天到点自动执行。

让它自动应答

在"关键词回复"页新增规则，每条规则就是关键词加匹配方式（精确或模糊）加回复内容，内容可以直接从素材中心里挑。比如配一条"加群"回群号、一条"功能"回功能清单，群里有人问就自动答。

给它备个内容库

"素材中心"是机器人的弹药库：文字、文件图片、小程序、H5 链接四类素材统一存放，关键词回复、定时任务、群发引用的是同一套。以后新增回复内容只需在这里建一条，到处复用。

3 个可直接照搬的配置思路

客服自动回复。需求：重复咨询统一答，复杂问题转人工。

先在素材中心备好标准答案（价格、发货、售后各一条）。
把每条答案配成模糊匹配的关键词规则。
再挂一个 Dify 或 FastGPT 知识库，接住关键词没覆盖的问题。

社群定时推送。需求：多个群按时收早报和通知。

在定时任务页给每个群加一条资讯任务，时间定在早上 8 点前后。
活动海报存进素材中心，需要时按固定素材任务发出。
想让两个群的成员互相说话，把群消息同步打开。

个人效率提醒。需求：喝水、打卡这类事别忘。

用固定素材发送配一条文字提醒，比如"该喝水了"。
或者直接私聊机器人说"提醒我每天 9:00 记得打卡"，它会自己建好提醒。

踩坑速查：5 个高频问题

现象	排查动作
扫码后掉线	检查网络是否稳定；换一个更稳定的登录协议；确认账号没被限制网页登录
登录后收不到消息	先给机器人发"更新"拉配置；检查 src/index.js 里两个密钥是否抄错；看终端日志定位卡点
定时任务不触发	确认机器人在线；核对服务器系统时间；检查任务里的时间和分类设置
Docker 镜像拉下来超过 1G	大概率拉错了镜像，换官方源重新拉；正常大小不到 500M
npm install 卡住	换 npm 镜像源；或直接用官方 Docker 镜像跳过本地环境