ChatFlow

简介

ChatFlow是一个聊天机器人管理系统，可以帮助你实现一些原生IM无法支持的功能。

如果你是一个社群工作者、微信群私域运营人员，使用这个项目可以帮助你解决一些自动化问题。

基于开源项目Wechaty实现，目前主要验证了对WeChat的支持，理论上支持钉钉、飞书、whatsapp等Wechaty已实现的所有IM。

支持在Linux、Mac、Windows上运行。

功能列表

功能	描述
定时提醒	定时消息发送，支持单次定时和周期消息发送给指定好友或群
智能问答	可以自定义问答内容，智能匹配答案，支持相似问题匹配，例如“什么时候到货？”“亲，几时到货”“亲，什么时候到货”均能匹配（基于微信对话开放平台，免费）
ChatGPT问答	已对接ChatGPT，支持使用ChatGPT作为聊天机器人呢
群发通知	向群或好友批量下发消息
消息存档	群聊天消息存档到表格（基于vika维格表，免费），可以在维格表中对聊天消息进行进一步统计、筛选、分析等
活动报名	群内接龙报名，使用报名/取消指令统计活动报名
白名单	支持配置群白名单，白名单内群开启机器人问答/活动报名/ChatGPT问答，未配置问题答案的群不会受到机器人干扰
MQTT消息推送	支持配置一个MQTTQ消息队列，将消息推送到队列当中
远程控制发消息	支持通过MQTT控制机器人向指定好友或群发消息
Web控制台	Web端控制台预览版已上线，抢险体验可以访问 chat.vlist.cc

移步语雀文档查看详细功能查看

快速开始

2.0.25+之后的版本，数据表不兼容，在运行时建议配置全新的维格表空间或删除原空间全部表

1.下载源码并安装依赖

git clone <https://github.com/atorber/chatflow.git>
cd ./chatflow
npm install

2.分别登陆微信对话开放平台和vika维格表官网注册账号并获取token

3.重命名.env.example文件为.env并修改配置文件

快速开始仅需要修改VIKA_TOKEN、VIKA_SPACE_NAME、ADMINROOM_ADMINROOMTOPIC配置项,其他配置项暂时无需修改，使用微信对话开放平台时配置WXOPENAI_TOKEN、WXOPENAI_ENCODINGAESKEY

# 维格表配置
VIKA_SPACE_ID="替换为自己的维格表空间ID"
VIKA_TOKEN="替换为自己的维格表token"

# 基础配置
ADMINROOM_ADMINROOMTOPIC="瓦力是群主" # 管理群名称，需尽量保持名称复杂，避免重名群干扰

4.启动程序

npm run start

出现二维码之后，扫码二维码登陆微信

5.开启智能问答功能

5.1 设置微信对话平台token，填写【环境变量|Env】表中的【微信对话开放平台-Token】、【微信对话开放平台-EncodingAESKey】、【微信对话开放平台-APPID】、【微信对话开放平台-管理员ID】并将【智能问答-启用自动问答】修改为 true

5.2 添加问题到【问答列表|Qa】，添加之后在管理员群内发送【更新问答】

5.3 将群加入到【白名单|WhiteList】，在【白名单|WhiteList】表中，所属应用选择【智能问答|qa】

群ID在消息中查看(在群里发一条消息，然后控制台查看或在维格表中查找)

5.4 在管理群发送【更新白名单】或者重启程序

详细操作参考手把手教程

在Docker中部署运行

注意，因为wechaty-puppet-xp必须依赖Windows微信客户端，所以不能使用Docker，但使用wechaty-puppet-padlocal、wechaty-puppet-service则可以用Doker来部署，

最新代码已经默认wechaty-puppet-wehcat为初始化puppet，mac、linux系统直接拉取镜像即可运行（mac M1需要自行打包镜像）

移步语雀文档查看手把手教程

拉取和运行

最新版本

docker run -d --restart=always 
--env VIKA_TOKEN="维格表token" 
--env VIKA_SPACE_NAME="维格表空间名称" 
--env ADMINROOM_ADMINROOMTOPIC="超哥是群主" 
atorber/chatflow:latest

Wechaty-Puppet支持

puppet名称	支持平台	需要token	付费	备注
wechaty-puppet-wechat	Windows、Linux、macOS	否	否	网页版wechat，无法获取真实的微信ID和群ID，重启之后ID可能会变
wechaty-puppet-xp	Windows	否	否	仅支持windows
wechaty-puppet-padlocal👍	Windows、Linux、macOS	是	是
wechaty-puppet-service👍	Windows、Linux、macOS	是	是	企业微信

特别注意，Wechaty-Puppet是wechaty的概念，本项目不涉及机器人开发，只是使用wechaty项目进行业务功能实现，什么是Wechaty请点击链接进行了解学习

视频演示及使用教程

到项目官网查看视频教程

常见问题及解决方案

加入QQ群 583830241 在线交流，添加 ledongmao 微信
到项目语雀知识库查看常用问题
提交一个issues https://github.com/atorber/chatflow/issues

效果展示

去效果展示图文查看

二次开发

此项目只是提供了一个简单的使用微信机器人和智能对话平台实现的QA系统。如果有兴趣，可以继续学习微信对话开放平台的高级技能，实现诸如连续问答等高级功能，欢迎贡献你的创意。

此外要说明的是，项目中使用puppet-xp完全是出于免费的考虑，如果不考虑这一点的话，wechaty还有更好用的puppet，对于有能力的开发者来说可以根据实际情况替换。

TODO LIST

消息群发，通知消息同时发布到多个群
消息转发，按设定规则转发消息
使用VIKA托管配置文件

cyancow / chatflow