ChatGPT-on-WeChat 接入指南

适用角色：开发者、部署管理员 更新日期：2026-08-06

ChatGPT-on-WeChat 当前配置模板提供 OpenAI Compatible 的 Key 和 Base URL 字段。建议先让项目在 Web 或终端渠道跑通，再配置微信相关能力，这样能把模型连接问题和消息渠道问题分开。

安装项目

git clone https://github.com/zhayujie/chatgpt-on-wechat
cd chatgpt-on-wechat
python -m pip install -r requirements.txt
cp config-template.json config.json

修改模型连接

在已有 config.json 中修改对应字段，不要用下面片段覆盖整份配置：

{
  "open_ai_api_key": "YOUR_API_KEY",
  "open_ai_api_base": "https://<接口地址>",
  "model": "deepseek-v4-flash"
}

open_ai_api_base 是当前项目模板使用的字段名。模型调用名从控制台复制。其余渠道、群聊、触发词和插件设置保留项目原配置。

以控制台「API Key」页展示的接口地址为准。

分阶段检查

启动后先通过项目提供的简单渠道发送一条消息，并查看控制台使用记录。模型调用正常后，再按项目官方文档配置微信渠道。

模型正常但微信收不到消息时，检查渠道登录、回调和会话限制；不要反复修改已经验证过的 API 地址和 Key。