零成本部署大肥魚在 QQ Agent

用 QQ Agent 調用百鍊模型（可以使用阿里300元的優惠券），SnowLuma 負責接入 QQ。本文以Github中的 QQ Agent  和qwen3.8-flash 爲例

優惠券的領取可以看看這個帖子https://api.xiaoheihe.cn/v3/bbs/app/api/web/share?h_camp=link&h_src=YXBwX3NoYXJl&link_id=616372a8213b&new_post_share_style_v2=1

1. 先準備阿里雲 Windows 服務器

準備長期在線的機器人，可以先在阿里雲建立 Windows 雲服務器。

1. 進入阿里雲，搜索“雲服務器 ECS”，查看自己賬號可領取的試用資格。

2. 符合條件的個人新用戶可申請 300 元試用額度，有效期 3 個月

2. 安裝  QQ Agent

準備 Windows 電腦或 Windows 雲服務器、QQ 桌面客戶端、作者發行的 QQ Agent，以及自己的百鍊 API key

GitHub 下載 QQ Agent（本文使用的0.3）

如果放在雲服務器運行，下面的操作都在服務器遠程桌面裏完成。

3. 啓動 QQ Agent 和內置 SnowLuma

打開 QQ Agent，進入頂部 SnowLuma 頁籤，點擊一次 啓動 SnowLuma，等待下方運行日誌輸出。

管理頁默認地址爲 127.0.0.1:5099/（HTTP 協議），以實際日誌顯示爲準。此時 QQ 尚未加載，OneBot 顯示未連接是後續需要完成的步驟，不要反覆點擊啓動。

① 啓動 SnowLuma，② 管理頁入口

4. 在啓動日誌裏找到初始密碼

在同一頁面下方的 運行日誌 中，找到 WebUI 初始登錄憑據 / Initial WebUI Credentials 一段，再找這一行：

initial credentials: user=admin password=你本次啓動生成的實際密碼

只複製 password= 後面的實際內容，不復制時間、日誌前綴、標籤或額外空格。截圖裏的密碼已遮住，不要把“已隱藏”當成密碼。

① 初始密碼所在行，② 首次改密與重啓提示

5. 用初始密碼登錄管理頁

在同一臺電腦打開 127.0.0.1:5099/（也可以在終端Ctrl+左鍵 HTTP協議直接訪問）。輸入框雖然寫着 輸入訪問令牌，這裏填寫的就是第 4 步複製的初始密碼。

點擊 進入控制檯。

① 填日誌中的初始密碼，② 進入控制檯

6. 閱讀首次使用協議

分別閱讀 用戶協議 與 隱私政策。接受內容後，勾選確認，再點擊 同意並繼續。

① 閱讀協議，② 勾選確認，③ 同意並繼續

7. 設置新的管理密碼

按界面的強度要求輸入新密碼，在確認框中再輸入一次相同內容，點擊 保存並完成。若提示重新登錄，使用新密碼。

① 新密碼，② 確認新密碼，③ 保存

8. 登錄機器人 QQ，覈對進程後加載

先在正常的 QQ 客戶端登錄準備用作機器人的賬號，掃碼或密碼登錄由賬號本人完成。然後進入 SnowLuma 的 進程注入 頁面。

列表中的每一行是一個 QQ 進程，不等於一個 QQ 賬號。電腦上有舊 NapCat 或多個 QQ 窗口時，可能同時出現多行。

進程列表：只選擇準備用作機器人的 QQ

先點 探測登錄 覈對賬號。確認正確後，再點擊對應行或彈窗內的 加載。

① 覈對已識別的賬號，② 加載；號碼與頭像已隱藏

“已識別賬號”僅表示身份探測成功。加載完成後，還要回到 QQ Agent，確認 SnowLuma：運行中、OneBot：已連接，且顯示的暱稱與機器人一致。

9. 添加百鍊 Qwen3.8lash

進入 QQ Agent → 設置 → 模型 API，滾動到下方 手動添加提供商。本次實際驗證可用的參數如下：

• Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1（其他模型問豆包即可）

• API Key：自己的百鍊 API key

• 模型 ID：qwen3.8-flash

• 模型目錄顯示名：百鍊 Qwen3.8 Flash，可自行命名

填寫後點擊 確認添加。也可以點擊“獲取列表”勾選模型；如果列表暫時取不到，可手動填寫準確的模型 ID。

① 接口地址，② 密鑰，③ 模型 ID，④ 確認添加

10. 在模型目錄中選中，並測試

回到上方 模型目錄，選擇剛添加的 百鍊 Qwen3.8 Flash，再點擊 保存設置。只在下方添加提供商，不代表已經選中了當前模型。

從模型目錄中選擇剛添加的模型

點擊 測試連通性。本次界面顯示 測試通過（6512ms）：模型回覆 pong。

保存後進行模型連通測試

11. 檢查人設，選擇白名單

進入 人設，選擇自己喜歡的角色卡並保存。本次保留軟件內置“小鯨魚”默認人設，實際調用的模型仍是 Qwen3.8 Flash；模型名稱與人設名稱是兩回事。

進入 聊天白名單，點擊 選擇羣 或 選擇好友，勾選自己的對象。

本次勾選的測試羣

本次勾選的測試好友；號碼已隱藏

在彈窗中點擊 確定 後，返回設置頁還要再點 保存設置。

① 選擇對象，② 對應號碼，③ 空名單放行，④ 保存

本次僅允許一個測試羣和一個測試好友，白名單留空時允許所有會話 保持關閉。兩個名單全空且沒有開啓空名單放行時，機器人不會回覆任何會話。

12. 響應檔位由讀者按需要選擇

進入 聊天設置 → 響應檔位，拖動滑條，並回到頂部 保存設置。

本例勾選 統一設置全部響應檔位，將滑條拖到最右側 全響應。白名單仍然生效，名單外的會話不會因爲“全響應”被放行。

本例採用統一全響應，讀者可自行選擇其他檔位