★ 設為星標 | 只講人話,帶你玩轉AIGC。
昨晚我的 OpenClaw(小龍蝦)交流群里簡直是“Windows 難民營”,滿屏都是哀嚎。即便是懂點技術的老哥,據說裝起來也想當場把電腦順著窗戶扔出去。
作為一個多年 macOS 用戶,我本想輕飄飄說一句“換電腦吧”,結果親自上手 Windows 11 折騰了一宿……好吧,我收回那份輕視。
Windows 環境下的坑,確實比想象中深。
但好消息是:所有的坑我都替你們踩平了。 只要你跟著這篇攻略走,哪怕你是純小白,10 分鐘也能讓這只“龍蝦”在你的飛書里活過來。
一、 動工前的“心理建設”
Windows 的安裝方式其實分兩種:PowerShell 和 WSL。
大部分人會頭鐵選第一種,因為看著熟悉,但實話實說,那是地獄級難度。
WSL 模式雖然是官方推薦,能自動搞定依賴,但對 Linux 知識有要求,且在虛擬機里經常鬧情緒(比如我就沒打開過)。
所以,這篇文章我就帶大家硬剛“地獄難度”:直接在本機 PowerShell 下硬推。
別怕,有我在,地獄模式也能降級成小白模式。
開工前,請務必檢查:
梯子: 必須能穩穩上外網(這是 90% 失敗的原因)。
英文名: 電腦登錄名必須是全英文。如果是中文名(比如“張三”),建議直接新開個英文用戶,別掙扎。
賬號準備: 飛書開發者賬號 + 大模型 API(文末送你免費的)。
我是在 Windows 11 下進行的安裝。(新裝的系統)
OpenClaw (小龍蝦)對硬件以及系統版本沒有太高的要求,基本上可以認識你的電腦能用就能裝。
安裝過程總體分為三大步驟:安裝依賴包、安裝小龍蝦、配置飛書。
打開你的梯子,我們現在開始。
(注意:不要使用官方那個一句話的安裝命令,沒法使用)
二、 第一步:給電腦“補課”(安裝依賴)
安裝過程中最主要的依賴包就三個:nodejs、git、和 cmake
1、安裝Nodejs:
1)先打開瀏覽器,到這里下載:https://nodejs.org/en/download
![]()
圖:下載 NodeJs
系統會自動匹配你要的版本,點擊下載“Windows Installer” 就好了。
2)下載完,安裝 Nodejs,基本上一路回車,但有一個地方必須注意。
![]()
圖:安裝 NodeJs
到這一步,記得勾選上!
![]()
圖:勾選
到這里按任意鍵繼續。。
![]()
之后會跳出一個黑色窗口跑代碼,別慌,那是它在后臺幫你裝配套工具,靜靜等它跑完。
所有的都安裝完了,就繼續到安裝下一個:Git
2、安裝Git
先到這里下載:https://git-scm.com/install/windows
這個沒什么好說的,一路點“Next”到底。
![]()
3、安裝 cmake
到這里下載:https://cmake.org/download/,選圖示的版本:
![]()
也是一路回車裝完:
![]()
如果到這里你都沒報錯,那恭喜你,地基已經打穩了!
三、 第二步:核心大招——正式召喚小龍蝦
第二步主要是安裝 OpenClaw(小龍蝦),要用到命令行,也就是 PowerShell,但繼續必須在管理員模式下運行,像下圖那樣打開:
![]()
先輸入下面這兩行,確認“跟班”們都到齊了:
git --version![]()
沒問題就繼續。
1)解鎖權限以及打開代理
由于 Windows 比較保守,我們要先給它松松綁,順便告訴它梯子的路怎么走。
直接把這幾行代碼整塊復制進去回車:
npm config set proxy http://127.0.0.1:7890;npm config set https-proxy http://127.0.0.1:7890總體如下圖:
![]()
(注:7890 是常用端口,如果你的梯子端口不一樣,記得改一下數字)
2) 跳過下載,直接編譯
在 PowerShell 里面執行:
$env:NODE_LLAMA_CPP_SKIP_DOWNLOAD="true"3) 開始安裝
輸入終極命令:
npm install -g openclaw@latest --verbose --prefer-offline所有的命令如下:
![]()
看著屏幕刷刷飛過代碼,這時候你可以去喝口咖啡。(這里需要幾分鐘)
![]()
如果最后出現版本號,說明小龍蝦已經成功入駐你的電腦了!
可以執行這個命令看下:
openclaw --version![]()
到這里,小龍蝦就已經安裝好了,接下來就是要配置它了!
但是在配置之前,先配置一下飛書(如果你用的是釘釘之類的也一樣)。
四、 第三步:給小龍蝦“安家”(配置飛書)
先第一步:進入飛書應用中心:
https://open.feishu.cn/app?lang=zh-CN
![]()
創建一個企業自建應用,應用名和描述隨便寫就好了。
![]()
圖:設置機器人名稱
然后添加機器人,如圖
![]()
圖:添加機器人
現在立即點頂部的創建版本,發布你的機器人!
![]()
圖:創建版本
創建一個版本好,和描述,隨便寫即可
![]()
圖:填寫版本信息
填好之后直接保存:
![]()
圖:發布版本
現在我們點擊頁面左側的“憑證與基礎信息”,可以看到這個頁面,保持打開,接下來的配置需要用到這里的 1 和 2 信息:
![]()
圖:打開憑證與基礎信息備用
激動人心的配置小龍蝦的時刻來了!
五、 激動人心的“調教”時刻
配置小龍蝦需要在 PowerShell 里面用命令來執行,繼續回到前面那個 PowerShell 窗口,如果你關了,按照前面的方式重新打開就好了。(記得以管理員身份打開)
在 PowerShell 里面執行下面的命令:
openclaw onboard --install-daemon會看到這個配置頁面:
![]()
圖:小龍蝦安裝界面
1)第一個要設置的是這個,用方向鍵←選擇 YES,表示你知道安全風險:
![]()
圖:風險選擇:YES
2)直接回車,選擇 QuickStart 模式
![]()
圖:配置模式選 QuickStart
3)這是很重要的一步,設置你要用到的大模型。
這里我用階躍星辰免費的大模型做演示,如果你是其他模型安裝你的情況修改。
如果你還沒有 API Key,先獲取到。如果跟我一樣要使用這個免費的模型,先到 www.openrouter.ai 搜索 stepfun,然后創建一個key,
![]()
圖:到 OpenRouter 創建免費的 API Key
復制后回到這里:
![]()
圖:選擇模型提供商 OpenRouter
4)黏貼你的 API Key
![]()
圖:黏貼大模型的 Key
![]()
圖:黏貼大模型的 Key
5)選擇模型,用向下鍵選擇 stepfun-3.5-flash:free
![]()
圖:選擇模型
6)安裝和配置飛書
這里直接回車先安裝飛書插件:
![]()
圖:安裝飛書插件
回車選默認的這個
![]()
圖:選擇下載方式
現在就開始配置飛書了。
還記得剛才那個飛書后臺的頁面嗎?先把那里面的App Secret 復制過來
![]()
圖:獲取飛書的信息
選擇 Eenter App Secret 繼續:
![]()
圖:黏貼 App Secret
把剛才復制的黏貼進來:
![]()
圖:黏貼 App Secret
再去復制 App ID 黏貼進來:
![]()
圖:黏貼 App ID
選擇連接方式為默認的:Websocket
![]()
圖:選擇鏈接方式 WebSocket
domain 這里回車選默認的就好了
![]()
圖:選擇 Domain
這一步設置那些群聊可以用機器人,選 Open。
![]()
圖:設置群聊模式為 Open
恭喜你!到這里小龍蝦里面的飛書就配置完啦
7)安裝技能(Skills)
這里我們只安裝一個就好了,移動大 clawdhub 這里,按空格鍵選擇
![]()
圖:安裝技能
回車繼續
![]()
圖:安裝技能
8)接下來會有 6 個 KEY 設置,都回車
![]()
圖:跳過一些 KEY 的設置
像這樣:
![]()
圖:跳過一些 KEY 的設置
8)Hooks
空格選擇 Skip for Now,然后回車
![]()
圖:跳過 Hooks 安裝
9)到這里所有的設置都完成了!
![]()
圖:配置完成
很快 Windows 里面會彈出一個確認,必須選“允許”:
![]()
圖:打開 Windows 的權限
最后一步,選擇Open the Web UI,然后它會自動打開一個瀏覽器鏈接:
![]()
圖:開啟 WebUI
當你看到這個頁面,安裝就完成了,現在立即在“聊天”里面跟你的小龍蝦聊天了。
![]()
圖:小龍蝦配置完成,可以聊天
恭喜你,到這一步小龍蝦的安裝配置就全部好了。
但是怎么在飛書里面聊天呢?還得繼續配置一下飛書哦。
回到飛書后臺。
七、繼續配置飛書
回到飛書開放平臺,選擇“事件與回調”,在“事件配置”里面選擇使用“長連接 接收事件”。
![]()
圖:打開長連接
(如果你看到的是無法建立長連接,說明前面在小龍蝦里面的飛書沒配置好,重新回到前面。)
然后“添加事件”:這一步至關重要,否則在飛書里面給機器人發消息沒回復哦!
![]()
圖:添加事件
在頂部輸入:im.message.receive_v1,然后確認添加。
![]()
圖:添加事件
接著“確認開通權限”:
![]()
好了之后會看到這樣的。
![]()
最后一步了,配置權限,按如圖,點左側“權限管理”,然后注意這里選擇“批量導入/導出權限”:
![]()
圖:添加權限
在“導入”里面,把現有的內容全部刪掉,然后黏貼下面的進入:
}下一步:確認新增權限,如圖:
![]()
圖:確認新增權限
申請開通
![]()
圖:開通權限
好了,現在點頂部的“創建版本”
![]()
圖:創建版本
隨意添加一下版本信息
![]()
圖:發布版本
到這里,所有的配置都結束了!
八、在飛書里面聊天
登錄到你的飛書,可以看到“開發者小助手”已經給你發了幾條信息了,如圖這樣,看到“小龍蝦機器人”已經發布成功,然后直接“打開應用”:
![]()
圖:打開機器人聊天
現在,開始跟你的小龍蝦機器人對話吧!
但怎么返回的是這樣的?
![]()
圖:在飛書里面跟機器人的初次聊天
沒關系,最最最最最后一步,回到(或重新打開 PowerShell),黏貼飛書里給你的最后一行信息進入,然后直接回車:
![]()
圖:配對飛書
你應該能看到 Approved 的綠色字體。
現在繼續跟小龍蝦機器人聊天試試:
![]()
圖:成功的和飛書對接上了
成功啦!
折騰 AI 工具的樂趣,往往就在于這種“與電腦斗智斗勇”的過程。
雖然 Windows 用戶確實比 macOS 用戶多走了一些彎路,但當你第一次在飛書里調戲成功自己親手裝好的 AI 時,那種成就感是買來的成品號給不了的。
這只“小龍蝦”你裝成功了嗎?或者你在哪一步被卡成了“紅燒蝦”?
歡迎在評論區留言或者私信,我看到了會盡量幫大家遠程“撈蝦”。覺得這篇文章幫到你的,記得點個“贊”,點個“??”,別讓干貨在收藏夾里吃灰!
如果還有問題,可以關注后加入我們的“養蝦群”(關注后加管理員聯系方式入群)
附錄:一些可能出現的錯誤
在安裝過程當中,你可能會遇到各種錯誤,最好一邊安裝一遍打開一個 ChatGPT 或者其他 AI,有錯誤直接截圖發給它告訴你怎么解決。
1)NodeJs 報錯
如果你看到這個報錯,反而可以松一口氣——這說明 Node.js 已經安裝成功了!
之所以報錯,是因為 Windows 的“執行策略”又把 npm.ps1 這個腳本給攔住了。這就像你已經把龍蝦買回家了,只是還沒找到剪開包裝袋的剪刀。
![]()
在當前的 PowerShell 窗口里,直接依次執行下面這兩行命令
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force然后再執行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
特別聲明:以上內容(如有圖片或視頻亦包括在內)為自媒體平臺“網易號”用戶上傳并發布,本平臺僅提供信息存儲服務。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.