★ 設為星標 | 只講人話，帶你玩轉(zhuǎn)AIGC。

昨晚我的 OpenClaw（小龍蝦）交流群里簡直是“Windows 難民營”，滿屏都是哀嚎。即便是懂點技術(shù)的老哥，據(jù)說裝起來也想當場把電腦順著窗戶扔出去。

作為一個多年 macOS 用戶，我本想輕飄飄說一句“換電腦吧”，結(jié)果親自上手 Windows 11 折騰了一宿……好吧，我收回那份輕視。

Windows 環(huán)境下的坑，確實比想象中深。

但好消息是：所有的坑我都替你們踩平了。 只要你跟著這篇攻略走，哪怕你是純小白，10 分鐘也能讓這只“龍蝦”在你的飛書里活過來。

一、 動工前的“心理建設”

Windows 的安裝方式其實分兩種：PowerShell 和 WSL。

大部分人會頭鐵選第一種，因為看著熟悉，但實話實說，那是地獄級難度。

WSL 模式雖然是官方推薦，能自動搞定依賴，但對 Linux 知識有要求，且在虛擬機里經(jīng)常鬧情緒（比如我就沒打開過）。

所以，這篇文章我就帶大家硬剛“地獄難度”：直接在本機 PowerShell 下硬推。

別怕，有我在，地獄模式也能降級成小白模式。

開工前，請務必檢查：

1. 梯子： 必須能穩(wěn)穩(wěn)上外網(wǎng)（這是 90% 失敗的原因）。

2. 英文名： 電腦登錄名必須是全英文。如果是中文名（比如“張三”），建議直接新開個英文用戶，別掙扎。

3. 賬號準備： 飛書開發(fā)者賬號 + 大模型 API（文末送你免費的）。

我是在 Windows 11 下進行的安裝。（新裝的系統(tǒng)）

OpenClaw （小龍蝦）對硬件以及系統(tǒng)版本沒有太高的要求，基本上可以認識你的電腦能用就能裝。

安裝過程總體分為三大步驟：安裝依賴包、安裝小龍蝦、配置飛書。

打開你的梯子，我們現(xiàn)在開始。

（注意：不要使用官方那個一句話的安裝命令，沒法使用）

二、 第一步：給電腦“補課”（安裝依賴）

安裝過程中最主要的依賴包就三個：nodejs、git、和 cmake

1、安裝Nodejs：

1）先打開瀏覽器，到這里下載：https://nodejs.org/en/download

圖：下載 NodeJs

系統(tǒng)會自動匹配你要的版本，點擊下載“Windows Installer” 就好了。

2）下載完，安裝 Nodejs，基本上一路回車，但有一個地方必須注意。

圖：安裝 NodeJs

到這一步，記得勾選上！

圖：勾選

到這里按任意鍵繼續(xù)。。

之后會跳出一個黑色窗口跑代碼，別慌，那是它在后臺幫你裝配套工具，靜靜等它跑完。

所有的都安裝完了，就繼續(xù)到安裝下一個：Git

2、安裝Git

先到這里下載：https://git-scm.com/install/windows

這個沒什么好說的，一路點“Next”到底。

3、安裝 cmake

到這里下載：https://cmake.org/download/，選圖示的版本：

也是一路回車裝完：

如果到這里你都沒報錯，那恭喜你，地基已經(jīng)打穩(wěn)了！

三、 第二步：核心大招——正式召喚小龍蝦

第二步主要是安裝 OpenClaw（小龍蝦），要用到命令行，也就是 PowerShell，但繼續(xù)必須在管理員模式下運行，像下圖那樣打開：

先輸入下面這兩行，確認“跟班”們都到齊了：

git --version

沒問題就繼續(xù)。

1）解鎖權(quán)限以及打開代理

由于 Windows 比較保守，我們要先給它松松綁，順便告訴它梯子的路怎么走。

直接把這幾行代碼整塊復制進去回車：

npm config set proxy http://127.0.0.1:7890;npm config set https-proxy http://127.0.0.1:7890

總體如下圖：

(注：7890 是常用端口，如果你的梯子端口不一樣，記得改一下數(shù)字)

2） 跳過下載，直接編譯

在 PowerShell 里面執(zhí)行：

$env:NODE_LLAMA_CPP_SKIP_DOWNLOAD="true"

3） 開始安裝

輸入終極命令：

npm install -g openclaw@latest --verbose --prefer-offline

所有的命令如下：

看著屏幕刷刷飛過代碼，這時候你可以去喝口咖啡。（這里需要幾分鐘）

