把个人微信变成 AI 机器人！能私信、能管群，3分钟保姆级部署教程

摘要：想象一下，你的微信即使在睡觉时也能秒回朋友的消息，你的微信群里有一个无所不知的 AI 助手随时待命。今天我们介绍 GitHub 上的神级项目 chatgpt-on-wechat，教你利用虚拟机或个人电脑，把个人微信号接入 ChatGPT（或国内大模型），变身全能 AI 助理！

一、项目介绍

chatgpt-on-wechat 是 GitHub 上最火的微信 AI 项目之一（由 zhayujie 开发）。

它的核心功能非常强大且直接：

个人号变身：不需要申请复杂的企业微信或公众号，直接用你现在的个人微信号扫码登录即可。
私聊/群聊响应：支持好友私聊自动回复，也支持在微信群里 @它进行问答。
多模型支持：不仅支持 OpenAI (ChatGPT)，还支持百度文心一言、讯飞星火等国内模型（不用魔法也能玩）。

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

二、准备工作

在开始之前，你需要准备好运行环境。不论你是用云服务器，还是自家的旧电脑，都可以部署。

运行环境（二选一）：
- 方案 A（本地部署/测试）：你自己的 Windows/Mac 电脑（需安装 Docker Desktop），或者在电脑里装个 Linux 虚拟机（VMware/VirtualBox）。优点是免费，缺点是电脑关机机器人就下线了。
- 方案 B（云端部署/长期在线）：一台 Linux VPS。如果你追求机器人 7x24 小时稳定在线，云服务器是必须的。
  - VPS 推荐：对于这种服务，稳定性大于一切。预算充足的朋友可以考虑 搬瓦工 (BandwagonHost)，作为 VPS 界的“理财产品”，它的线路质量和稳定性是公认的行业标杆（懂的都懂）；当然，普通的廉价 VPS 也完全跑得动。
API Key：OpenAI 的 Key 或者国内大模型（文心、讯飞）的 Key。
微信号：⚠️ 高能预警：建议使用注册时间较长的小号，千万不要用主号！（因为微信官方对非官方客户端有风控风险）。

三、方法 A：Docker 安装 (最推荐，省心)

Docker 是最适合小白的方式，不用配置复杂的 Python 环境，一行命令搞定。
(注：以下命令基于Ubuntu系统，非Windows。)

1. 安装 Docker

VPS / Linux 虚拟机：直接运行这行命令（国内可能需要换源）：
```
curl -fsSL https://get.docker.com | bash
```
Windows / Mac 电脑：请去 Docker 官网下载安装 Docker Desktop 软件并启动。

2. 创建配置文件

我们需要创建一个文件夹，专门放配置文件，防止重启后数据丢失。

# Linux/Mac 命令行操作（Windows用户请手动新建文件夹）
mkdir -p /data/chatgpt
cd /data/chatgpt
touch config.json

3. 编辑配置 (关键)

使用 vim config.json 编辑配置文件，填入以下内容：

  # config.json 文件内容示例
{
  "channel_type": "web",                                      # 接入渠道类型，默认为web，支持修改为:terminal, wechatmp, wechatmp_service, wechatcom_app, dingtalk, feishu
  "model": "gpt-4o-mini",                                     # 模型名称, 支持 gpt-4o-mini, gpt-4.1, gpt-4o, deepseek-reasoner, wenxin, xunfei, glm-4, claude-3-7-sonnet-latest, moonshot等
  "open_ai_api_key": "YOUR API KEY",                          # 如果使用openAI模型则填入上面创建的 OpenAI API KEY
  "open_ai_api_base": "https://api.openai.com/v1",            # OpenAI接口代理地址，修改此项可接入第三方模型接口
  "proxy": "",                                                # 代理客户端的ip和端口，国内环境开启代理的需要填写该项，如 "127.0.0.1:7890"
  "single_chat_prefix": ["bot", "@bot"],                      # 私聊时文本需要包含该前缀才能触发机器人回复
  "single_chat_reply_prefix": "[bot] ",                       # 私聊时自动回复的前缀，用于区分真人
  "group_chat_prefix": ["@bot"],                              # 群聊时包含该前缀则会触发机器人回复
  "group_name_white_list": ["ChatGPT测试群", "ChatGPT测试群2"], # 开启自动回复的群名称列表
  "group_chat_in_one_session": ["ChatGPT测试群"],              # 支持会话上下文共享的群名称  
  "image_create_prefix": ["画", "看", "找"],                   # 开启图片回复的前缀
  "conversation_max_tokens": 1000,                            # 支持上下文记忆的最多字符数
  "speech_recognition": false,                                # 是否开启语音识别
  "group_speech_recognition": false,                          # 是否开启群组语音识别
  "voice_reply_voice": false,                                 # 是否使用语音回复语音
  "character_desc": "你是基于大语言模型的AI智能助手，旨在回答并解决人们的任何问题，并且可以使用多种语言与人交流。",  # 系统提示词
  # 订阅欢迎语，公众号和企业微信channel中使用，当被订阅时会自动回复以下内容
  "subscribe_msg": "感谢您的关注！\n这里是AI智能助手，可以自由对话。\n支持语音对话。\n支持图片输入。\n支持图片输出，画字开头的消息将按要求创作图片。\n支持tool、角色扮演和文字冒险等丰富的插件。\n输入{trigger_prefix}#help 查看详细指令。",
  "use_linkai": false,                                        # 是否使用LinkAI接口，默认关闭，设置为true后可对接LinkAI平台的智能体
  "linkai_api_key": "",                                       # LinkAI Api Key
  "linkai_app_code": ""                                       # LinkAI 应用或工作流的code
}

