[GitHub]AstrBot+NapCat實現QQ微信大模型聊天機器人

一、部署 AstrBot

1. 下載安裝器

打開 AstrBot GitHub Releases 頁面,下載 `Source code (zip)` 並解壓到電腦。

2. 運行安裝器

解壓後,打開文件夾,在地址欄輸入 `Powershell` 並打開。

將 `launcher_astrbot_en.bat` 批處理文件拖進去回車運行。

注意:

如果提示 `Windows 已保護您的電腦`,點擊 `更多信息`,然後點擊 `仍要運行`。

如果未檢測到 Python 環境,腳本會提示並退出。確保已安裝 `Python 3.10` 及以上版本,並配置好環境變量。

配置 Python 解釋器路徑: 

  • 打開 `launcher_astrbot_en.bat` 文件,找到 `set PYTHON_CMD=python` 這一行,將 `python` 改爲你的 Python 解釋器路徑或指令。

  • 如果沒有檢測到 Python 環境,腳本將會提示並退出。 + 腳本將自動檢測目錄下是否有`AstrBot`文件夾,如果沒有,將會從GitHub自動下載最新的 AstrBot 源碼。下載好後,會自動安裝 AstrBot 的依賴並運行。

3. 完成部署

  • 腳本將自動檢測目錄下是否有 `AstrBot` 文件夾,如果沒有,會從 GitHub 自動下載最新的 AstrBot 源碼。下載好後,會自動安裝 AstrBot 的依賴並運行。

查看日誌:

如果一切順利,會看到 AstrBot 打印出的日誌,顯示類似 `🌈 管理面板已啓動,可訪問` 並附帶鏈接。打開鏈接可訪問 AstrBot 管理面板,默認用戶名和密碼是 `astrbot` 和 `astrbot`。

常見問題:

  • 管理面板打開時遇到 404 錯誤:在 release 頁面下載 `dist.zip`,解壓拖到 `AstrBot/data` 下。還不行請重啓電腦。

  • 報錯:Python is not installed :如果已安裝 Python 並重啓仍報錯,說明環境變量不對。可通過搜索 Python,打開文件位置,右鍵快捷方式,打開文件所在位置,複製文件地址,修改 `launcher_astrbot_en.bat` 文件中的 `PYTHON_CMD` 爲 Python 解釋器路徑或指令。或重裝 Python,勾選 `Add Python to PATH`,重啓電腦。

二、部署 NapCat 

1. 下載 NapCat

打開 NapCatQQ GitHub 倉庫,根據系統選擇下載方式。

2. 通過一鍵腳本部署 

Windows

參考 NapCat.Shell - Win 手動啓動教程

NapCat.Win.一鍵版本

特殊說明: 一鍵版僅適用無需安裝QQ和NapCat 已內置

如果需要快速啓動 新建Bat文件寫入如下例子

NapCatWinBootMain.exe 10001

通過 Docker 部署

在終端執行以下命令:

docker run -d \

-e NAPCAT_GID=$(id -g) \

-e NAPCAT_UID=$(id -u) \

-p 3000:3000 \

-p 3001:3001 \

-p 6099:6099 \

--name napcat \

--restart=always \

mlikiowa/napcat-docker:latest

查看日誌:

  • 執行成功後,查看日誌獲取登錄二維碼和管理面板 URL。使用 QQ 掃描二維碼登錄。

三、連接 AstrBot 和 NapCat

1. 配置 aiocqhttp

在 AstrBot 管理面板中,選擇左邊欄的 `配置`,點擊 `消息平臺` 選項卡,點擊 `+` 號,選擇 `aiocqhttp`,填寫配置項,如下圖所示:

  • ID(id): 隨意填寫,用於區分不同的消息平臺實例。系統會自動填充。

  • 啓用(enable):勾選。

  • 反向 WebSocket 主機地址:填寫機器 IP 地址,如 `0.0.0.0`。

  • 反向 WebSocket 端口:填寫端口,如 `6199`。

2. 配置管理員

點擊 `其他配置` 選項卡,找到 `管理員 ID`,填寫 QQ 號(不是機器人的 QQ 號)。

3. 保存配置

點擊右下角 `保存`,AstrBot 重啓並應用配置。

4. 在 NapCatQQ 中添加 WebSocket 客戶端

切換回 NapCatQQ 管理面板,點擊 `網絡配置 -> 添加網絡配置`,名稱隨意填寫,類型選擇 `WebSocket 客戶端`。填寫:

  • 啓用:勾選。

  • URL:填寫 `ws://<宿主機 IP>:<端口>/ws`,如 `ws://1.2.3.4:6199/ws`。

  • 消息格式:選擇 `Array`。

5. 完成連接

點擊 `保存`,此時 AstrBot 和 NapCatQQ 應連接成功。使用私聊方式在 QQ 對機器人發送 `/help` 檢查連接是否成功。

四、下載鏈接

AstrBot GitHub Releases

NapCatQQ GitHub 倉庫

更多遊戲資訊請關註:電玩幫遊戲資訊專區

電玩幫圖文攻略 www.vgover.com