?? 龍蝦新手指南

AI Agent平臺小龍蝦Windows一鍵部署教程：2026實測10分鐘跑起AI智能體

發布時間：2026-07-05 分類：龍蝦新手指南

摘要：AI Agent平臺（小龍蝦）Windows 一鍵部署保姆級教程（2026.5實測）最近AI圈有個叫AI Agent平臺（大家愛叫它"小龍蝦"）的開源項目火得一塌糊涂，GitHub上已經沖到28萬星。它最大的賣點就是：在你自己的電腦上跑AI智能體，不用寫代碼，還能自動幫你干活。聽起來很香對吧？但很多人卡在了"部署"這一步。網上教程要么太老，要么步驟復雜，新手很容易勸退。這篇文章是我2026年...

AI Agent平臺（小龍蝦）Windows 一鍵部署保姆級教程（2026.5實測）

最近AI圈有個叫AI Agent平臺（大家愛叫它"小龍蝦"）的開源項目火得一塌糊涂，GitHub上已經沖到28萬星。它最大的賣點就是：在你自己的電腦上跑AI智能體，不用寫代碼，還能自動幫你干活。

聽起來很香對吧？但很多人卡在了"部署"這一步。網上教程要么太老，要么步驟復雜，新手很容易勸退。

這篇文章是我2026年5月在Windows 11上反復測試后寫的，用我打包好的一鍵部署包，10分鐘內就能跑起來。中間踩的坑我也都記下來了，照著做基本不會翻車。

為什么要用一鍵部署包？

正常裝AI Agent平臺，你需要自己搞Node.js、配環境變量、處理各種依賴。光是Node.js版本不對就能卡住一堆人。

我這個部署包把這些全打包好了，解壓就能用。核心思路就是：把別人踩過的坑，提前幫你填平。

準備工作

開始之前，確認一下你的電腦：

操作系統：Windows 10 或 Windows 11（64位）
內存：建議8GB以上（跑本地模型的話16GB更穩）
磁盤空間：至少留10GB空閑
網絡：能正常上網（下載部署包和模型需要）

部署步驟

第一步：下載并解壓部署包

從m.nhjb.com.cn（m.nhjb.com.cn）的教程專區找到AI Agent平臺一鍵部署包，下載下來。

下載完成后，右鍵解壓到一個英文路徑下，比如 D:\AI Agent平臺。

為什么要英文路徑？ 很多開發工具對中文路徑支持不好，可能會報莫名其妙的錯。這是個老生常談的問題，但每年還是有人中招。

解壓后的文件夾結構大概長這樣：

D:\AI Agent平臺\
├── node\              # 內置的Node.js運行環境
├── ai-agent\          # AI Agent平臺主程序
├── start.bat          # 一鍵啟動腳本
├── fix-permission.bat # 權限修復腳本
└── README.txt

第二步：解決Node.js版本沖突

這是最常見的坑。如果你電腦上之前裝過Node.js，版本不對的話會跟部署包里的沖突。

先檢查一下你系統里的Node.js版本：

node -v

如果輸出的版本號是 v16.x 或更低，需要先卸載系統的Node.js。

打開"設置 → 應用 → 安裝的應用"，搜"Node.js"，卸載掉。

卸載完之后，重啟一下電腦。這步別跳過，不然環境變量可能沒清干凈。

為什么要卸載系統的？ 部署包里自帶了適配AI Agent平臺的Node.js版本（v20.x），系統里如果存在舊版本，兩個會打架，導致各種奇怪的報錯。

如果你不想卸載系統的Node.js（比如你做其他開發要用），也可以臨時指定用部署包里的：

# 在部署包目錄下打開終端，設置臨時PATH
set PATH=D:\AI Agent平臺\node;%PATH%
node -v

看到版本號是 v20.x 就對了。

第三步：啟動AI Agent平臺

雙擊 start.bat，會彈出一個黑色命令行窗口。

第一次啟動會自動安裝依賴，大概需要2-3分鐘。看到類似這樣的輸出就說明成功了：

[AI Agent平臺] Starting...
[AI Agent平臺] Dependencies installed.
[AI Agent平臺] Server running at http://localhost:3000

為什么用bat腳本？ 它幫你封裝了啟動命令，包括設置環境變量、切換到正確目錄、調用內置Node.js。你不用記任何命令，雙擊就行。

第四步：處理WSL權限報錯

如果你看到這樣的錯誤：

Error: EACCES: permission denied, open '/mnt/c/...'

這是WSL（Windows子系統Linux）的權限問題。運行一下部署包里的修復腳本：

# 雙擊運行 fix-permission.bat
# 或者在命令行里執行：
wsl --exec chmod -R 755 /mnt/d/AI Agent平臺

為什么會報權限錯？ WSL訪問Windows磁盤時，文件權限映射有時候會出問題。這個腳本就是把權限重新設對，讓AI Agent平臺能正常讀寫文件。

修復完之后，重新雙擊 start.bat，應該就正常了。

第五步：驗證本地大模型調用

AI Agent平臺跑起來之后，打開瀏覽器訪問 http://localhost:3000。

你會看到一個簡潔的操作界面。來驗證一下AI能不能正常干活：

在界面左側找到 "模型設置"
選擇一個本地模型（比如 qwen2.5-7b），點"加載"
等模型加載完成（狀態顯示"就緒"）
在對話框里輸入："幫我寫一個Python腳本，計算斐波那契數列前20項"
點發送

如果AI返回了一段Python代碼，恭喜你，部署成功了！

# AI返回的示例代碼
def fibonacci(n):
    a, b = 0, 1
    result = []
    for _ in range(n):
        result.append(a)
        a, b = b, a + b
    return result

print(fibonacci(20))

常見問題

Q：啟動時報"端口被占用"怎么辦？

# 查看誰占了3000端口
netstat -ano | findstr :3000
# 記下最后一列的PID，然后：
taskkill /PID 12345 /F

Q：模型加載很慢？

第一次加載模型需要下載，7B的模型大概4-5GB，取決于你的網速。加載完成后會緩存到本地，下次就快了。

Q：我的電腦配置低，能跑嗎？

如果內存低于8GB，建議用 qwen2.5-1.5b 這種小模型，雖然能力弱一點，但至少能跑起來體驗一下。

下一步學什么

部署成功只是開始。AI Agent平臺真正好玩的是它的工作流功能——你可以讓AI自動執行多步任務，比如"幫我搜集某個話題的資料，整理成表格，再生成一份報告"。