介绍：

运行环境：

1. 支持 Linux、MacOS、Windows 系统（可在Linux服务器上长期运行)，同时需安装Python。

2. 建议Python版本在 3.7.1~3.9.X 之间，3.10及以上版本在 MacOS 可用，其他系统上不确定能否正常运行

一，环境安装：

安装方式：

1. WINDOWS系统上安装虚拟机，LINUX运行在虚拟机上-需要安装代理软件，如：clash-for-linux；

2. 软路由ESXI系统上安装虚拟机，LINUX运行在虚拟机上-无需代理（软路由已实现）；

3. VPS（国外远程服务器）远程部署安装-无需代理

实例1：在Rocky Linux 8/AlmaLinux 8上安装Python 3.9：

1. 对于新项目和从Python 2.x迁移现有项目，建议使用Python 3。AppStream存储库中提供了不同版本的Python 3包，可以使用以下命令进行检查：

$ sudo dnf module list | grep -i python

1. 通常情况下，会返回python27、python36、python38、python39选择，如下截图：

1. 将模块版本传递给dnf命令，例如要安装Python 3.9，运行以下命令：

$ sudo dnf install python3.9 -y

1. 在系统上安装Python3后，使用下面的命令在交互式shell中使用它：

#检查python3
$ python3.9

Python 3.9.13 (main, Nov 16 2022, 10:51:39)
[GCC 8.5.0 20210514 (Red Hat 8.5.0-15)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>>
# 输出上面内容之后，按键盘ctr+d 或ctr+d退出

1. 将Python 3设置为默认值:

#默认Python 3
$ sudo alternatives --set python /usr/bin/python3

#默认Python 3.9
$ sudo alternatives --set python /usr/bin/python3.9
$ sudo alternatives --set python3 /usr/bin/python3.9

1. 使用此处给出的命令验证您的设置：

$ python -V
Python 3.9.13

$ python3 -V
Python 3.9.13

实例2：Linux Centos7安装python3.7：

1. 检查一下原来python的版本和是否有gcc：

[root@loaclhost ~]# python --version     ##检查python版本
Python 2.7.5                             ##显示版本号
[root@loaclhost ~]# gcc --version        ##检查gcc版本
-bash: gcc: 未找到命令                    ##未安装gcc
[root@loaclhost ~]# yum -y install gcc   ##安装gcc

1. python3.7以上版本，安装依赖包:libffi-devel：

yum install gcc patch libffi-devel python-devel zlib-devel bzip2-devel openssl-devel ncurses-devel sqlite-devel readline-devel tk-devel gdbm-devel db4-devel libpcap-devel xz-devel -y

1. wget下载python3.7.10, 也可以手动下载，下载地址:https://www.python.org/downloads/

#安装wget
$ yum install wget -y

#wget下载python3.7.10
$ wget https://www.python.org/ftp/python/3.7.10/Python-3.7.10.tgz

1. 解压下载好的Python安装包：

$ tar -zxvf Python-3.7.10.tgz

1. 进入解压后的目录：

#进入目录
$ cd Python-3.7.10

#创建一个空文件夹，存放python3程序
$ mkdir /usr/local/python3

#指定安装目录
$ ./configure --prefix=/usr/local/python3

#执行完成时提示："If you want a release build with all stable optimizations active (PGO, etc), please run ./configure --enable-optimizations"
#按提示执行：
$ ./configure --enable-optimization

#编译安装
$ make && make install

1. 建立Python3的软连接：

$ ln -s /usr/local/python3/bin/python3.7 /usr/bin/python3
$ ln -s /usr/local/python3/bin/pip3.7 /usr/bin/pip3

1. 检查Python3和pip3：

[root@loaclhost Python-3.7.10]# python3                             ##检查python3
Python 3.7.10 (default, Mar 16 2022, 11:54:28) 
[GCC 4.8.5 20150623 (Red Hat 4.8.5-44)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>>

[root@loaclhost Python-3.7.10]# pip3 --version                       ##检查version
pip 22.0.4 from /usr/local/lib/python3.7/site-packages/pip (python 3.7)

二，植入chatgpt-on-wechat项目代码:

1. 克隆项目代码：

#root目录下克隆项目代码：
$ git clone https://github.com/zhayujie/chatgpt-on-wechat

#如果没有安装git，执行：
$ yum install git -y

1. 安装所需核心依赖：

#进入chatgpt-On-wechat目录：
$ cd chatgpt-on-wechat/

#安装所需核心依赖：
$ pip3 install itchat-uos==1.5.0.dev0
$ pip3 install --upgrade openai

##注：itchat-uos使用指定版本1.5.0.dev0，openai使用最新版本，需高于0.27.0。

三，配置：

1. 配置文件的模板在根目录的config-template.json中，需复制该模板创建最终生效的 config.json 文件：

# 确认在chatgpt-on-wechat目录下，如果没有，输入：
$ cd chatgpt-on-wechat

# 复制json模板，并命名为：config.json
$ cp config-template.json config.json

1. 然后在config.json中填入配置，以下是对默认配置的说明，可根据需要进行自定义修改：

# config.json文件内容示例
{ 
  "open_ai_api_key": "YOUR API KEY",                          # 填入上面创建的 OpenAI API KEY, 获取API需要登录：https://platform.openai.com/overview
  "proxy": "127.0.0.1:7890",                                  # 代理客户端的ip和端口
  "single_chat_prefix": ["bot", "@bot"],                      # 私聊时文本需要包含该前缀才能触发机器人回复
  "single_chat_reply_prefix": "[bot] ",                       # 私聊时自动回复的前缀，用于区分真人
  "group_chat_prefix": ["@bot"],                              # 群聊时包含该前缀则会触发机器人回复
  "group_name_white_list": ["ChatGPT测试群", "ChatGPT测试群2"], # 开启自动回复的群名称列表
  "image_create_prefix": ["画", "看", "找"],                   # 开启图片回复的前缀
  "conversation_max_tokens": 1000,                            # 支持上下文记忆的最多字符数
  "voice_reply_voice": false                                  # 语音识别-关
  "character_desc": "你是ChatGPT, 一个由OpenAI训练的大型语言模型, 你旨在回答并解决人们的任何问题，并且可以使用多种语言与人交流。"  # 人格描述
}

四，安装代理clash-for-linux代理（需要走代理的话）：

五，运行：

1. 本地运行：如果是开发机 本地运行，直接在项目根目录下执行：

$ python3 app.py

1. 服务器部署：使用nohup命令在后台运行程序：

$ touch nohup.out                                   ## 首次运行需要新建日志文件                     
$ nohup python3 app.py & tail -f nohup.out          ## 在后台运行程序并通过日志输出二维码

## 扫码登录后程序即可运行于服务器后台，此时可通过 ctrl+c 关闭日志，不会影响后台程序的运行。
## 使用 ps -ef | grep app.py | grep -v grep 命令可查看运行于后台的进程，
## 如果想要重新启动程序可以先 kill 掉对应的进程。日志关闭后如果想要再次打开只需输入 tail -f nohup.out。 
## scripts/目录有相应的脚本可以调用

1. 注意：务必使用实名认证的微信号，否则无法登录！登陆错误信息见下图，扫码后手机提示登录验证需要等待5s，

1. 多账号支持： 将项目复制多份，分别启动程序，用不同账号扫码登录即可实现同时运行。

2. 特殊指令： 用户向机器人发送 #清除记忆 即可清空该用户的上下文记忆。