GoBot

纯go编写的机器人业务后端，bot取名为 Vio ，qq机器人的实现基于gocq提供的api，基于gocq的上报事件调用转发外部讯息并返回。

其他平台也可在开发中，可参考现有逻辑。目前可以完成基于chatgpt聊天任务，部署在一个服务器可以多个平台共同调用。

如果你有想法和意见请提issue！这对我和bot都很重要！ 欢迎qq加群讨论：340961300

支持通信方式：

• http
• webhook
• 反向websocket

实现平台以及实现的外部功能:

• Telegram bot
• QQ bot
  • 随机涩图
  • 猎杀对决枪声语音
• 微信bot

写在前面/preface

有部署聊天机器人的想法，但是我使用的国内服务器，而且服务器性能也一般，于是决定不用云服务器部署了，找个国外的Paas平台，把写的后端送上去就好了。

目前已经完成了：

• http：该后端天然支持http请求，使用go原生net包，创建了一个post请求的路由，可以解析post内容转发调用chatgpt，目前我将其使用在微信公众号的后端上。
• webhook：为Tg设置了webhook，可以监听tg服务器的消息，实现tgbot。针对Telegram的消息处理，对私人，群组，超级群组各有不同的应答模式。
• 反向ws：配合go-cqhttp使用，用于实现qqbot,基于上报事件，调用gocq提供的api进行回复。注意参考gocq官方文档。可以调用api发送图片，随机图片api参考

chatgpt调用：

• 在聊天中支持chatgpt的回复。该功能使用了go-openai库，支持了go语言对openai api的调用
• 提示词参考：awesome-chatgpt-prompts-zh

本后端最终希望实现只对外暴露一个API,实现机器人通讯的应答模式,对不同平台创建不同的新服务,调用接口皆可进行通讯服务.通过环境变量设置启用平台。

2024/5更新：目前做了一次重大项目重构，使整个项目耦合程度下降，命令通过一个commandList哈希表来控制。websocket的conn不传入业务层，而是向外不断返回一个消息体，最后交给外层的ws连接发送。整个项目更加明了易读。添加了config配置文件，统一管理环境变量的初始化。

结构说明

• chatgpt： 管理chatgpt的api调用，实现了提示词调用
• config： 用于管理配置文件，提供一个函数用于环境变量初始化。
• gocq： qqbot的业务层核心。
  • cqEvent : gocq的事件数据结构
  • botCommand.go : bot的命令函数
  • CQCode : qq的cqcode设置
  • event : 业务层入口，定义事件处理函数
  • groupManage.go : 群组管理
  • messageHandler.go : 消息处理函数
  • rule.go : 消息过滤。
• server： 创建or使用服务(http,ws,tgbot)
  • websocket.go：qqbot服务入口
  • http： http请求服务入口
• tgbot : tgbot业务层核心。
• utils : 调用外界功能的函数库

实现要点

• 完全遵循gocq文档，gocq/cqEvent文件夹中有其事件消息的全部结构体实现。通过创建一个命令哈希表 map[string]func(params cmd_params))，在事件处理函数中调用该函数，返回一个需要发送给gocq的消息体数组，每个消息体均可让gocq做出某一单一行为。
• 使用go的websocket库创建和qqbot的ws连接，为基于gocq的qqbot的服务入口。
• gocq的配置建议阅读我的个人博客
• 微信公众号不建议集成，因为公众号的后端需要连接微信官方的后端，用一个新后端通过http请求调用这个bot后端比较好。
• tgbot多参考官方示例和已有项目，官方的机器人接口很完善
• chatgpt的调用参考go的openai库文档即可，也很完善。注意调用api是无法进行联系上下文对话的，要实现上下文对话只有把历史消息都post给api，这显然是不现实的。 或者你将ai模型部署在本地，将历史记录存放在本地数据库中，而你的ai模型调用chatgpt(显然工作量太大)

部署建议

我推荐放在paas上，key和密钥是通过环境变量读取的。 因为tgbot要求后端webhook地址必须有证书，也就是https访问。一般paas平台都会自带证书的，放自己服务器上需要自己配证书服务，麻烦点，并且需要修改项目中读取环境变量的代码，改为读取配置文件(新建).

我是放在heroku这个paas平台，国外的，可以通过github学生包免费使用，但是需要绑定国外visa卡。 之前也有使用过Zeabur，国人开发的，discord上官方也很活跃，如果服务请求不多，可以使用，每月有5刀的免费额度，无需绑卡。

paas推荐

对于

• Cloudflare Workers
• AirCode（国内团队做的） 它们侧重于

Fullstack Javascript Apps - Deploy and Host in Seconds

对非 Nodejs 的后端参考意义不大。 主要思路都是 Edge Network + Serverless Functions（函数代码在轻量级的 V8 沙盒中执行）

• Fly.io
• Railway

这两需要绑信用卡，并且railway免费计划只有试用5$了

看重免费计划可以查询 Free for dev中的列表.

对于我/for me

Zeabur挺不错，国内社区，discord上回复也很即使，一键部署挺快的，github集成。 zeabur上项目部署非常快,甚至不用写dockfile,而且对go项目有完整的支持,算是符合他们的口号:

Deploying your service with one click

但是Zeabur每月5$，如果是聊天机器人，按量付费肯定是不够的。

现在我用github学生包的heroku平台，注册要关闭adguard，需要绑定国外银行卡，绑卡时建议关闭梯子。

Paas部署注意点

端口号

注意一下项目的端口号设置,最好设置在环境变量中,然后在项目中通过 os.Getenv("xxx")来获取端口号.

支持go部署的paas中，环境变量 PORT 一般都默认8080，且为全局的。无需设置，直接调用就好了。

• 对于tgbot：官方示例中使用的8443端口，在部署到paas平台时8443端口需要确认是否开放。 我建议不要使用官方示例中把端口号写明的写法，通过环境变量 PORT 调用端口号，避免webhook创建失败，或者监听未开放的端口等问题。

tgbot证书问题

heroku和zeabur部署项目自带证书,做完域名映射可以直接https访问. 所以在设置webhook进行和tg服务器通讯的时候不需要手动加载 cert.pem 和 key.pem

在部署tg的bot时,可以修改tgbot官方对go语言搭建bot示例中的:

  ...

  log.Printf("Authorized on account %s", bot.Self.UserName)
  wh, _ := tgbotapi.NewWebhook(TG_WEBHOOK_URL + bot.Token)

  ...

  go http.ListenAndServe(":"+port, nil)

直接使用 NewWebhook和 ListenAndServe函数即可.

环境变量

在目前我的实现中，定义了四个环境变量

TG_WEBHOOK_URL=https://yousite.com/tgbot
BOT_TOKEN=your token
chatGPTAPIKey=sk-your key
ChatGPTURL_proxy = "https://your-proxy-site/v1"

ChatGPTURL_proxy="https://one-api.bltcy.top/v1"