KouriChat 是一款開(kāi)源的本地AI聊天助手框架，以其“低門(mén)檻、高定制、易接入”的特點(diǎn)，讓用戶能夠在本地環(huán)境中部署個(gè)性化的AI聊天伴侶，并接入微信等社交平臺(tái)。

主要特性與優(yōu)勢(shì)

• 多模型支持與本地部署：用戶可以選擇不同的語(yǔ)言模型或自定義訓(xùn)練數(shù)據(jù)，在本地運(yùn)行，保障隱私和數(shù)據(jù)安全。
• 角色扮演與多輪對(duì)話：支持豐富的人格設(shè)定，讓AI具備連續(xù)記憶和多輪交互能力，使聊天體驗(yàn)更加生動(dòng)自然。
• 高度可定制：可自定義對(duì)話風(fēng)格、語(yǔ)氣、知識(shí)庫(kù)和行為規(guī)則，滿足二次元愛(ài)好者、AI戀人愛(ài)好者或創(chuàng)作者的多樣需求。
• 易于接入應(yīng)用：內(nèi)置微信接入接口和插件機(jī)制，使AI聊天助手能快速部署到常用社交工具中，實(shí)現(xiàn)24小時(shí)在線陪聊。

本文將帶你從零開(kāi)始，在本地電腦上部署開(kāi)源的 KouriChat 智能聊天框架，并通過(guò) ZeroNews 為其分配一個(gè)公網(wǎng)訪問(wèn)地址。完成配置后，你不僅可以隨時(shí)通過(guò)瀏覽器遠(yuǎn)程管理你的AI，還能將它接入微信，讓它化身為你專屬的社交聊天助手。

適用人群：AI愛(ài)好者、二次元角色扮演玩家、希望擁有私有社交機(jī)器人開(kāi)發(fā)者。

部署 KouriChat 本地服務(wù)

1. 環(huán)境準(zhǔn)備

• 支持 Windows / Linux / macOS 系統(tǒng)（本文以 Linux 為例）
• Git下載
• Python，建議安裝3.12版本
• 微信，建議安裝3.9.12版本

注意：

• 在操作下面步驟之前，建議先將如上內(nèi)容準(zhǔn)備好。
• 務(wù)必使用微信小號(hào)進(jìn)行測(cè)試！切勿直接使用日常主賬號(hào)，以防任何未知風(fēng)險(xiǎn)。

2. 創(chuàng)建 KouriChat 項(xiàng)目文件夾并克隆項(xiàng)目

• 在本地磁盤(pán)創(chuàng)建一個(gè)新文件夾，用于放置下載克隆的KouriChat項(xiàng)目文件，例如 D:KouriChatAI

• 打開(kāi)命令提示符（CMD）窗口，執(zhí)行如下命令進(jìn)入到目標(biāo)文件夾

# 通過(guò)如下命令進(jìn)入到剛才的文件夾
cd /d D:KouriChatAI
# 接著，執(zhí)行克隆倉(cāng)庫(kù)命令
git clone https://github.com/KouriChat/KouriChat.git

這是從github倉(cāng)庫(kù)拉取，下載會(huì)較慢，請(qǐng)保持等待

當(dāng)終端顯示“done”的字樣，表示下載成功

• 可以看到當(dāng)前文件夾中已存在對(duì)應(yīng)的文件

3. 安裝運(yùn)行本地項(xiàng)目

• 雙擊運(yùn)行 run.bat文件

• 系統(tǒng)將自動(dòng)執(zhí)行環(huán)境安裝流程。安裝完成后，系統(tǒng)將顯示“配置管理系統(tǒng)已就緒”提示，并自動(dòng)開(kāi)啟本地頁(yè)面。（也可手動(dòng)在瀏覽器輸入地址 127.0.0.1:8502 訪問(wèn)本地頁(yè)面）

請(qǐng)確保提前安裝好 Python，推薦使用 3.12 版本

• 首次訪問(wèn)系統(tǒng)時(shí)，需完成初始管理員密碼與名稱的設(shè)置操作

• 當(dāng)系統(tǒng)提示填寫(xiě) API 密鑰時(shí)，您可選擇暫時(shí)跳過(guò)該步驟

• 完成上述操作后，系統(tǒng)將自動(dòng)跳轉(zhuǎn)至 dashboard 頁(yè)面

4. 設(shè)置本地項(xiàng)目配置

• 在左側(cè)菜單中點(diǎn)擊“API 服務(wù)”選項(xiàng)，若為首次使用，系統(tǒng)將自動(dòng)重定向至 KouriChat 官網(wǎng)的注冊(cè)/登錄頁(yè)面

