ChatGPT-on-WeChat 部署教程：打造你的私人AI微信助手

📌 前言

ChatGPT-on-WeChat 是一个非常火的开源项目，可以把 ChatGPT、Claude、Gemini、DeepSeek 等大模型接入微信，打造你的私人 AI 助手。本文将手把手教你完成部署。

项目地址：https://github.com/zhayujie/chatgpt-on-wechat

🎯 支持的功能

• ✅ 多种大模型：OpenAI、Claude、Gemini、DeepSeek、通义千问、文心一言等
• ✅ 多种接入渠道：个人微信、企业微信、公众号、飞书、钉钉
• ✅ 支持文字、语音、图片对话
• ✅ 插件系统，可扩展功能
• ✅ 上下文记忆
• ✅ 支持 Docker 一键部署

🛠️ 准备工作

1. 服务器要求

• Linux 服务器（推荐 Ubuntu 22.04）
• 最低配置：1核 1G 内存
• 推荐配置：2核 2G 内存
• 需要安装 Docker（推荐）或 Python 3.8+

2. 获取 API Key

根据你想使用的模型，获取对应的 API Key：

• OpenAI：https://platform.openai.com/api-keys
• DeepSeek：https://platform.deepseek.com/
• 通义千问：https://dashscope.console.aliyun.com/

🐳 方式一：Docker 部署（推荐）

1. 安装 Docker

# 一键安装 Docker
curl -fsSL https://get.docker.com | sh

# 启动 Docker
systemctl start docker
systemctl enable docker

# 验证安装
docker --version

2. 拉取项目

# 克隆项目
git clone https://github.com/zhayujie/chatgpt-on-wechat.git
cd chatgpt-on-wechat

# 复制配置文件
cp config-template.json config.json

3. 编辑配置文件

vim config.json

配置文件示例（使用 OpenAI）：

{
  "model": "gpt-4o-mini",
  "open_ai_api_key": "sk-xxxxxxxxxxxxxxxx",
  "open_ai_api_base": "https://api.openai.com/v1",
  "proxy": "",
  "single_chat_prefix": [""],
  "single_chat_reply_prefix": "",
  "group_chat_prefix": ["@bot"],
  "group_name_white_list": ["ALL_GROUP"],
  "image_create_prefix": ["画"],
  "conversation_max_tokens": 2500,
  "character_desc": "你是一个智能助手，可以回答各种问题。",
  "temperature": 0.7,
  "subscribe_msg": "感谢关注！发送任意消息开始对话。"
}

配置文件示例（使用 DeepSeek，便宜好用）：

{
  "model": "deepseek-chat",
  "open_ai_api_key": "sk-xxxxxxxxxxxxxxxx",
  "open_ai_api_base": "https://api.deepseek.com/v1",
  "proxy": "",
  "single_chat_prefix": [""],
  "single_chat_reply_prefix": "",
  "group_chat_prefix": ["@bot"],
  "group_name_white_list": ["ALL_GROUP"],
  "conversation_max_tokens": 2500,
  "character_desc": "你是一个智能助手。",
  "temperature": 0.7
}

4. 启动容器

# 构建并启动
docker compose up -d

# 查看日志
docker compose logs -f

5. 扫码登录

启动后，终端会显示一个二维码，用微信扫码登录即可。

# 如果看不到二维码，可以查看日志
docker compose logs -f

# 或者查看二维码图片
ls -la *.png

🐍 方式二：Python 直接部署

1. 安装 Python 环境

# Ubuntu/Debian
sudo apt update
sudo apt install python3 python3-pip python3-venv -y

# 验证版本（需要 3.8+）
python3 --version

2. 克隆项目并安装依赖

# 克隆项目
git clone https://github.com/zhayujie/chatgpt-on-wechat.git
cd chatgpt-on-wechat

# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt
pip install -r requirements-optional.txt  # 可选依赖

3. 配置并启动

# 复制配置文件
cp config-template.json config.json

# 编辑配置（参考上面的配置示例）
vim config.json

# 启动
python3 app.py

4. 后台运行

# 使用 nohup 后台运行
nohup python3 app.py > output.log 2>&1 &

# 或者使用 screen
screen -S wechat
python3 app.py
# Ctrl+A+D 分离会话

# 重新连接
screen -r wechat

⚙️ 常用配置说明

配置项	说明
model	使用的模型，如 gpt-4o-mini、deepseek-chat
open_ai_api_key	API 密钥
open_ai_api_base	API 地址，可用于配置代理或其他兼容 API
single_chat_prefix	私聊触发前缀，设为 [""] 表示所有消息都触发
group_chat_prefix	群聊触发前缀，如 ["@bot"]
group_name_white_list	群聊白名单，ALL_GROUP 表示所有群
character_desc	机器人人设描述
conversation_max_tokens	上下文最大 token 数
temperature	回复随机性，0-1，越大越随机

🔌 插件配置

项目支持丰富的插件系统，常用插件：

启用插件

# 在 config.json 中添加插件配置
{
  "plugin_trigger_prefix": "$",
  "plugins": {
    "godcmd": {
      "enabled": true,
      "admin_users": ["your_wechat_id"]
    },
    "keyword": {
      "enabled": true
    },
    "role": {
      "enabled": true
    }
  }
}

常用插件命令

• $help - 查看帮助
• $reset - 重置对话
• $plugin list - 查看插件列表
• $plugin enable xxx - 启用插件

🔧 常见问题

1. 扫码登录失败

• 确保微信号已实名认证
• 新注册的微信号可能被限制，建议使用老号
• 尝试更换 itchat-uos 版本

2. API 调用失败

• 检查 API Key 是否正确
• 检查 API Base URL 是否正确
• 如果是 OpenAI，检查是否需要配置代理

3. 掉线问题

# 使用进程管理工具保持运行
# 安装 supervisor
apt install supervisor -y

# 创建配置文件
cat > /etc/supervisor/conf.d/wechat.conf << EOF
[program:wechat]
command=/path/to/venv/bin/python /path/to/chatgpt-on-wechat/app.py
directory=/path/to/chatgpt-on-wechat
user=root
autostart=true
autorestart=true
stderr_logfile=/var/log/wechat.err.log
stdout_logfile=/var/log/wechat.out.log
EOF

# 重载配置
supervisorctl reread
supervisorctl update
supervisorctl start wechat

💰 成本参考

模型	价格（每百万 token）	推荐场景
DeepSeek-Chat	￥1-2	日常对话，性价比最高
GPT-4o-mini	$0.15	英文对话，便宜好用
GPT-4o	$5	复杂任务
Claude-3.5-Sonnet	$3	长文本、代码

🎯 总结

ChatGPT-on-WeChat 是一个非常实用的开源项目，部署简单，功能强大。推荐配合 DeepSeek API 使用，成本低效果好。

部署流程总结：

1. 准备服务器，安装 Docker
2. 克隆项目，配置 config.json
3. docker compose up -d 启动
4. 扫码登录微信
5. 开始享受你的 AI 助手！

💡 收藏本文，有问题随时回来查看！