KouriChat 本地部署 AI 聊天助手并接入微信远程管理
KouriChat 是一款开源本地 AI 聊天助手框架,支持多模型部署与角色定制。本文介绍如何在 Windows 环境下安装 Python 及项目依赖,配置 DeepSeek API 密钥,并将 AI 接入微信实现自动回复。同时通过内网穿透技术实现公网远程访问控制台,确保数据本地运行且隐私安全,无需编程基础即可完成部署与管理。

KouriChat 是一款开源本地 AI 聊天助手框架,支持多模型部署与角色定制。本文介绍如何在 Windows 环境下安装 Python 及项目依赖,配置 DeepSeek API 密钥,并将 AI 接入微信实现自动回复。同时通过内网穿透技术实现公网远程访问控制台,确保数据本地运行且隐私安全,无需编程基础即可完成部署与管理。

Windows 系统(推荐 Windows 10,4G 运存即可,无显存要求)
KouriChat 是一款开源本地 AI 聊天助手框架,主打'低门槛、高定制、易接入'——支持多模型本地部署,能自定义二次元角色的对话风格、语气甚至知识库,内置微信接入接口,不用复杂编程就能让 AI 女友 24 小时蹲在微信里陪聊,全程数据本地运行,隐私拉满。
KouriChat 最绝的地方,就是把'复杂的 AI 玩法'做成了'傻瓜式操作':
本来 KouriChat 部署好只能在自家电脑用,出门一趟就'失联',但使用内网穿透工具后,直接把'本地限定'变成'全网可用',便利多到数不过来:
KouriChat 就像一把'二次元 AI 钥匙',把高门槛的角色陪聊变成了人人能玩的小事 —— 本地部署保隐私,微信接入添趣味,自定义人设够个性;而内网穿透工具则是这把钥匙的'扩展器',打破了'本地服务只能内网用'的枷锁,让你的专属 AI 女友不仅能 24 小时蹲在微信里,还能跟着你走,不管在哪都能调、能聊、能管理。
不用会编程,不用砸大钱,一台普通 Windows 电脑,就能拥有一个'不泄露隐私、随叫随到、完全定制'的 AI 女友。
下面,就让我们一步步看看如何将角色 AI 接入微信,实现全天陪聊吧。
KouriChat 是一款开源的本地 AI 聊天助手框架,旨在让用户能够将自己喜爱的角色、虚拟人物或自定义人格模型轻松接入聊天平台(如微信),实现全天候互动。项目核心特点包括:
在开始部署 KouriChat 之前,我们需要先搭建一个稳定的运行环境,以确保后续模块能够顺利运行。部署此项目需要准备一台 Windows 系统,建议为 Windows 10,项目对配置要求不大,预计 4G 运存即可,不要求显存。必要的环境需要安装 Python 3.11 版本,即可。本教程将在虚拟机 VMware中的Windows 10 22h2版本的镜像作为演示,以纯净初始的系统来部署该项目。
双击运行名为 python-3.11.8-amd64.exe的程序:
![图片]
在显示的界面下,勾选 Add python.exe to PATH选中框,然后点击 install Now进行安装:
![图片]
安装完成后,点击 Close关闭即可:
![图片]
接着,电脑按 Windows+R键,在弹出的运行框中输入 cmd回车,打开命令提示符窗口后,输入如下命令验证 python 版本信息:
python --version
出现版本信息即可!
将 7z2501-x64.exe压缩软件安装至电脑(也可以用其他解压软件或用自带的也可以),然后将 KouriChat-1.4.3.2.zip(目前最新版) 项目解压下来:
![图片]
然后进入项目目录中,双击启动 run.bat脚本:
![图片]
等待脚本执行,脚本会检测你的系统 Python 环境,会自动创建 python 虚拟环境,然后使用 阿里源来进行安装 python 相关的环境依赖,过程稍微比较久,取决于你的网络因素。
![图片]
环境依赖下载完成后会输出提示(如果下载过程中一直卡着,可以尝试回车,可能鼠标脱离终端,导致假卡死了):
![图片]
下载完成后,会尝试启动程序,且会自动打开浏览器:
![图片]
如果没有打开,手动输入提示的网址即可:
http://localhost:8502
出现网页即代表安装部署成功啦!
由于 KouriChat 项目目前尚未完全适配 微信新版 4.1,新版暂时不可用。近期旧版 3.9 版本微信 强制提示升级至最新版,导致无法正常登录微信,从而使项目暂时无法直接接入。 不过,仍有可行的登录方式(此处不再赘述,可在网盘中获取相关资源),通过该方式依然可以实现微信消息的接入与对话功能。
⚠️ 使用重要提示:
建议 尽量使用小号进行测试与登录。
虽然该方案 并非通过注入或修改微信本体,而是以拟人化的方式(即通过对话框内输入信息的方式发送)进行消息交互,但仍存在 极小概率触发微信风控或封号的风险。
请务必牢记——重要的事情说三遍:请使用小号、请使用小号、请使用小号!
本项目及本文档仅供学习与研究使用,如因使用该方案导致微信账号异常、限制或封禁,后果由使用者自行承担。
接下来,将进入 KouriChat 项目的配置步骤,开始搭建属于你的本地 AI 聊天系统。
首先,进入官方的用量信息页面,未登录会先跳转登录页面,登录即可,在该页面可以看到余额和消耗:
https://platform.deepseek.com
![图片]
接着,点击 API keys,进入该页面:
![图片]
在页面上点击 创建 API key的按钮,然后设置一个 名称(用于辨识),创建完成后点击复制按钮进行复制(注意,只会显示一次,不用刻意记忆,忘记删除重新创建即可):
好了,这样就获取到了 deepseek 的 Api 密钥了,留着备用,接下来进行接入 KouriChat 项目!
首先,在初始化管理员页面设置一个管理员密码:
![图片]
在接下来的页面,点击跳过:
![图片]
然后在首页,点击顶部导航栏的 配置中心,在基础配置中添加一个要监听的用户(请填写用户的 昵称,不是备注,也不是微信号):
![图片]
添加完成后,滚动到下方,选择 API 注册地址为 AeepSeek API,AI 模型选择 DeepSeek 官方 V3 模型,将前面获取到的 API 密钥填入即可:
![图片]
接着,展开右侧区域的 意图识别 API 配置,同样填写 deepseek 的相关信息,具体如下图:
# API 注册地址 https://api.deepseek.com/v1 #AI 模型选择 deepseek-chat
![图片]
然后再下方的 消息配置中,设置消息队列等待时间为稍短一些的,这里设置的为 0:
![图片]
最后点击 保存所有设置且提示保存并生效即可:
![图片]
回到主页,点击 微信掉线重连按钮,提示重连成功即可:
![图片]
接着点击 启动按钮,等待启动完成,启动完成后它会自动操作你当前登录的微信(请尽量用小号尝试),作为机器人,然后打开前面配置好的监听昵称的微信对话框:
![图片]
我这里使用的是昵称为【细碎念.】的账号作为机器人,使用昵称为【淡忘如思.】的账号作为被监听的。所以使用【淡忘如思.】的账号来手动发送消息对话:
![图片]
可以看到,发送的消息,控制台成功监听到了,然后调用了 deepseek-chat 模型进行意图解析。最后进行 AI 回复,和正常对话聊天一样的!
部署好 KouriChat 后,很多人都会遇到这种情况:电脑必须 24 小时开着,你却得像'值班管理员'一样守在旁边。一旦外出,AI 突然罢工、不再回复,而家里的控制台又访问不到——日志看不了、角色切不了、API 改不了,一切都陷入停摆。
好消息是,这种局限其实很容易破。借助 内网穿透工具,你可以为本地的 KouriChat 打开一条通往公网的安全通道。无论你是在办公室、出差途中,还是用手机,都能随时登录控制台、切换角色、监控日志,甚至给项目分配一个固定的二级子域名,让你的 AI 助手真正做到'永在线、可远控'。
接下来,我们就来看看——如何用内网穿透工具将 KouriChat 稳定穿透至公网,并绑定专属子域名,让一切操作不再受限于'本地'。
打开内网穿透工具的下载页面,点击下载按钮,下载对应系统的安装包。下来是一个压缩包,解压后执行目录中的应用程序,一路默认安装即可,安装完成后,打开 cmd 窗口输入如下命令确认安装:
cpolar version
出现如上版本即代表安装成功!
注册完成后,在浏览器中输入如下地址访问 web ui 管理界面:
http://localhost:9200
如果还没有账号,点击下方免费注册即可注册账号。输入刚才注册好的账号登录即可进入后台页面: ![图片]
随机域名方式适合预算有限的用户。使用此方式时,系统会每隔 24 小时 左右自动更换一次域名地址。对于长期访问的不太友好,但是该方案是免费的,如果您有一定的预算,可以查看 大纲 5.4.2 的固定域名方式,且访问更稳定。
点击左侧菜单栏的 隧道管理,展开进入 隧道列表页面,页面下默认会有 2 个隧道:
![图片]
点击编辑 website的隧道,修改成我们 kourichat需要的信息:
![图片]
接着来到 在线隧道列表,可以看到名称为 kourichat-8502隧道的两条记录信息,一条协议为 http,另一条协议为 https:
![图片]
以 https 为例,访问测试 (加载稍慢,需耐心等待一下):
![图片]
可以看到,成功的访问到了 kourichat的 web 页面了。
通过前面的配置,我们已经成功实现了 kourichat 的远程访问,但免费随机域名方案的局限性也逐渐显现:每24 小时左右自动更换域名地址,意味着你需要频繁更新书签、重新分享链接,甚至可能因为忘记更新而无法访问。固定域名方案正是为了解决这些痛点而生,让你拥有一个 永久不变的专属地址,真正实现稳定可靠的远程 AI 工作台。
首先,进入官网的预留页面:
https://dashboard.cpolar.com/reserved
选择 预留菜单,即可看到 保留二级子域名项,填写其中的 地区、名称、描述(可不填)项,然后点击保留按钮,操作步骤图如下:
![图片]
列表中显示了一条已保留的二级子域名记录:
China Top。kourichat。注:二级域名是唯一的,每个账号都不相同,请以自己设置的二级域名保留的为主
接着,进入侧边菜单栏的 隧道管理下的 隧道列表,可以看到名为 kourichat-8502的隧道,点击 编辑按钮进入编辑页面:
![图片]
修改域名类型为 二级子域名,然后填写前面配置好的子域名,点击更新按钮:
![图片]
来到 状态菜单下的 在线隧道列表可以看到隧道名称为 kourichat-8502的公网地址已经变更为 二级子域名 + 固定域名主体及后缀的形式了:
![图片]
这里以 https 协议做访问测试(加载稍慢,需耐心等待一下):
![图片]
访问成功!这样一来,你就拥有了一个永久不变的专属域名,再也不用担心 24 小时域名更换的问题。
从本地环境搭建到可视化控制台,从 DeepSeek 官方 API 接入到微信自动回复,再到用内网穿透工具将内网服务稳定暴露到公网——我们把原本繁琐的角色 AI 搭建路径拆解成人人可复现的几步操作,让'把最爱的角色做成 AI 女友并接入微信'真正落地。
这不仅是一份部署指南,更是一套可长期运行的本地 AI 聊天工作台方案。无论是个人体验还是轻量级部署,你都能在几分钟内获得一个可持续、可远控、重隐私的专属角色 AI。现在就动手试试吧!

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online