📝 配置说明（必读）：
open_ai_api_key: 填入你的 Key。
open_ai_api_base: 填入平台的接口地址。
proxy: 如果你的 VPS 是国内的，必须填代理地址；如果是海外 VPS（如香港/美国），留空即可。
single_chat_prefix: 私聊触发词。比如设置了 "bot"，别人发 "bot 你好" 才会回复。如果想每句都回，留空 [""]。
group_name_white_list: 开启群聊白名单。["ALL_GROUP"] 表示所有群都生效。

4. 启动容器

复制下面这行命令运行：

docker run -d --name wechat-ai \
  --restart always \
  -v /data/chatgpt/config.json:/app/config.json \
  zhayujie/chatgpt-on-wechat

注：Windows 用户请将 /data/chatgpt/config.json 替换为你本地文件的实际绝对路径。

5. 扫码登录

运行成功后，查看日志获取二维码：

docker logs -f wechat-ai

屏幕上会出现一个二维码，用手机微信扫码确认登录即可。

四、方法 B：源码部署 (适合开发者)

如果你想修改代码逻辑，或者不想用 Docker，可以用这种方法直接“克隆”代码运行。

1. 安装环境

确保你目前的运行环境安装了 Python 3.7 - 3.9

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

# 安装核心依赖 (推荐使用国内源加速)
pip3 install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/
pip3 install -r requirements-optional.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/

2. 复制并修改配置

项目里已经自带了一个模板，直接复制一份：

cp config-template.json config.json

然后编辑 config.json（配置参数参考上面的 Docker 部分）。

3. 运行程序

# 前台运行（测试用，关闭窗口会断开）
python3 app.py

# 后台静默运行（推荐）
nohup python3 app.py & tail -f nohup.out

运行后，同样会在终端显示二维码，扫码即可登录。

五、效果展示

登录成功后，你的微信就变成了 AI 机器人：

私聊：朋友发消息给你：它会自动回复。

六、常见问题与风险提示 (Q&A)

Q1: 如何更换成国内大模型（文心/讯飞）？
A: 在 config.json 中，将 model 字段改为 xunfei 或 wenxin，并填写对应的 app_id 和 api_secret 即可。

Q2: 会封号吗？
A: ⚠️ 极度重要！ 任何非官方客户端都有封号风险。

绝对不要使用你的主力生活号！
绝对不要用来发送广告或垃圾信息！
建议仅用于技术研究和小范围群聊娱乐。

七、总结

chatgpt-on-wechat 是目前接入微信最简单、生态最完善的开源项目。通过它，你可以把闲置的 VPS 或虚拟机变成一个 24 小时在线的 AI 助理。

无论你是想在群里活跃气氛，还是给自己做一个私人知识库，它都能完美胜任。快去试试吧！

版权声明：本文由 赛博61区 原创发布，转载请注明出处。
项目地址：GitHub - chatgpt-on-wechat

把个人微信变成 AI 机器人！能私信、能管群，3分钟保姆级部署教程

一、 项目介绍

二、 准备工作

三、 方法 A：Docker 安装 (最推荐，省心)