{"id":13490035,"url":"https://github.com/leochen-g/wechat-assistant-pro","last_synced_at":"2025-05-14T11:10:17.965Z","repository":{"id":43282893,"uuid":"219164711","full_name":"leochen-g/wechat-assistant-pro","owner":"leochen-g","description":"智能微秘书,全能微信机器人管理平台,简单的方式接入ChatGPT,FastGPT,Dify,Coze,扣子,DeepSeek.支持绘图，语音识别，语音发送，定时任务，支持企微、公众号、5G 消息、WhatsApp","archived":false,"fork":false,"pushed_at":"2025-03-11T09:30:46.000Z","size":37600,"stargazers_count":2128,"open_issues_count":24,"forks_count":332,"subscribers_count":27,"default_branch":"master","last_synced_at":"2025-04-11T04:55:24.074Z","etag":null,"topics":["chatrobot","coze","coze-bot","wechat","wechatbot","wechaty","whatsapp-bot"],"latest_commit_sha":null,"homepage":"https://wechat.aibotk.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/leochen-g.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-11-02T14:23:14.000Z","updated_at":"2025-04-10T01:39:20.000Z","dependencies_parsed_at":"2023-12-13T06:29:35.320Z","dependency_job_id":"a3db0d00-7a3d-4f85-a00f-40cb3f6fb82b","html_url":"https://github.com/leochen-g/wechat-assistant-pro","commit_stats":{"total_commits":239,"total_committers":5,"mean_commits":47.8,"dds":"0.16317991631799167","last_synced_commit":"22ca82ce025282ae110614d48636cb2e21fd1d3c"},"previous_names":[],"tags_count":148,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leochen-g%2Fwechat-assistant-pro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leochen-g%2Fwechat-assistant-pro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leochen-g%2Fwechat-assistant-pro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leochen-g%2Fwechat-assistant-pro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leochen-g","download_url":"https://codeload.github.com/leochen-g/wechat-assistant-pro/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254129489,"owners_count":22019628,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chatrobot","coze","coze-bot","wechat","wechatbot","wechaty","whatsapp-bot"],"created_at":"2024-07-31T19:00:39.612Z","updated_at":"2025-05-14T11:10:12.933Z","avatar_url":"https://github.com/leochen-g.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","Chatbots"],"sub_categories":[],"readme":"[![ 由Wechaty提供 ](https://img.shields.io/badge/Powered%20By-Wechaty-blue.svg)](https://github.com/wechaty/wechaty)\n[![node version](https://img.shields.io/badge/node-%3E%3D16-blue.svg)](http://nodejs.cn/download/)\n![](https://img.shields.io/badge/Window-green.svg)\n![](https://img.shields.io/badge/Mac-yellow.svg)\n![](https://img.shields.io/badge/Centos-blue.svg)\n[![](https://img.shields.io/badge/Docker-red.svg)]()\n\n## 智能微秘书\n\n智能机器人配置管理平台，一键接入ChatGPT对话，无缝适配Dify,FastGPT,Coze知识库！\n\n支持群组，个人定义不同的角色，灵活配置各种对话模式，绘图，识图，联网查询，GPTs，语音分析，技能丰富多样！拥有各种定时任务，RSS订阅，倒计时提醒，新闻咨询发送，批量群发，转发，跨群聊天，提醒功能，API发送消息\n\n配合智能微秘书客户端可以一键接入公众号，企业微信，Gitter，Lark，WhatsApp，5G消息等Wechaty所支持的协议\n\n[微秘书官网](https://wechat.aibotk.com)\n\n本项目是搭配智能微秘书平台使用的微秘书客户端，想要使用自己的机器人，必须自己部署微秘书客户端方可。\n\n## 依赖\n\nnode 版本 \u003e18\n\n## 项目说明\n\n本项目是基于[wechaty](https://github.com/wechaty/wechaty) 的开源智能机器人项目，更多关于`Wechaty`项目说明及 api \n文档可以移步：[wechaty 介绍](https://wechaty.js.org/docs/howto/)\n\n微秘书部署详细教程链接地址：[微秘书文档](https://help.aibotk.com/?plugin=czw_emDoc\u0026post=5)\n\n## 更多功能说明\n\n![](./doc/img/aibot.png)\n\n### 🌟 群发助手\n- 可以批量发送消息到多个群聊或好友，也可以批量设置群公告。\n\n### 🔄 转发助手\n- 管理员给机器人发送的消息可以转发给指定的群聊或好友，实现群发效果。\n\n### 🌐 群消息同步\n- 跨群聊天，打破群与群之间的壁垒，多个群的消息可以相互同步。1 群的人可以和 2 群的人聊天，反之亦然。\n\n### 📩 回调事件\n- 适用于有开发能力且有自己服务器的人员，可以配置指定内容转发到你的服务器，由你来返回回复的内容。\n\n### 📰 RSS订阅推送\n- 配置 RSS 源，当 RSS 源内容更新时，会推送到指定的群或好友。\n\n## 智能配置\n\n### ⚙️ 基础配置\n- 自动通过好友，并发送欢迎词。\n- 解析小程序和 H5 链接内容。\n  \n#### 🤖 机器人触发范围\n- 允许配置所有群、所有好友，或群和好友都生效。\n\n#### 🚫 敏感词过滤\n- 支持配置敏感词过滤。\n\n### 🤖 智能机器人回复\n- **天行机器人**：需要申请天行机器人权限。\n- **图灵机器人**：需要申请图灵机器人 Key。\n- **微信对话开放平台**：自行申请 API Key 等信息。\n- **ChatGPT**：支持配置代理地址和兼容的第三方 API 地址，支持配置 Prompt 来设定角色。\n- **Dify**：可挂载知识库，实现私域问答或客服效果。\n- **FastGPT**：同样可挂载知识库，实现私域问答或客服效果。\n  \n#### 🛠️ 其他机器人\n- Qanything\n- Coze\n- 扣子\n\n### ❓ 简单问答\n- 指定关键词回复指定素材内容，关键词可以模糊或精准匹配，可用于固定问答、产品信息查询、暗号获取等。\n\n### 🎉 技能中心\n- 系统内置技能，设置不同关键词触发不同效果，例如名人名言、土味情话、垃圾分类、黄历查询等，增加趣味性。\n\n## GPT自定义对话配置\n\n### 💬 自定义对话\n- 针对好友或群组设置不同角色，实现千人千面的效果。\n\n🔄 支持切换多种机器人\n- ChatGPT, Dify, FastGPT, 扣子, Coze, Qanything 等。\n\n⏳ 支持设置对话次数限制，带文本审核接口。\n \n 🎤 语音识别与发送（企微协议支持，需定制开通）。\n \n🔑 支持设置不同关键词触发不同角色，无需 @ 即可触发。\n\n🎭 角色预设\n\n- 提前预设 Prompt，系统内置优秀 Prompt。\n\n## 定时任务\n\n### ☀️ 每日说\n- 固定早安问候内容、天气、每日情话。\n\n### 📅 个性化内容定制推送\n- 定制个性化内容进行定时推送，可以是第三方网站内容或爬取内容。\n\n### ⏲️ 倒计时提醒\n- 设置未来时间进行每天倒计时提醒。\n\n### 📦 固定素材内容发送\n- 每天固定时间发送固定文字、图片等，用于提醒下班、喝水等。\n\n### 📰 不同分类新闻内容发送\n- 定时发送各种分类新闻，如娱乐新闻、国内新闻、国际新闻等。\n\n### 🔔 对话设置提醒\n- 好友私聊发送固定格式的内容可创建提醒，例如“提醒我每天9:00记得打卡上班”。\n\n## 群聊列表管理\n\n💬 在线发送消息到群聊\n- 支持文字、图片、文件、小程序、H5链接等格式。\n\n📜 在线发送固定素材内容到群聊\n\n🗝️ 关键词进群管理\n\n- 配置进群关键词及欢迎词。\n\n## 好友列表\n\n💌 在线发送消息到好友\n\n## 素材中心\n\n📝 文字素材 \n📁 文件、图片素材 \n🌐 小程序素材 \n🔗 H5链接卡片素材 \n\n## 开放 API 功能\n\n⚙️ 任意系统调用接口发送消息到群聊和好友，支持发送文字、图片、视频等格式。\n  \n👥 获取所有好友列表和群列表。\n\n## 📞 其他定制功能\n\n图像识别，语音识别，语音发送，自定义机器人接口开放请加入交流群，联系管理员即可\n\n更多详情介绍：[功能概览](https://help.aibotk.com/?plugin=czw_emDoc\u0026post=31)\n\n## 提前准备\n\n### 注册智能微秘书管理账号\n\n1. 注册：[智能微秘书](https://wechat.aibotk.com/#/signup?r=dBL0Bn)\n\n2. 初始化配置文件`小助手配置-\u003e基础配置`，修改后保存\n\n3. 个人中心获取`APIKEY`和`APISECRET`，后续配置用到\n\n![](./doc/img/user-center.png)\n\n### 注册天行数据账号\n\n由于本项目大部分定时资讯和一些天气接口来自于天行数据，所以需要提前准备好天行数据的账号，同时申请好相关接口的权限\n\n1、注册: [天行数据](https://www.tianapi.com/source/865c0f3bfa)\n\n2、申请接口权限\n\n必选接口\n\n* [天行机器人](https://www.tianapi.com/apiview/47): https://www.tianapi.com/apiview/47\n* [天气](https://www.tianapi.com/apiview/72):https://www.tianapi.com/apiview/72\n* [新闻](https://www.tianapi.com/apiview/51) : https://www.tianapi.com/apiview/51 ** (新闻资讯只需要申请这个接口即可，不需要申请具体的分类接口，务必记着)**\n* [垃圾分类](https://www.tianapi.com/apiview/97): https://www.tianapi.com/apiview/97\n\n可选接口（如果想使用相应的功能还是必须申请的），但是如果默认使用了天行机器人，以下功能接口无需申请也可以，机器人会直接返回对应信息\n\n* [土味情话](https://www.tianapi.com/apiview/80):https://www.tianapi.com/apiview/80\n* [名人名言](https://www.tianapi.com/apiview/92):https://www.tianapi.com/apiview/92\n* [星座运势](https://www.tianapi.com/apiview/78):https://www.tianapi.com/apiview/78\n* [姓氏起源](https://www.tianapi.com/apiview/94):https://www.tianapi.com/apiview/94\n* [顺口溜](https://www.tianapi.com/apiview/54):https://www.tianapi.com/apiview/54\n* [老黄历](https://www.tianapi.com/apiview/45):https://www.tianapi.com/apiview/45\n* [神回复](https://www.tianapi.com/apiview/39):https://www.tianapi.com/apiview/39\n* [歇后语](https://www.tianapi.com/apiview/38):https://www.tianapi.com/apiview/38\n* [绕口令](https://www.tianapi.com/apiview/37):https://www.tianapi.com/apiview/37\n* [疫情](https://www.tianapi.com/apiview/169):https://www.tianapi.com/apiview/169\n* [网络取名](https://www.tianapi.com/apiview/36):https://www.tianapi.com/apiview/36\n\n目前平台只适配了以上天行数据的接口，其他接口暂未适配，如有需要，可以联系定制\n\n\n## 开始\n\n### 源码运行\n\n需要node版本\u003e16，如果是windows 系统，请使用win10及以上版本\n\n#### Step 1: 安装\n\n克隆本项目，并进入项目根目录执行 `npm install`安装项目依赖\n\n#### Step 2: 配置\n\n`src/index.js`代码中配置`APIKEY`和`APISECRET`\n\n#### Step 3: 运行\n\n执行命令`npm run start`，终端会显示二维码，可以直接扫码，也可以到[智能微秘书](https://wechat.aibotk.com)（小助手配置-\u003e登录状态中进行扫码登录）\n\n#### Step 4: 配置相应功能\n\n在[智能微秘书](https://wechat.aibotk.com?r=dBL0Bn)中配置你需要的功能后，给启动的微信发送`更新`关键词即可拉取最新配置（或者你自己设置的更新关键词，初始关键词是`更新`，**\n每次修改配置后，请记得一定发送关键词更新配置**\n\n\n### Docker部署\n\n由于自己构建部分依赖安装比较慢，或者经常会卡住，所以本项目已经提前构建好发布到dockerhub了，直接pull就行了\n\n\u003e 注：使用第三方镜像源加速的。拉取的可能不是最新版本，所以会运行不起来，建议使用官方镜像源，自行切换，不会的可以百度一下\n\n![](https://img.aibotk.com/picgo/202304141139150.png)\n\n可以在[https://hub.docker.com/r/aibotk/wechat-assistant/tags](https://hub.docker.com/r/aibotk/wechat-assistant/tags) 这里查看到最新的 tag版本\n\n[![](https://img.aibotk.com/aibotk/help/7NOgdA20240112114359.png)](https://img.aibotk.com/aibotk/help/7NOgdA20240112114359.png)\n\n拉取完毕的大小大概不到 500M ,如果你拉取的大小超过 1G，大概率是拉取错版本了，请切换成官方源拉取\n\n\u003e 国内用户可以用这个镜像地址进行拉取 registry.cn-hangzhou.aliyuncs.com/aibotk/wechat-assistant:latest\n\n#### step1： 拉取镜像\n\n```shell\n# docker pull registry.cn-hangzhou.aliyuncs.com/aibotk/wechat-assistant:latest\n\ndocker pull aibotk/wechat-assistant\n\n```\n\n#### step2： 启动docker\n\n\n```shell\n# docker run -d -e AIBOTK_KEY=\"微秘书apikey\" -e AIBOTK_SECRET=\"微秘书apiSecret\" --name=wechatbot registry.cn-hangzhou.aliyuncs.com/aibotk/wechat-assistant:latest\n\ndocker run -d -e AIBOTK_KEY=\"微秘书apikey\" -e AIBOTK_SECRET=\"微秘书apiSecret\" --name=wechatbot aibotk/wechat-assistant\n```\n\n查看docker日志\n\n```\ndocker logs  wechatbot\n```\n\n### 自行构建docker镜像\n\n需要提前安装 docker 环境，项目根目录执行一下命令\n\n```shell script\ndocker build -t wechat-assistant .\n#web协议\ndocker run -e AIBOTK_KEY=\"微秘书apikey\" -e AIBOTK_SECRET=\"微秘书apiSecret\" wechat-assistant\n```\n\n其他步骤同上\n\n### 使用Gitpod 在线运行测试\n\n现智能微秘书已经适配Gitpod，如果你想测试自己的账号是否能够正常登录，可以在线运行一下测试，此环境仅做测试，不建议作为生产环境使用。\n\nGitpod 是一个在线和开源平台，用于自动化和现成代码的开发环境。您可以点击下面的按钮在gitpod 上访问wechat-assistant-pro的完整设置。如果您以前从未使用过 gitpod，则需要使用您的 gitHub 帐户登录。\n\n[![GitPod Ready-to-Code][gitpod_img]][gitpod_link]\n\n更多关于Gitpod的信息可以参考: https://wechaty.js.org/2021/02/06/wechaty-getting-started-without-leave-your-browser/\n\n### Railway部署\n\n[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/template/w6W1s-?referralCode=2rS9In)\n\n环境变量：AIBOTK_KEY和AIBOTK_SECRET必填\n\n### ipad协议运行\n\n查看：[如何使用padlocal协议](https://github.com/leochen-g/wechat-assistant-pro/issues/61)\n\n### 企微协议运行\n\n查看：[如何使用企微部署](https://github.com/leochen-g/wechat-assistant-pro/issues/60)\n\n### 公众号部署\n\n#### 提前准备\n\n1、必须有一个备案好的域名，绑定映射到容器的端口8077，否则无法在公众号后台配置\n2、需要在公众号开发配置里添加运行容器的ip白名单，否则消息无法调通\n\n#### 启动命令\n\n参数说明\n\nAIBOTK_KEY: 微秘书apikey\n\nAIBOTK_SECRET: 微秘书apiSecret\n\nOFFICE_APPID: 公众号AppId\n\nOFFICE_APPSECRET: 公众号AppSecret\n\nOFFICE_TOKEN: 公众号自己随机写的token\n\nOFFICE_IS_PERSON: 是不是个人订阅号或者未认证的服务号，如果是个人号或者未认证的服务号，3s内必须响应消息，否则无法发出消息。如果是认证的服务号，使用的是客服回复接口，不受回复时间限制\n\n认证服务号或者认证非个人订阅号启动方式\n\n```\ndocker run -d -e OFFICE_APPID=\"公众号AppId\" -e OFFICE_APPSECRET=\"公众号AppSecret\" -e OFFICE_TOKEN=\"公众号自定义的Token\" -e OFFICE_IS_PERSON=\"false\"  -e AIBOTK_KEY=\"微秘书apikey\" -e AIBOTK_SECRET=\"微秘书apiSecret\" -p 8077:8077 --name=officebot registry.cn-hangzhou.aliyuncs.com/aibotk/wechat-assistant:latest\n```\n\n个人订阅号或者非认证服务号启动方式\n\n```\ndocker run -d -e OFFICE_APPID=\"公众号AppId\" -e OFFICE_APPSECRET=\"公众号AppSecret\" -e OFFICE_TOKEN=\"公众号自定义的Token\" -e OFFICE_IS_PERSON=\"true\"  -e AIBOTK_KEY=\"微秘书apikey\" -e AIBOTK_SECRET=\"微秘书apiSecret\" -p 8077:8077 --name=officebot registry.cn-hangzhou.aliyuncs.com/aibotk/wechat-assistant:latest\n```\n\n\n## 体验与交流\n\n扫描下方二维码，添加智能微秘书，体验以上所有功能，发送加群关键词即可进入交流群，如果微信无法添加可以先进QQ群：1045575073\n\n![](http://image.xkboke.com/picgo/202301141927005.png)\n\n## 更新日志\n\n[更新日志](./CHANGELOG.md)\n\n## 常见问题处理\n\n参见[https://help.aibotk.com](https://help.aibotk.com/?plugin=czw_emDoc\u0026post=5)\n\n## 面板预览\n\n![](./doc/img/index.png)\n![](./doc/img/roomasync.png)\n![](./doc/img/everyday.png)\n![](./doc/img/event.png)\n![](./doc/img/material.png)\n\n## 功能预览\n\n![](./doc/img/news.jpeg)\n\n个人定时与群定时任务\n\n![](./doc/img/func.jpeg)\n\n\n\n## 免责声明\n\n本软件依据github上开源项目 Wechaty\n\n通过简单的设置UI和交互，运行IM机器人。\n\n请遵守国家法律政策，请勿用于非法犯罪行为！\n\n请合理使用，一切不良行为和后果均与作者无关！\n\n本项目不参与解析任何底层代码，只是适配层，所有底层协议均为第三方提供，与本人无关！\n\n[gitpod_img]: https://img.shields.io/badge/Gitpod-Ready--to--Code-blue?logo=gitpod\n[gitpod_link]: https://gitpod.io/#https://github.com/leochen-g/wechat-assistant-pro\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleochen-g%2Fwechat-assistant-pro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleochen-g%2Fwechat-assistant-pro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleochen-g%2Fwechat-assistant-pro/lists"}