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

主要特性與優勢

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

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

適用人群：AI愛好者、二次元角色扮演玩家、希望擁有私有社交機器人開發者。

部署 KouriChat 本地服務

1. 環境準備

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

注意：

• 在操作下面步驟之前，建議先將如上內容準備好。
• 務必使用微信小號進行測試！切勿直接使用日常主賬號，以防任何未知風險。

2. 創建 KouriChat 項目文件夾并克隆項目

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

• 打開命令提示符（CMD）窗口，執行如下命令進入到目標文件夾

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

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

當終端顯示“done”的字樣，表示下載成功

• 可以看到當前文件夾中已存在對應的文件

3. 安裝運行本地項目

• 雙擊運行 run.bat文件

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

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

• 首次訪問系統時，需完成初始管理員密碼與名稱的設置操作

• 當系統提示填寫 API 密鑰時，您可選擇暫時跳過該步驟

• 完成上述操作后，系統將自動跳轉至 dashboard 頁面

4. 設置本地項目配置

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

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

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

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

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

5. 設置監聽對象

基礎配置里，填寫監聽的用戶昵稱

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

6. 啟動微信并測試消息

返回系統主頁，滑動到頁面底部：

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

啟動成功后，就可以在另一部微信上給機器人發送消息進行測試。

如下圖所示

右側為我們發送的消息，左側為機器人回復的內容。

如果意圖識別效果不理想，可以嘗試更換其他模型進行優化。

創建 ZeroNews 映射服務

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

注意：

• Agent 前臺運行不能關閉命令窗口
• 如果您想要開機自啟動，可以執行后臺運行命令

zeronews.exe start -d

2. 運行完成之后，您可以在 Agent 頁面看到已經在線的 Agent 服務

3. 在域名端口頁面，創建一個可用的公網域名（自定義前綴），并勾選HTTPS 協議端口

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

• Agent：選擇第一步運行的 Agent
• 映射協議：選擇 HTTPS 協議
• 域名：選擇剛創建好的域名
• 帶寬：根據需要選擇帶寬大小
• 內網IP：我們是本地部署，直接使用 127.0.0.1 即可
• 內網端口：輸入本地服務的端口 8502 即可

5. 按照上述流程完成所有創建步驟后，系統將自動生成一條可供公網訪問的映射域名

公網訪問您的KoruiChat服務

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

現在你已經成功在本地搭建了KouriChat AI聊天助手，并配置了公網遠程訪問能力。

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

審核編輯 黃宇