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

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

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

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

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

一、 動(dòng)工前的“心理建設(shè)”

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

大部分人會(huì)頭鐵選第一種，因?yàn)榭粗煜?，但?shí)話實(shí)說(shuō)，那是地獄級(jí)難度。

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

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

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

開(kāi)工前，請(qǐng)務(wù)必檢查：

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

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

3. 賬號(hào)準(zhǔn)備： 飛書(shū)開(kāi)發(fā)者賬號(hào) + 大模型 API（文末送你免費(fèi)的）。

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

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

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

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

（注意：不要使用官方那個(gè)一句話的安裝命令，沒(méi)法使用）

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

安裝過(guò)程中最主要的依賴包就三個(gè)：nodejs、git、和 cmake

1、安裝Nodejs：

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

圖：下載 NodeJs

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

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

圖：安裝 NodeJs

到這一步，記得勾選上！

圖：勾選

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

之后會(huì)跳出一個(gè)黑色窗口跑代碼，別慌，那是它在后臺(tái)幫你裝配套工具，靜靜等它跑完。

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

2、安裝Git

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

這個(gè)沒(méi)什么好說(shuō)的，一路點(diǎn)“Next”到底。

3、安裝 cmake

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

也是一路回車(chē)裝完：

如果到這里你都沒(méi)報(bào)錯(cuò)，那恭喜你，地基已經(jīng)打穩(wěn)了！

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

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

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

git --version

沒(méi)問(wèn)題就繼續(xù)。

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

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

直接把這幾行代碼整塊復(fù)制進(jìn)去回車(chē)：

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

總體如下圖：

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

2） 跳過(guò)下載，直接編譯

在 PowerShell 里面執(zhí)行：

$env:NODE_LLAMA_CPP_SKIP_DOWNLOAD="true"

3） 開(kāi)始安裝

輸入終極命令：

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

所有的命令如下：

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

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

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

openclaw --version

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

但是在配置之前，先配置一下飛書(shū)（如果你用的是釘釘之類(lèi)的也一樣）。

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

先第一步：進(jìn)入飛書(shū)應(yīng)用中心：

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

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

圖：設(shè)置機(jī)器人名稱

然后添加機(jī)器人，如圖

圖：添加機(jī)器人

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

圖：創(chuàng)建版本

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

圖：填寫(xiě)版本信息

填好之后直接保存：

圖：發(fā)布版本

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

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

激動(dòng)人心的配置小龍蝦的時(shí)刻來(lái)了！

五、 激動(dòng)人心的“調(diào)教”時(shí)刻

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

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

openclaw onboard --install-daemon

會(huì)看到這個(gè)配置頁(yè)面：

圖：小龍蝦安裝界面

1）第一個(gè)要設(shè)置的是這個(gè)，用方向鍵←選擇 YES，表示你知道安全風(fēng)險(xiǎn)：

圖：風(fēng)險(xiǎn)選擇：YES

2）直接回車(chē)，選擇 QuickStart 模式

圖：配置模式選 QuickStart

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

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

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

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

復(fù)制后回到這里：

圖：選擇模型提供商 OpenRouter

4）黏貼你的 API Key

圖：黏貼大模型的 Key

圖：黏貼大模型的 Key

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

圖：選擇模型

6）安裝和配置飛書(shū)

這里直接回車(chē)先安裝飛書(shū)插件：

圖：安裝飛書(shū)插件

回車(chē)選默認(rèn)的這個(gè)

圖：選擇下載方式

現(xiàn)在就開(kāi)始配置飛書(shū)了。

還記得剛才那個(gè)飛書(shū)后臺(tái)的頁(yè)面嗎？先把那里面的App Secret 復(fù)制過(guò)來(lái)

圖：獲取飛書(shū)的信息

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

圖：黏貼 App Secret

把剛才復(fù)制的黏貼進(jìn)來(lái)：

圖：黏貼 App Secret

