KouriChat——AI微信聊天助手部署教程

KouriChat——AI微信聊天助手部署教程

1.克隆仓库

• 1.1win+R打开终端

1.2进入你想放置该项目的文件夹

1.3执行克隆仓库命令

• 选择一个执行

• 原作者地址

gitclone https://github.com/KouriChat/KouriChat.git

• 转接gitcode地址（若有侵权联系即删）

gitclone https://gitcode.com/2302_81798979/KouriChat.git

这是从github仓库拉取，这块比较慢，需要较长时间等待，也有可能会克隆失败

• 克隆成功字样如下：

• 且在项目文件夹可以看见

• 如果失败，字样如下：

2.使用pycharm打开该文件夹，项目整体结构如下

3. 在终端更新pip版本

python-mpipinstall-ihttps://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple--upgradepip

4.安装项目依赖

pipinstall-rrequirements.txt

• 我本地用的python3.10版本，按照官方说法python版本大于3.9都可以，基本都会安装成功，如果失败创建虚拟环境或者直接丢给大模型，辨别修复。

5.启动项目开始配置

python run_config_web.py

• 启动成功后会自动打开浏览器页面，本地端口8530，如果没有打开自行在本地访问也可。

http://localhost:8502/init_password

6.开始将进行项目配置

• 初始页面如下，设置密码后继续往后
  
• 跳过或者设置都可以，后面还会进行配置，点击跳过

• 进入项目主页

• 点击上方配置中心
• 访问kourAPI页面，注册申请APIkey，好像会免费赠送1元额度，够用一段时间

• 复制密钥，填入右边高级配置
• 填写图像识别API配置key

• 填写意图识别API配置key

• 左侧基础配置依次填写，随便找个API供应商
• 这里监听用户为Elaine

• 这里模型我选择的是阿里的，根据自己的自行填写

• 最后点击下方保存配置，回到项目首页

最重要配置

• 检查微信版本，需要确保3.9版本，如果版本不一样也不行，4.0开始窗口变化较大，3.9下载链接为这个微信

• 登陆自己微信小号，刚才填写为监听自己另一个账号
• 启动该项目，点击运行启动，

• 如果运行时间超过30秒基本可以说明成功了
• 启动后会自动打开微信，搜索你的监测对象，并打开独立窗口

• 右边为自动的AI机器人，左边为检测对象，当左边发送消息时，右边机器人就会恢复

• github项目官方也有部署教程比较简单精炼，项目地址为https://github.com/KouriChat/KouriChat/tree/WeChat-wxauto?tab=readme-ov-file

KouriChat 无法使用后的替代方案

如果你当前无法继续使用 KouriChat，或者遇到项目无法启动、接口失效等问题，可以尝试使用 WxAgent——AI 微信聊天助手部署教程。

WxAgent 同样可以将 AI 接入微信，支持多轮对话、DeepSeek、通义千问、GPT 等多种模型，并提供文件处理、语音识别、工具调用和 Web 管理面板等功能。两者的接入方式和配置流程有所不同，具体部署步骤请参考新的教程。

说明：WxAgent 是独立项目，并非 KouriChat 的官方升级版或官方替代品。使用前请以项目仓库和最新教程为准。