如果最后出現(xiàn)版本號，說明小龍蝦已經(jīng)成功入駐你的電腦了！

可以執(zhí)行這個命令看下：

openclaw --version

到這里，小龍蝦就已經(jīng)安裝好了，接下來就是要配置它了！

但是在配置之前，先配置一下飛書（如果你用的是釘釘之類的也一樣）。

四、 第三步：給小龍蝦“安家”（配置飛書）

先第一步：進入飛書應用中心：

https://open.feishu.cn/app?lang=zh-CN

創(chuàng)建一個企業(yè)自建應用，應用名和描述隨便寫就好了。

圖：設置機器人名稱

然后添加機器人，如圖

圖：添加機器人

現(xiàn)在立即點頂部的創(chuàng)建版本，發(fā)布你的機器人！

圖：創(chuàng)建版本

創(chuàng)建一個版本好，和描述，隨便寫即可

圖：填寫版本信息

填好之后直接保存：

圖：發(fā)布版本

現(xiàn)在我們點擊頁面左側(cè)的“憑證與基礎(chǔ)信息”，可以看到這個頁面，保持打開，接下來的配置需要用到這里的 1 和 2 信息：

圖：打開憑證與基礎(chǔ)信息備用

激動人心的配置小龍蝦的時刻來了！

五、 激動人心的“調(diào)教”時刻

配置小龍蝦需要在 PowerShell 里面用命令來執(zhí)行，繼續(xù)回到前面那個 PowerShell 窗口，如果你關(guān)了，按照前面的方式重新打開就好了。（記得以管理員身份打開）

在 PowerShell 里面執(zhí)行下面的命令：

openclaw onboard --install-daemon

會看到這個配置頁面：

圖：小龍蝦安裝界面

1）第一個要設置的是這個，用方向鍵←選擇 YES，表示你知道安全風險：

圖：風險選擇：YES

2）直接回車，選擇 QuickStart 模式

圖：配置模式選 QuickStart

3）這是很重要的一步，設置你要用到的大模型。

這里我用階躍星辰免費的大模型做演示，如果你是其他模型安裝你的情況修改。

如果你還沒有 API Key，先獲取到。如果跟我一樣要使用這個免費的模型，先到 www.openrouter.ai 搜索 stepfun，然后創(chuàng)建一個key，

圖：到 OpenRouter 創(chuàng)建免費的 API Key

復制后回到這里：

圖：選擇模型提供商 OpenRouter

4）黏貼你的 API Key

圖：黏貼大模型的 Key

圖：黏貼大模型的 Key

5）選擇模型，用向下鍵選擇 stepfun-3.5-flash:free

圖：選擇模型

6）安裝和配置飛書

這里直接回車先安裝飛書插件：

圖：安裝飛書插件

回車選默認的這個

圖：選擇下載方式

現(xiàn)在就開始配置飛書了。

還記得剛才那個飛書后臺的頁面嗎？先把那里面的App Secret 復制過來

圖：獲取飛書的信息

選擇 Eenter App Secret 繼續(xù)：

圖：黏貼 App Secret

把剛才復制的黏貼進來：

圖：黏貼 App Secret

再去復制 App ID 黏貼進來：

圖：黏貼 App ID

選擇連接方式為默認的：Websocket

圖：選擇鏈接方式 WebSocket

domain 這里回車選默認的就好了

圖：選擇 Domain

這一步設置那些群聊可以用機器人，選 Open。

圖：設置群聊模式為 Open

恭喜你！到這里小龍蝦里面的飛書就配置完啦

7）安裝技能（Skills）

這里我們只安裝一個就好了，移動大 clawdhub 這里，按空格鍵選擇

圖：安裝技能

回車繼續(xù)

圖：安裝技能

8）接下來會有 6 個 KEY 設置，都回車

圖：跳過一些 KEY 的設置

像這樣：

圖：跳過一些 KEY 的設置

8）Hooks

空格選擇 Skip for Now，然后回車

圖：跳過 Hooks 安裝

9）到這里所有的設置都完成了！

圖：配置完成

很快 Windows 里面會彈出一個確認，必須選“允許”：

圖：打開 Windows 的權(quán)限

最后一步，選擇Open the Web UI，然后它會自動打開一個瀏覽器鏈接：

圖：開啟 WebUI

當你看到這個頁面，安裝就完成了，現(xiàn)在立即在“聊天”里面跟你的小龍蝦聊天了。

圖：小龍蝦配置完成，可以聊天

