Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/atorber/chatflow-worker
ChatFlow-worker是ChatFlow聊天机器人管理平台的运行时，帮助微信用户运行自己的智能微信工作台，个人微信实现企业微信体验
https://github.com/atorber/chatflow-worker
Last synced: 3 months ago
JSON representation
ChatFlow-worker是ChatFlow聊天机器人管理平台的运行时，帮助微信用户运行自己的智能微信工作台，个人微信实现企业微信体验
- Host: GitHub
- URL: https://github.com/atorber/chatflow-worker
- Owner: atorber
- License: apache-2.0
- Created: 2023-11-06T02:38:58.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-03-18T07:30:14.000Z (10 months ago)
- Last Synced: 2024-10-03T09:44:46.941Z (3 months ago)
- Language: JavaScript
- Homepage:
- Size: 1.26 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ChatFlow-Worker
ChatFlow-Worker是ChatFlow项目的运行时，提供基于npm使用chatflow的示例代码及docker镜像，源码部署和运行可查看[ChatFlow](https://github.com/atorber/chatflow)
## 简介
ChatFlow是一个聊天机器人管理系统，可以帮助你实现一些原生IM无法支持的功能。
如果你是一个社群工作者、拼团团长、业务群运营经理，使用这个项目可以帮助你解决一些实际工作中的问题。
此外还提供定时任务、消息存档等功能。
基于开源项目Wechaty实现，目前主要验证了对微信的支持，理论上支持微信、钉钉、飞书、whatsapp等。
已适配网页版微信，linux、mac、Windows均可免费运行。
### 功能列表
[详细功能查看](https://www.yuque.com/atorber/chatflow/aialc7sbyb4ldmg4/edit)
|功能|描述|
|--|--|
|群发通知|向群或好友批量下发消息|
|消息存档|群聊天消息存档到表格（基于vika维格表，免费），可以在维格表中对聊天消息进行进一步统计、筛选、分析等|
|定时提醒|定时消息发送，支持单次定时和周期消息发送给指定好友或群|
|活动报名|群内接龙报名，使用 报名/取消 指令统计活动报名|
|智能问答|可以自定义问答内容，智能匹配答案，支持相似问题匹配，例如“什么时候到货？”“亲，几时到货”“亲，什么时候到货”均能匹配（基于微信对话开放平台，免费）|
|白名单|支持配置群白名单，白名单内群开启机器人问答/活动报名，未配置问题答案的群不会受到机器人干扰|
|MQTT消息推送|支持配置一个MQTTQ消息队列，将消息推送到队列当中|
|远程控制发消息|支持通过MQTT控制机器人向指定好友或群发消息|
## 快速开始
[访问项目语雀文档查看完整使用说明](https://www.yuque.com/atorber/chatflow)
1.下载源码并安装依赖
```Shell
git clone
cd ./chatflow-worker
npm install
```
2.分别登陆[微信对话开放平台](https://openai.weixin.qq.com/)和[vika维格表](https://spcp52tvpjhxm.com.vika.cn/?inviteCode=55152973)官网注册账号并获取token
3.重命名.env.example文件为.env并修改配置文件
> 快速开始仅需要修改VIKA_TOKEN、VIKA_SPACE_NAME、ADMINROOM_ADMINROOMTOPIC配置项,其他配置项暂时无需修改，使用微信对话开放平台时配置WXOPENAI_TOKEN、WXOPENAI_ENCODINGAESKEY
```.env
# Wechaty
WECHATY_PUPPET="wechaty-puppet-wechat4u" # 可选值：wechaty-puppet-wechat4u、wechaty-puppet-wechat、wechaty-puppet-xp、wechaty-puppet-engine、wechaty-puppet-padlocal、wechaty-puppet-service
WECHATY_TOKEN="" # 使用wechaty-puppet-padlocal、wechaty-puppet-service时需配置此token
# 基础配置
ADMINROOM_ADMINROOMTOPIC="替换为你的管理员群名称" # 管理群名称，需尽量保持名称复杂，避免重名群干扰
# 维格表配置
VIKA_SPACE_ID="替换为你的维格表空间ID" # 维格表空间ID或飞书多维表格的appToken
VIKA_TOKEN="替换为你的维格表token" # 维格表token或飞书多维表格信息拼接（使用'/'拼接三个参数：appId/appSecret/appToken）
# ENDPOINT="http://127.0.0.1:9503" # 后端管理服务API地址，默认http://127.0.0.1:9503，需要自行部署chatflow-admin项目
ENDPOINT="https://chat.vlist.cc" # 官方体验环境地址，可以直接使用，不需要启动chatflow-admin，但服务器不定时重启，不保证稳定
```
4.启动程序
```Shell
npm run start
```
出现二维码之后，扫码二维码登陆微信
5.开启智能问答功能
5.1 设置微信对话平台token，填写"环境变量"表中的 【对话平台token】、【对话平台EncodingAESKey】并在"功能开关"表中开启智能问答
添加一个简单问题到微信对话开放平台，测试对应群内智能问答内容
5.2 如果不希望每个群都开启智能问答，需设置群白名单,首先需要将上图中的群白名单开关设置为开启
然后将群加入到问答白名单，在“群白名单”表中，加入需要开启的群ID（roomid）
群ID在消息中查看(在群里发一条消息，然后控制台查看或在维格表中查找)
详细操作参考 [手把手教程](https://www.yuque.com/atorber/chatflow/zm4ulnwnqp9whmd6)
5.3 重启程序，在指定群测试问答
## 在Docker中部署运行
注意，因为wechaty-puppet-xp必须依赖Windows微信客户端，所以不能使用Docker，但使用wechaty-puppet-padlocal、wechaty-puppet-service、wechaty-puppet-、wechaty-puppet-wechat4u则可以用Doker来部署，
默认wechaty-puppet-wehcat4u为初始化puppet，mac、linux系统直接拉取镜像即可运行（mac M1需要自行打包镜像）,切换其他puppet在维格表的环境变量中修改配置并重启bot即可。
### 拉取和运行
- x86架构（云服务器、办公电脑等）
```Shell
docker run -d --restart=always --env VIKA_TOKEN="维格表token" --env VIKA_SPACE_NAME="维格表空间名称" --env ADMINROOM_ADMINROOMTOPIC="管理群名称" atorber/chatflow-worker:0.0.7-amd64
```
- arm架构（Mac M1 +）
```Shell
docker run -d --restart=always --env VIKA_TOKEN="维格表token" --env VIKA_SPACE_NAME="维格表空间名称" --env ADMINROOM_ADMINROOMTOPIC="管理群名称" atorber/chatflow-worker:0.0.7-arm64
```
- armv7（树莓派）
```Shell
docker run -d --restart=always --env VIKA_TOKEN="维格表token" --env VIKA_SPACE_NAME="维格表空间名称" --env ADMINROOM_ADMINROOMTOPIC="管理群名称" atorber/chatflow-worker:0.0.7-armv7
```
### Wechaty-Puppet支持
|puppet名称|支持平台 |需要token |付费| 备注|
|--|--|--|--|--|
|wechaty-puppet-wechat4u| Windows、Linux、macOS |否| 否 |网页版wechat，无法获取真实的微信ID和群ID，重启之后ID可能会变|
|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](https://wechaty.js.org/)请点击链接进行了解学习
## 视频演示及使用教程
到项目官网 [查看视频教程](https://qabot.vlist.cc/)
## 常见问题及解决方案
1. 加入QQ群 583830241 在线交流，添加 ledongmao 微信
2. 到 [项目语雀知识库](https://www.yuque.com/atorber/chatflow/ibnui5v8mob11d70) 查看常用问题
3. 如何有任何疑问或建议，提交一个issues
## 效果展示
去 [效果展示图文](https://www.yuque.com/atorber/chatflow/tbsokg3pqu5vk50y) 查看
## 二次开发
此项目只是提供了一个简单的使用微信机器人和智能对话平台实现的QA系统。如果有兴趣，可以继续学习微信对话开放平台的高级技能，实现诸如连续问答等高级功能，欢迎贡献你的创意。
项目源码移步 [ChatFlow](https://github.com/atorber/chatflow)
## Star History
[](https://star-history.com/#atorber/chatflow-worker&Date)