chatgpt-on-wechat 配置教程
官方入口:CowAgent 官方项目
适用范围:仍使用 config.json 中 open_ai_api_key / open_ai_api_base 的 chatgpt-on-wechat 版本。CowAgent 新版入口按其 README。
版本与验证:2026-09-28 核对本文配置项、步骤和资料入口,补齐验证与排错说明。本文保留旧版配置范围,不代表 CowAgent 所有版本都接受这些字段。未在真实账号中验证付费模型调用。
配置速查
| 配置项 | 填写内容 | 注意事项 |
|---|---|---|
| open_ai_api_base | https://api.apizt.com/v1 | 对应 OpenAI 兼容聊天接口。 |
| open_ai_api_key | apizt API Key | 填在机器人运行机器的配置中。 |
| model | gpt-6-sol | 须为版本及当前分组支持的模型。 |
还没有 API Key?注册获取免费体验额度 · 已注册:进入控制台创建 API Key
为此工具单独创建令牌,并设置合理额度和模型权限。截图中的模型仅作示例,以账号当前可用模型为准;不要公开密钥或上传含密钥的配置文件。
第 1 步:确认配置版本
此文适用于仍使用 config.json 的 chatgpt-on-wechat 版本。当前项目以 CowAgent 名称维护;安装与频道授权按所下载发行版的 README,不把旧字段保证为新版格式。
第 2 步:修改机器人运行目录的配置
在已有 config.json 中修改以下三个字段,保留原来的 channel_type、触发前缀等频道设置,不用下面片段覆盖整个文件。
{
"open_ai_api_base": "https://api.apizt.com/v1",
"open_ai_api_key": "YOUR_tokenba_API_KEY",
"model": "gpt-6-sol"
}第 3 步:重启实际机器人进程
按当前部署方式重启机器人:前台运行、容器或服务管理器分别操作对应进程。查看启动输出,确认使用的工作目录与配置文件正是刚才修改的文件。
第 4 步:分开验证模型与频道
在目标频道按已配置的触发前缀发送一条短消息,先查模型请求日志,再查频道回复。模型调用成功但用户没收到回复时,检查频道登录、消息过滤和路由。
怎样确认配置已生效
- 机器人进程读取了刚修改的配置。
- 测试消息产生模型调用日志。
- 目标频道按触发前缀收到回复。
接入失败时逐项检查
| 现象 | 检查与处理 |
|---|---|
| 修改后仍使用旧 Key | 重启机器人进程,确认运行目录和配置文件一致。 |
| 模型调用成功但频道不回复 | 检查频道登录状态、触发前缀和消息路由。 |
| CowAgent 中找不到旧字段 | 按当前 CowAgent README 使用其新版配置,不把旧版 JSON 强行导入。 |
资料与下一步
遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID,联系支持时先隐藏 API Key。