恭喜你，到這一步小龍蝦的安裝配置就全部好了。

但是怎么在飛書里面聊天呢？還得繼續(xù)配置一下飛書哦。

回到飛書后臺。

七、繼續(xù)配置飛書

回到飛書開放平臺，選擇“事件與回調(diào)”，在“事件配置”里面選擇使用“長連接 接收事件”。

圖：打開長連接

（如果你看到的是無法建立長連接，說明前面在小龍蝦里面的飛書沒配置好，重新回到前面。）

然后“添加事件”：這一步至關(guān)重要，否則在飛書里面給機器人發(fā)消息沒回復哦！

圖：添加事件

在頂部輸入：im.message.receive_v1，然后確認添加。

圖：添加事件

接著“確認開通權(quán)限”：

好了之后會看到這樣的。

最后一步了，配置權(quán)限，按如圖，點左側(cè)“權(quán)限管理”，然后注意這里選擇“批量導入/導出權(quán)限”：

圖：添加權(quán)限

在“導入”里面，把現(xiàn)有的內(nèi)容全部刪掉，然后黏貼下面的進入：

}

下一步：確認新增權(quán)限，如圖：

圖：確認新增權(quán)限

申請開通

圖：開通權(quán)限

好了，現(xiàn)在點頂部的“創(chuàng)建版本”

圖：創(chuàng)建版本

隨意添加一下版本信息

圖：發(fā)布版本

到這里，所有的配置都結(jié)束了！

八、在飛書里面聊天

登錄到你的飛書，可以看到“開發(fā)者小助手”已經(jīng)給你發(fā)了幾條信息了，如圖這樣，看到“小龍蝦機器人”已經(jīng)發(fā)布成功，然后直接“打開應用”：

圖：打開機器人聊天

現(xiàn)在，開始跟你的小龍蝦機器人對話吧！

但怎么返回的是這樣的？

圖：在飛書里面跟機器人的初次聊天

沒關(guān)系，最最最最最后一步，回到（或重新打開 PowerShell），黏貼飛書里給你的最后一行信息進入，然后直接回車：

圖：配對飛書

你應該能看到 Approved 的綠色字體。

現(xiàn)在繼續(xù)跟小龍蝦機器人聊天試試：

圖：成功的和飛書對接上了

成功啦！

折騰 AI 工具的樂趣，往往就在于這種“與電腦斗智斗勇”的過程。

雖然 Windows 用戶確實比 macOS 用戶多走了一些彎路，但當你第一次在飛書里調(diào)戲成功自己親手裝好的 AI 時，那種成就感是買來的成品號給不了的。

這只“小龍蝦”你裝成功了嗎？或者你在哪一步被卡成了“紅燒蝦”？

歡迎在評論區(qū)留言或者私信，我看到了會盡量幫大家遠程“撈蝦”。覺得這篇文章幫到你的，記得點個“贊”，點個“??”，別讓干貨在收藏夾里吃灰！

如果還有問題，可以關(guān)注后加入我們的“養(yǎng)蝦群”（關(guān)注后加管理員聯(lián)系方式入群）

附錄：一些可能出現(xiàn)的錯誤

在安裝過程當中，你可能會遇到各種錯誤，最好一邊安裝一遍打開一個 ChatGPT 或者其他 AI，有錯誤直接截圖發(fā)給它告訴你怎么解決。

1）NodeJs 報錯

如果你看到這個報錯，反而可以松一口氣——這說明 Node.js 已經(jīng)安裝成功了！

之所以報錯，是因為 Windows 的“執(zhí)行策略”又把 npm.ps1 這個腳本給攔住了。這就像你已經(jīng)把龍蝦買回家了，只是還沒找到剪開包裝袋的剪刀。

在當前的 PowerShell 窗口里，直接依次執(zhí)行下面這兩行命令

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

然后再執(zhí)行OpenClaw 的安裝：

npm install -g openclaw@latest

2）git 沒裝報錯

下面這個報錯是因為 git 沒裝，先裝上。

圖：git 沒裝的報錯

3） cmake 沒裝

如果你看到這個報錯，先手動安裝 cmake

圖：cmake 沒裝的報錯

4） openclaw安裝失敗的清理：

如果你安裝 openclaw 失敗了，要重新安裝，記得清理

徹底清除 npm 緩存

npm cache clean --force

強力刪除殘留的文件夾（如果存在）

Remove-Item -Recurse -Force "$env:AppData\npm\node_modules\openclaw" -ErrorAction SilentlyContinue