【2025最新】chatgpt-on-wechat配置API完全指南 — 从环境搭建到API配置，全程图文教程，让你轻松在微信中接入ChatGPT！
chatgpt-on-wechat是一个优秀的开源项目，可以让你在微信中接入ChatGPT，实现智能聊天机器人功能。但很多用户在API配置环节遇到困难。本教程将手把手教你如何正确配置chatgpt-on-wechat的API，让你的微信机器人顺利运行。
如果你需要稳定可靠的ChatGPT API密钥，可以访问简易API中转站获取专业服务。
chatgpt-on-wechat是一个基于ChatGPT的微信聊天机器人，通过调用API实现在微信中与ChatGPT对话的功能。
主要功能特点：
为什么需要配置API？ chatgpt-on-wechat需要通过API连接到ChatGPT服务，才能实现智能对话功能。没有正确配置的API，机器人将无法正常工作。
在配置API前，首先需要搭建好基础环境并安装chatgpt-on-wechat：
使用Git克隆项目到本地：
git clone https://github.com/zhayujie/chatgpt-on-wechat.git
cd chatgpt-on-wechat
安装项目所需的Python依赖包：
pip install -r requirements.txt
注意：如果你使用的是国内网络环境，可能需要设置pip镜像源以加速下载：
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
复制配置文件模板并重命名：
cp config-template.json config.json
Windows系统可以直接复制config-template.json文件并重命名为config.json。
以下是配置chatgpt-on-wechat API的详细步骤：
首先，你需要获取一个有效的ChatGPT API密钥。推荐从简易API中转站获取，他们提供稳定、低延迟、价格合理的API服务，专为中国用户优化。
使用文本编辑器（如VS Code、Notepad++等）打开config.json文件，找到以下部分：
"channel_type": "wx",
"model": "gpt-3.5-turbo",
"open_ai_api_key": "",
"open_ai_api_base": "https://api.openai.com/v1",
将你从简易API中转站获取的API密钥填入配置文件：
"open_ai_api_key": "你的API密钥",
"open_ai_api_base": "https://api.jeniya.cn/v1",
注意：如果你使用的是简易API中转站的服务，需要将api_base修改为他们提供的地址。
根据需要，你可以调整以下参数：
"model": "gpt-3.5-turbo", // 可选gpt-3.5-turbo、gpt-4等
"temperature": 0.7, // 控制回答的随机性，0-1之间
"max_tokens": 2000, // 单次回复最大token数
"proxy": "", // 如需代理，填入代理地址
如果你希望在群聊中只有特定前缀的消息才触发机器人，可以设置：
"group_chat_prefix": ["@ChatGPT", "!gpt", "#chat"],
"single_chat_prefix": [""], // 空数组表示私聊中无需前缀
完成编辑后，保存config.json文件。确保JSON格式正确，没有语法错误。
配置示例：
{
"channel_type": "wx",
"model": "gpt-3.5-turbo",
"open_ai_api_key": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
"open_ai_api_base": "https://api.jeniya.cn/v1",
"proxy": "",
"single_chat_prefix": [""],
"group_chat_prefix": ["@ChatGPT", "!gpt"],
"single_chat_reply_prefix": "",
"group_chat_reply_prefix": "",
"temperature": 0.7,
"max_tokens": 2000,
"conversation_max_tokens": 3000,
"character_desc": "你是ChatGPT，一个由OpenAI训练的大型语言模型，你旨在回答并解决人们的任何问题，并且可以使用多种语言与人交流。"
}
完成API配置后，接下来需要启动程序并登录微信：
在项目根目录下运行：
python app.py
程序启动后，会弹出一个二维码（或在控制台显示二维码链接），使用你的微信扫码登录。
注意：首次登录时，可能会提示"微信登录异常"，这是正常的，按照提示在手机上确认即可。
登录成功后，可以通过以下方式测试API配置是否正确：
可能原因及解决方案：
优化方法：
解决方法：
排查步骤：
使用简易API中转站的API服务可以有效控制成本：
通过修改config.json中的character_desc字段，可以自定义机器人的人格：
"character_desc": "你是一位专业的心理咨询师，擅长倾听和提供心理建议，语气温和，回答简洁明了。"
可以设置指令前缀，实现在不同模型间切换：
"model_commands": {
"#gpt3": "gpt-3.5-turbo",
"#gpt4": "gpt-4"
}
这样，用户发送"#gpt4 你好"时，会使用GPT-4模型回复。
如果你使用的API支持图像识别（如GPT-4 Vision），可以启用图像识别功能：
"vision": {
"enable": true,
"model": "gpt-4-vision-preview"
}
在Linux/Mac系统上，可以使用nohup命令将程序部署为后台服务：
nohup python app.py > chatgpt.log 2>&1 &
Windows系统可以创建批处理文件或使用第三方工具如PM2。
项目支持Docker部署，可以使用以下命令：
# 构建Docker镜像
docker build -t chatgpt-on-wechat .
# 运行容器
docker run -d --name chatgpt-wechat -v $(pwd)/config.json:/app/config.json chatgpt-on-wechat
简易API中转站是专为中国用户打造的ChatGPT API服务平台，与chatgpt-on-wechat完美兼容：
"使用简易API中转站的API后，我的微信机器人响应速度提升了3倍，用户体验大大改善。" - 王先生，科技博主
"简易API中转站的价格确实实惠，同样的使用量，比官方API便宜了近40%。最重要的是稳定性好，几乎没有连接失败的情况。" - 李女士，企业微信管理员
按照本教程配置好API后，你就可以拥有一个功能强大的微信ChatGPT机器人！
需要高质量、稳定、价格合理的API服务，请访问https://jeniya.cn/，新用户注册即送免费测试额度！
如果本教程对您有所帮助，欢迎收藏本页面并分享给更多chatgpt-on-wechat用户！
chatgpt-on-wechat支持语音消息识别和语音回复功能，需要额外配置：
"speech_recognition": {
"enable": true,
"engine": "openai", // 或使用"azure"
"openai_api_key": "与chat相同的API密钥",
"openai_api_base": "https://api.jeniya.cn/v1"
},
"text_to_speech": {
"enable": true,
"engine": "openai", // 或使用"azure"、"google"
"openai_api_key": "与chat相同的API密钥",
"openai_api_base": "https://api.jeniya.cn/v1"
}
配置后，用户可以发送语音消息，机器人会识别后回复，也可以让机器人以语音形式回复。
chatgpt-on-wechat有丰富的插件系统，可以在config.json中启用：
"plugins": [
"plugin_hello", // 简单的示例插件
"plugin_summarize", // 总结插件
"plugin_role", // 角色扮演插件
"plugin_search" // 网络搜索插件
]
要使用搜索插件，还需要额外配置搜索引擎API：
"plugin_search": {
"engine": "google", // 或使用"bing"
"api_key": "你的搜索引擎API密钥",
"cx_id": "你的Google自定义搜索引擎ID" // 仅Google搜索需要
}
如果你需要同时管理多个微信机器人账号，可以创建多个配置文件：
# 创建不同的配置文件
cp config.json config_account1.json
cp config.json config_account2.json
# 启动时指定配置文件
python app.py --config config_account1.json
为了避免生成不适当的内容，可以配置敏感词过滤：
"sensitive_word_filter": {
"enable": true,
"words": ["敏感词1", "敏感词2", "敏感词3"],
"action": "ignore" // 可选"ignore"(忽略请求)或"replace"(替换敏感词)
}
可以为机器人回复设置固定前缀，使回复更个性化：
"single_chat_reply_prefix": "[AI助手] ",
"group_chat_reply_prefix": "[ChatGPT回复] "
chatgpt-on-wechat会在logs目录下生成日志文件，可以通过查看日志排查问题：
# 查看最新日志
tail -f logs/chatgpt.log
日志级别可以在config.json中配置：
"log_level": "info" // 可选debug, info, warning, error
为了保持长期稳定运行，可以设置定时重启策略：
# Linux/Mac系统可以使用crontab
# 编辑crontab
crontab -e
# 添加以下内容（每天凌晨4点重启）
0 4 * * * cd /path/to/chatgpt-on-wechat && pkill -f app.py && sleep 5 && nohup python app.py > chatgpt.log 2>&1 &
长时间运行可能导致内存占用增加，可以通过以下方式优化：
定期更新chatgpt-on-wechat可以获得新功能和bug修复：
# 备份配置文件
cp config.json config.json.bak
# 拉取最新代码
git pull
# 更新依赖
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
# 恢复配置（如有冲突，需手动合并）
cp config.json.bak config.json
保护你的chatgpt-on-wechat服务器和API密钥安全：
将chatgpt-on-wechat配置为个人助手，推荐设置：
"character_desc": "你是我的个人助手，帮我回答问题、提供建议、管理日程和总结信息。请用简洁友好的语气回复，回答要精确且有帮助。",
"conversation_max_tokens": 4000, // 保持较长的对话历史
"single_chat_prefix": [""], // 无需前缀直接对话
"temperature": 0.5 // 平衡创意与准确性
将chatgpt-on-wechat配置为群聊知识库，推荐设置：
"character_desc": "你是一个知识渊博的助手，专长于提供准确、全面的知识解答。回答要客观、中立，并尽可能提供可靠的信息来源。",
"group_chat_prefix": ["@AI", "!问题"], // 使用前缀触发
"group_chat_reply_prefix": "[知识库回复] ", // 添加回复前缀
"plugins": ["plugin_search"] // 启用搜索插件增强回答准确性
将chatgpt-on-wechat配置为企业客服，推荐设置：
"character_desc": "你是XXX公司的客服助手，熟悉公司的产品、服务和政策。你的回答应专业、礼貌且有帮助。对于你不确定的问题，请建议用户联系人工客服。",
"temperature": 0.3, // 保持回答的一致性和准确性
"sensitive_word_filter": {
"enable": true,
"words": ["竞争对手名称", "敏感词"],
"action": "replace"
}
将chatgpt-on-wechat配置为教育辅导助手，推荐设置：
"character_desc": "你是一位耐心的教育辅导老师，擅长解释复杂概念，引导学生思考。回答问题时，先给出思路，再给出答案，鼓励学生独立思考。",
"plugins": ["plugin_role", "plugin_summarize"], // 启用角色扮演和总结插件
"max_tokens": 2500, // 允许较长的解释
"temperature": 0.6 // 平衡创意与准确性
ChatGPT API按token计费，1个token大约相当于0.75个英文单词或1.5-2个汉字：
通过优化提示词和系统设置，可以减少token消耗：
在config.json中设置使用限额，防止意外超支：
"usage_limit": {
"enable": true,
"max_tokens_per_day": 100000, // 每日最大token用量
"max_tokens_per_conversation": 2000, // 每次对话最大token用量
"max_conversations_per_day": 100 // 每日最大对话次数
}
简易API中转站提供了多种价格方案，可以根据需求选择：
新用户注册即送免费测试额度，可以先体验再决定是否购买。
成功配置chatgpt-on-wechat的关键步骤：
| 问题 | 解决方案 |
|---|---|
| API连接失败 | 检查API密钥和API地址是否正确 |
| 微信登录失败 | 尝试使用常用设备登录，避免频繁登录 |
| 响应速度慢 | 使用简易API中转站的国内优化API，减少延迟 |
| 内存占用高 | 设置合理的conversation_max_tokens，定期清理会话 |
| 回复质量不佳 | 优化character_desc，调整temperature参数 |
成功配置chatgpt-on-wechat后，建议：
通过简易API中转站获取稳定、经济的API服务，让你的微信ChatGPT机器人更加智能高效！
如果本教程对您有所帮助，欢迎收藏和分享！祝您使用愉快！