项目地址：https://github.com/zhayujie/chatgpt-on-wechat?tab=readme-ov-file

快速开始

本节内容暂时不看各种复杂特性，首先提供一个能快速运行最小可用版本的指引，目标是能搭建起能在私聊和群聊中自动回复的聊天机器人。整个过程很简单，只需要 注册OpenAI 账号 和 运行程序 两步。

一、准备​

项目默认使用 OpenAI接口 进行对话，需前往 OpenAI注册页面 创建账号，创建完账号则前往 API管理页面 创建一个 API Key 并保存下来，后面需要在项目中配置这个key。接口需要海外网络访问及绑定信用卡支付。

注意

  1. 账号注册过程需要网络代理，如果openai页面显示 Access denied， 要看下你的代理地区是否在openai的服务范围内，不能是香港、澳门等地区。

  2. 项目使用的是 OpenAI 平台提供的 API，ChatGPT网页端 可以对话并不代表有api的使用额度，需要在 额度查询 页面查看是否有额度

注: 项目同时也支持使用 LinkAI 接口，国内及海外网络环境均可使用，可使用 文心、讯飞、GPT-3、GPT-4 等模型，支持 定制化知识库、联网搜索、MJ绘图、文档总结和对话等能力。修改配置即可一键切换，参考 LinkAI接入文档。

二、运行​

代码仓库： https://github.com/zhayujie/chatgpt-on-wechat

1.方案对比​

有4种运行程序的方式供你选择：

运行方式

需要的资源

优势

劣势

Docker部署

服务器 + docker环境

不用关心python环境和依赖

插件配置稍麻烦

本地运行

个人机器 + 本地代理 + python环境

方便本地代码调试

不适合长时间稳定运行

服务器部署

服务器 + python环境

方便配置和源码修改、稳定运行

需要简单的linux基础

Railway部署

一个超过半年的github账号

一键部署

免费额度有限，插件等高级功能使用不便

注意： 除了railway，其他三种方式都需要保证能够访问openai接口，可以通过执行 ping api.openai.com 来判断网络是否可用，如果无法 ping通 则需要代理或国外服务器环境。

2.程序部署​

  • Docker部署

  • 本地运行

  • 服务器部署

  • RailWay部署

提示

使用docker部署无需下载源码和安装依赖，只需要拉取镜像并根据 docker-compose.yml 配置文件启动容器即可。

前提是安装好 docker 及 docker-compose，安装成功的表现是执行 docker -v 和 docker compose version (或 docker-compose version) 可以查看到版本号，可前往 docker官网 进行下载。

(1) 配置 docker-compose.yml​

执行以下命令下载 docker-compose.yml：

wget https://open-1317903499.cos.ap-guangzhou.myqcloud.com/docker-compose.yml

接着打开文件，修改或添加所需的配置，如 OPEN_AI_API_KEY 和 GROUP_NAME_WHITE_LIST 等必填配置，其他配置参考 配置说明。

(2) 启动容器​

在 docker-compose.yml 所在目录下执行以下命令启动容器：

sudo docker compose up -d

运行 sudo docker ps 能查看到 NAMES 为 chatgpt-on-wechat 的容器即表示运行成功。

提示

  • 如果 docker-compose 是 1.X 版本 则需要执行 sudo docker-compose up -d 来启动容器

  • 该命令会自动去 docker hub 拉取 latest 版本的镜像，latest 镜像会在每次项目 release 新的版本时生成

最后运行以下命令可查看容器运行日志，扫描日志中的二维码即可完成登录：

sudo docker logs -f chatgpt-on-wechat

(3) 停止容器​

执行以下命令可以关闭服务：

sudo docker compose down

注意：如果修改了 docker-compose.yml 中的配置，需要关闭容器后再重新启动才能生效，只执行 docker restart 是不起作用的。

三、使用​

成功运行之后日志中会输出 "Start auto replying"，这表示你用于扫码登录的账号已经变身为机器人了，让你的好友给你发消息 或在群聊@你 都会触发自动回复，效果如下图：


常见问题

  1. 如果发送消息没有回复，对于私聊场景确认下消息是否携带了触发词，对应配置 single_chat_prefix，对于群聊场景要确认该群名称是否配置在群组白名单 (group_name_white_list) 中。

  2. 如果机器人回复 "我现在有点累了" 或 "我连接不到你的网络" 等，一般是访问openAI接口失败，需查看日志中的具体报错信息来定位，可能是网络不通、openAI账号额度不足、访问频率超限等原因。

  3. 可能存在一定账号被限制的风险，建议仅用于技术研究或娱乐，不要过高频率使用。

常见问题查看 FAQs，或直接与 在线项目小助手 对话。

相关网页介绍：

【微信接入AI 机器人方法大全，全网最细教程】 https://www.bilibili.com/video/BV1UJ4m1u7Ay/?share_source=copy_web&vd_source=4f51c8273d19088bce3246e9903bdd60

【教你把微信接入AI～【附一键整合包】】 https://www.bilibili.com/video/BV1Wx4y1s7Hq/?share_source=copy_web&vd_source=4f51c8273d19088bce3246e9903bdd60