KouriChat + DeepSeek + 微信接入：本地 AI 角色聊天机器人搭建实录

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