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

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

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

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

適用人群：AI愛好者、二次元角色扮演玩家、希望擁有私有社交機(jī)器人開發(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ù)必使用微信小號進(jìn)行測試！切勿直接使用日常主賬號，以防任何未知風(fēng)險。

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

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

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

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

這是從github倉庫拉取，下載會較慢，請保持等待

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

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

3. 安裝運行本地項目

• 雙擊運行 run.bat文件

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

請確保提前安裝好 Python，推薦使用 3.12 版本

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

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

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

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

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

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

• 返回本地頁面，在頁面中找到并點擊“配置中心”選項

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

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

5. 設(shè)置監(jiān)聽對象

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

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

6. 啟動微信并測試消息

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

• 先點擊「微信掉線重連」
• 再點擊「啟動」

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

如下圖所示

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

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

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

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

注意：

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

zeronews.exe start -d

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

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

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

• Agent：選擇第一步運行的 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)將自動生成一條可供公網(wǎng)訪問的映射域名

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

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

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

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

審核編輯 黃宇