aiwechat-vercel

使用vercel的functions，将ai功能加入微信公众号

介绍

无需服务器，门槛低，只需一个可以绑定到vercel的域名(无需备案)即可，基本0成本

快速开始

• 提前到Vercel创建Redis数据库

  • Dashboard--Storage--Create--KV Redis

• Fork本Github项目，到Vercel点击构建,环境变量填写参数

• 在vercel该项目详情页面的Storage选择连接前面创建的redis数据库

  • 数据库链接成功后，Vercel会自动配置KV_URL环境变量

数据库配置详情

图片步骤:

更多配置config

GPT_TOKEN=sk-*** 你的gpt token
GPT_URL=https://xxx/v1  代理gpt服务器(选填，默认openai官网api 例如https://api.openai.com/v1)
gptModel=gpt-3.5-turbo gpt模型(选填,默认gpt-3.5-turbo)
WX_TOKEN=*** 微信公众号开发平台设置的token
botType=** 机器人类型 目前支持(gpt,echo,spark,qwen,gemini)例如botType=gpt

如何检查是否配置成功

部署后访问 vercel提供的域名/api/check 页面返回check ok即可

到域名提供商，域名增加cname解析到cname-china.vercel-dns.com

到vercel的该项目添加自定义域名(使用国内网络在访问你的域名/api/check看看能否访问)

微信公众号配置:

微信公众号。微信公众平台后台管理页面上找到设置与开发-基本配置-服务器配置，修改服务器地址url为https://你的域名/api/wx 消息加解密选择明文模式(后续添加支持加密)

录制了一期简单的视频教程供参考b站

也有大佬写了自己在cloudflare部署的教程discussions

功能支持

1. 支持接入gpt,星火,通义千问,gemini
2. 超时回复(go协程很好用)
3. 支持连续问答(只需要在vercel创建一个redis实例，在本项目下的Storage设置连接即可，vercel会自动配置KV_URL环境变量，默认记忆对话30分钟内的内容)
4. 隐藏功能 你的域名/api/chat?msg=你的问题 (仅用于测试是否配置gpt成功,也可用作于简单的接口api,中文乱码问题已修复)
5. 检查配置：你的域名/api/check （显示当前bot的配置信息是否正确）
6. 支持图床功能，即发送图片给公众号，返回图片url
7. 被关注自定义回复
8. 支持设置system prompt
9. 支持指令

指令支持

1. /help：查看帮助

2. /gpt：切换与GPT对话

3. /spark：切换与星火对话

4. /qwen：切换与通义千问对话

5. /gemini：切换与gemini对话

6. /prompt: 你的prompt: 设置system prompt

7. /getpt: 获取当前设置prompt

8. /cpt: 清除当前设置prompt

9. /setmodel model_name:设置当前bot使用的模型

10. /setmodel:重置当前bot的模型为默认值

11. /getmodel:获取当前bot自定义的模型名

12. /clear:清除对话列表

13. /keyword：切换到关键词回复模式

14. /ai：切换到AI对话模式

15. /addkeyword 关键词:回复内容：添加关键词

16. /delkeyword 关键词：删除关键词

17. /listkeywords：查看关键词列表

有其它想要支持的指令欢迎提issue或者pr (例如查看天气啥的)

后续计划添加指令

1. /fy: 翻译文本
2. /wec: 查看天气
3. todolist管理： /ta: 添加待办事项 /td: 删除待办事项 /tl: 查看待办事项列表

后续

• 支持国内大部分可以白嫖的ai 如星火(已支持，感谢大佬pr)，通义千问(已支持，感谢大佬pr)等(有想要添加的可以提个issue)
• 增加指令控制(已支持)，增加管理员设置
• 关键词自定义回复
• 支持限制问答次数
• 支持企业微信群机器人
• todolist功能，用户可以在机器人管理待办事件
• 查看股票和币价

杂念

项目起因:偶然看到网上有人使用vercel实现了,但是功能比较单一，看了一下文档，支持go所以就想自己开发下，支持接入多一点ai和自定义功能，项目仅供学习参考 也欢迎各位大佬pr,来个免费的star

问题汇总

1. 为啥要使用域名? 答: vercel提供的域名国内被墙了，微信无法访问
2. 为啥有时候可以回复，有时候没有回复？答: 微信公众号限制答复500多字，超过回复会失败，可以增加限制字数的提示词解决。还有一个原因是答复太久，接口超时了免费版vercel的functions限制接口10s
3. 域名需要备案吗?答:不需要，另外也可以在cloudflare托管域名(白嫖一些2级域名，托管上去，可以达到0成本)
4. 我的是订阅号支持吗?答:无论是公众号还是订阅号,自动回复都是一个机制，所以都支持
5. 发送信息返回错误error, status code: 403, message: invalid character '<' looking for beginning of value怎么回事?答:检查GPT_URL是不是漏了/v1或者cf开了盾，墙之类的
6. 支持接入deepseek吗?答:支持，不过有一点要注意deepseek支持的模型为deepseek-coder，deepseek-chat要正常使用，需要改gptModel为这两个模型之一
7. 修改环境变量后，还是不成功?答:在修改环境变量后要重新部署下配置才后生效，因为vercel原来的实例没有被销毁读取的还是未修改的环境变量。建议每次修改环境变量后手动重新部署一下
8. 微信字数限制如何解决?答:已经有大佬提pr了，可以通过设置最大token解决，设置环境变量maxOutput即可，一般设置到500，回答没有完整可以和ai说继续即可，pr详情pr