再去復(fù)制 App ID 黏貼進(jìn)來(lái)：

圖：黏貼 App ID

選擇連接方式為默認(rèn)的：Websocket

圖：選擇鏈接方式 WebSocket

domain 這里回車(chē)選默認(rèn)的就好了

圖：選擇 Domain

這一步設(shè)置那些群聊可以用機(jī)器人，選 Open。

圖：設(shè)置群聊模式為 Open

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

7）安裝技能（Skills）

這里我們只安裝一個(gè)就好了，移動(dòng)大 clawdhub 這里，按空格鍵選擇

圖：安裝技能

回車(chē)?yán)^續(xù)

圖：安裝技能

8）接下來(lái)會(huì)有 6 個(gè) KEY 設(shè)置，都回車(chē)

圖：跳過(guò)一些 KEY 的設(shè)置

像這樣：

圖：跳過(guò)一些 KEY 的設(shè)置

8）Hooks

空格選擇 Skip for Now，然后回車(chē)

圖：跳過(guò) Hooks 安裝

9）到這里所有的設(shè)置都完成了！

圖：配置完成

很快 Windows 里面會(huì)彈出一個(gè)確認(rèn)，必須選“允許”：

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

最后一步，選擇Open the Web UI，然后它會(huì)自動(dòng)打開(kāi)一個(gè)瀏覽器鏈接：

圖：開(kāi)啟 WebUI

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

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

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

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

回到飛書(shū)后臺(tái)。

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

回到飛書(shū)開(kāi)放平臺(tái)，選擇“事件與回調(diào)”，在“事件配置”里面選擇使用“長(zhǎng)連接 接收事件”。

圖：打開(kāi)長(zhǎng)連接

（如果你看到的是無(wú)法建立長(zhǎng)連接，說(shuō)明前面在小龍蝦里面的飛書(shū)沒(méi)配置好，重新回到前面。）

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

圖：添加事件

在頂部輸入：im.message.receive_v1，然后確認(rèn)添加。

圖：添加事件

接著“確認(rèn)開(kāi)通權(quán)限”：

好了之后會(huì)看到這樣的。

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

圖：添加權(quán)限

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

}

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

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

申請(qǐng)開(kāi)通

圖：開(kāi)通權(quán)限

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

圖：創(chuàng)建版本

隨意添加一下版本信息

圖：發(fā)布版本

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

八、在飛書(shū)里面聊天

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

圖：打開(kāi)機(jī)器人聊天

現(xiàn)在，開(kāi)始跟你的小龍蝦機(jī)器人對(duì)話吧！

但怎么返回的是這樣的？

圖：在飛書(shū)里面跟機(jī)器人的初次聊天

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

圖：配對(duì)飛書(shū)

你應(yīng)該能看到 Approved 的綠色字體。

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

圖：成功的和飛書(shū)對(duì)接上了

成功啦！

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

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

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

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

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

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

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

1）NodeJs 報(bào)錯(cuò)

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

之所以報(bào)錯(cuò)，是因?yàn)?Windows 的“執(zhí)行策略”又把 npm.ps1 這個(gè)腳本給攔住了。這就像你已經(jīng)把龍蝦買(mǎi)回家了，只是還沒(méi)找到剪開(kāi)包裝袋的剪刀。

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

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

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

npm install -g openclaw@latest

2）git 沒(méi)裝報(bào)錯(cuò)

下面這個(gè)報(bào)錯(cuò)是因?yàn)?git 沒(méi)裝，先裝上。

圖：git 沒(méi)裝的報(bào)錯(cuò)

3） cmake 沒(méi)裝

如果你看到這個(gè)報(bào)錯(cuò)，先手動(dòng)安裝 cmake

圖：cmake 沒(méi)裝的報(bào)錯(cuò)

4） openclaw安裝失敗的清理：

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

徹底清除 npm 緩存

npm cache clean --force

強(qiáng)力刪除殘留的文件夾（如果存在）

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