• 完成注冊(cè)登錄后，在官網(wǎng)的“令牌”頁(yè)面（或類似位置）即可看到系統(tǒng)為您生成的默認(rèn)令牌。同時(shí)，您也可以手動(dòng)新建一個(gè)令牌，復(fù)制該令牌以作備用

• 返回本地頁(yè)面，在頁(yè)面中找到并點(diǎn)擊“配置中心”選項(xiàng)

• 返回本地頁(yè)面右側(cè)的高級(jí)配置區(qū)域。在該區(qū)域中找到“圖形識(shí)別 API 配置”與“意圖識(shí)別 API 配置”兩項(xiàng)，將剛剛復(fù)制的 Token 分別粘貼至對(duì)應(yīng)位置，隨后點(diǎn)擊保存按鈕以完成配置

若當(dāng)前使用的大模型識(shí)別能力無(wú)法滿足需求，可將其替換為其他模型，系統(tǒng)支持自定義大模型配置

5. 設(shè)置監(jiān)聽(tīng)對(duì)象

基礎(chǔ)配置里，填寫(xiě)監(jiān)聽(tīng)的用戶昵稱

假設(shè)您有一個(gè)常用的主微信號(hào)A，以及一個(gè)用于測(cè)試的小號(hào)B。您需要在電腦上登錄小號(hào)B（作為機(jī)器人賬號(hào)），然后在KouriChat的“基礎(chǔ)配置”中，將“監(jiān)聽(tīng)的用戶昵稱”填寫(xiě)為主號(hào)A的微信昵稱。這樣，當(dāng)主號(hào)A向小號(hào)B發(fā)送消息時(shí)，機(jī)器人就會(huì)自動(dòng)回復(fù)

6. 啟動(dòng)微信并測(cè)試消息

返回系統(tǒng)主頁(yè)，滑動(dòng)到頁(yè)面底部：

• 先點(diǎn)擊「微信掉線重連」
• 再點(diǎn)擊「啟動(dòng)」

啟動(dòng)成功后，就可以在另一部微信上給機(jī)器人發(fā)送消息進(jìn)行測(cè)試。

如下圖所示

右側(cè)為我們發(fā)送的消息，左側(cè)為機(jī)器人回復(fù)的內(nèi)容。

如果意圖識(shí)別效果不理想，可以嘗試更換其他模型進(jìn)行優(yōu)化。

創(chuàng)建 ZeroNews 映射服務(wù)

1. 打開(kāi) ZeroNews管理后臺(tái)，然后選擇您的系統(tǒng)（小編用的是用Win11，選擇Windows即可），并按照對(duì)應(yīng)的步驟和命令安裝運(yùn)行 Agent 服務(wù)

注意：

• Agent 前臺(tái)運(yùn)行不能關(guān)閉命令窗口
• 如果您想要開(kāi)機(jī)自啟動(dòng)，可以執(zhí)行后臺(tái)運(yùn)行命令

zeronews.exe start -d

2. 運(yùn)行完成之后，您可以在 Agent 頁(yè)面看到已經(jīng)在線的 Agent 服務(wù)

3. 在域名端口頁(yè)面，創(chuàng)建一個(gè)可用的公網(wǎng)域名（自定義前綴），并勾選HTTPS 協(xié)議端口

4. 域名創(chuàng)建完成之后，我們繼續(xù)打開(kāi)映射頁(yè)面，并按下面的步驟添加映射

• Agent：選擇第一步運(yùn)行的 Agent
• 映射協(xié)議：選擇 HTTPS 協(xié)議
• 域名：選擇剛創(chuàng)建好的域名
• 帶寬：根據(jù)需要選擇帶寬大小
• 內(nèi)網(wǎng)IP：我們是本地部署，直接使用 127.0.0.1 即可
• 內(nèi)網(wǎng)端口：輸入本地服務(wù)的端口 8502 即可

5. 按照上述流程完成所有創(chuàng)建步驟后，系統(tǒng)將自動(dòng)生成一條可供公網(wǎng)訪問(wèn)的映射域名

公網(wǎng)訪問(wèn)您的KoruiChat服務(wù)

在任意一臺(tái)具備網(wǎng)絡(luò)訪問(wèn)功能的電腦上，打開(kāi)瀏覽器，將鏈接復(fù)制至瀏覽器地址欄，隨后按下回車鍵即可訪問(wèn)

現(xiàn)在你已經(jīng)成功在本地搭建了KouriChat AI聊天助手，并配置了公網(wǎng)遠(yuǎn)程訪問(wèn)能力。

如果在搭建過(guò)程中遇到任何問(wèn)題，或想分享你的AI角色設(shè)定，歡迎在評(píng)論區(qū)留言交流。未來(lái)，我們還將持續(xù)探索更多AI結(jié)合的玩法，敬請(qǐng)期待！

審核編輯 黃宇