更多功能探讨discussions

Star History

项目灵感来源

spark-wechat-vercel

aiwechat-vercel 快速上手指南

本指南将帮助你使用 Vercel Serverless Functions 零成本部署一个支持多模型（GPT、星火、通义千问等）的微信公众号机器人。

环境准备

在开始之前，请确保你拥有以下账号和资源：

• GitHub 账号：用于 Fork 项目源码。
• Vercel 账号：用于部署应用和创建数据库。
• 微信公众号：服务号或订阅号均可（需能配置服务器地址）。
• 域名：
  • 必须项：一个可解析的域名（无需备案）。
  • 原因：Vercel 默认提供的 .vercel.app 域名在国内无法被微信访问，必须绑定自定义域名并解析到 cname-china.vercel-dns.com。
• AI 接口密钥：如 OpenAI Token、讯飞星火 Key 等。

安装与部署步骤

1. 创建 Redis 数据库 (Vercel KV)

上下文记忆功能依赖 Redis，需在 Vercel 中预先创建：

1. 登录 Vercel Dashboard。
2. 进入 Storage 页面，点击 Create。
3. 选择 KV Redis，按提示完成创建（名称随意，区域建议选近节点）。

2. Fork 项目并部署

1. 访问 aiwechat-vercel GitHub 仓库。
2. 点击右上角 Fork 将项目复制到你的账号下。
3. 登录 Vercel，点击 Add New... -> Project。
4. 导入你刚才 Fork 的 aiwechat-vercel 项目。
5. 在 Configure Project 页面，填写以下环境变量（点击 "Environment Variables" 展开）：

GPT_TOKEN=sk-你的 API Token
GPT_URL=https://api.openai.com/v1 
# 若使用国内代理或其他模型，请修改此处，例如：https://spark-api.xf-yun.com/v1
gptModel=gpt-3.5-turbo
# 可选模型：gpt-3.5-turbo, spark, qwen, gemini 等
botType=gpt
WX_TOKEN=你的微信公众号Token

6. 点击 Deploy 开始构建。

3. 连接数据库

1. 部署完成后，进入该项目在 Vercel 的详情页面。
2. 点击左侧菜单的 Storage。
3. 点击 Connect Database，选择第 1 步中创建的 KV Redis 实例。
   • 注：连接成功后，Vercel 会自动注入 KV_URL 环境变量，无需手动配置。

4. 配置自定义域名

由于微信无法访问 Vercel 默认域名，必须绑定自定义域名：

1. 域名解析：在你的域名服务商处添加一条 CNAME 记录：
   • 主机记录：@ 或 www (根据你的需求)
   • 记录值：cname-china.vercel-dns.com
2. Vercel 绑定：
   • 在 Vercel 项目详情页 -> Settings -> Domains。
   • 输入你的域名并添加。
3. 验证：等待 DNS 生效后，访问 https://你的域名/api/check，若返回 check ok 则说明后端服务正常。

5. 配置微信公众号

1. 登录 微信公众平台。
2. 进入 设置与开发 -> 基本配置 -> 服务器配置。
3. 填写如下信息：
   • URL: https://你的域名/api/wx
   • Token: 填写你在环境变量中设置的 WX_TOKEN (必须一致)
   • 消息加解密方式: 选择 明文模式
4. 点击 提交，验证成功后即可启用服务器。

基本使用

部署完成后，你可以通过以下方式测试和使用机器人：

1. 在线测试接口

在浏览器直接访问以下地址测试 AI 连通性（替换为你的域名和问题）：

https://你的域名/api/chat?msg=你好

如果返回正常的文本回复，说明 AI 接口配置成功。

2. 微信公众号对话

在微信公众号后台发送消息，即可触发自动回复。

常用指令示例：

• 查看帮助：发送 /help
• 切换模型：发送 /gpt 或 /spark 或 /qwen
• 设置系统提示词：发送 /prompt: 你是一个专业的翻译助手
• 清除对话记忆：发送 /clear
• 关键词回复模式：发送 /keyword 开启，随后用 /addkeyword 你好:欢迎到来 添加规则。

3. 图片处理

直接发送图片给公众号，机器人将返回该图片的 URL 地址（图床功能）。