Windows 系統上的 OpenClaw 完全安裝指南:從零開始養一隻屬於你的「龍蝦」
- ctfm214
- 3月10日
- 讀畢需時 5 分鐘
在上一篇文章中,我們介紹了 OpenClaw 這隻「龍蝦」是如何從一位退休工程師的周末玩具,搖身一變成為引爆全球科技圈的 AI 智能體新星。它之所以能掀起浪潮,核心就在於打破了傳統 AI「只說不幹」的壁壘,成為真正能幫你「動手跑腿」的數字員工。如果你也心動了,想在自己的 Windows 電腦上養一隻龍蝦,這份保姆級的安裝指南將帶你一步步完成部署。

⚠️ 行前重要提醒:安全第一
在開始之前,有一個非常重要的提醒:OpenClaw 具備操作你電腦的底層權限,這意味著它能幫你自動化處理文件,但也存在一定的風險。如果你的電腦存有極為重要的商業資料或個人隱私,強烈建議使用一台乾淨的備用電腦,或是直接租用一個雲端虛擬機器(VPS)來運行。這樣既能保護隱私,也能避免與現有工作環境發生衝突。
Openclaw Windows
🛠️ 第一階段:環境準備
在迎接龍蝦進門前,我們得先幫它鋪好安穩的窩。OpenClaw 的核心運行依賴 Node.js 環境,且要求版本在 22 以上。
1. 安裝或升級 Node.js
全新安裝:前往 Node.js 官方網站,下載「Windows Installer (64-bit)」的 .msi 安裝包。雙擊安裝時,請務必記得勾選「Add Node.js to PATH」這個關鍵選項,系統會自動配置環境變數,避免後續命令執行失敗。
升級舊版:若你已安裝較舊版本(如 v18),需先透過控制台的「程式和功能」將其卸載,並手動刪除 C:\Program Files\nodejs 資料夾中的殘留文件,再下載新版安裝。
驗證安裝:安裝完成後,請「重啟」所有已開啟的 PowerShell 視窗。按下 Win + R,輸入 PowerShell 開啟視窗,鍵入 node -v,若出現 v22.x.x 或 v24.x.x 的字樣,就代表 Node.js 已成功入駐。
2. 解鎖 PowerShell 執行權限
Windows 系統為了安全,預設禁止執行來自網路的腳本。我們需要手動開啟權限:
按下 Win + S,搜尋「PowerShell」,右鍵選擇「以系統管理員身分執行」。
在藍色視窗中貼上以下命令並按 Enter:
powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
系統提示時輸入 Y 確認,權限解鎖就完成了。
🚀 第二階段:一鍵安裝 OpenClaw
環境準備就緒,現在要正式召喚龍蝦了。
1. 執行一鍵安裝命令
打開一個普通權限的 PowerShell 視窗(非管理員),複製貼上以下命令:
powershell
iwr -useb https://openclaw.ai/install.ps1 | iex若你在國內網路環境下載速度較慢,可以使用國內鏡像腳本:
powershell
iwr -useb https://clawd.org.cn/install.ps1 | iex安裝過程約需 3-10 分鐘,視網路速度而定。
2. 執行初始化嚮導
安裝完成後,輸入以下命令啟動配置嚮導:
powershell
openclaw onboard這是最關鍵的一步,你會看到一系列問答,照著以下推薦選擇即可輕鬆過關:
安全風險提示:選擇 Yes,表示你了解這是一個強大且有風險的工具。
模式 (Mode):選擇 QuickStart(快速啟動),跳過複雜配置。
AI 模型提供商 (Provider):新手推薦選擇 Qwen(通義千問),系統會自動引導你完成網頁授權,取得免費的測試「大腦」。
預設模型 (Default model):直接按 Enter 接受預設值。
通訊渠道 (Channels):選擇 Skip for now(暫不配置),先讓龍蝦在本地跑起來,以後再接飛書或微信。
技能 (Skills):選擇 Yes,啟用基礎技能,讓龍蝦一開始就會文件操作和聯網搜索。
完成後,瀏覽器通常會自動開啟 http://127.0.0.1:18789/,這就是你的 OpenClaw 控制台。在對話框發送訊息,如果有回應,就代表安裝成功了。
⚙️ 第三階段:啟動核心服務
為了讓龍蝦在背景穩定運行,我們需要將它註冊為 Windows 服務。
1. 配置並啟動服務
在 PowerShell 中依序執行以下命令:
powershell
# 配置閘道模式為本地運行
openclaw config set gateway.mode local
# 安裝閘道服務(建立開機自動啟動的計畫任務)
openclaw gateway install
# 啟動服務
openclaw gateway start
# 查看服務狀態,確認是否為 "Running"
openclaw gateway status服務啟動後,即使關閉 PowerShell 視窗,OpenClaw 也會在背景乖乖待命。
🔑 第四階段:配置你的 API Key(以阿里雲百煉為例)
OpenClaw 本身不帶大腦,需要接入外部 AI 模型。這裡以對中文用戶友善的阿里雲百煉為例。
1. 取得 API Key
登入阿里雲百煉大模型服務平台,進入「密鑰管理」,點擊「建立 API-KEY」。
複製生成的 Access Key ID 和 Access Key Secret(Secret 只會顯示一次,請務必保存好)。
2. 配置到 OpenClaw
回到 PowerShell,輸入 openclaw config 進入配置菜單,或直接在控制台的設定頁面,找到 LLM 模型配置項,將剛才複製的 ID 和 Secret 填入對應欄位,並選擇模型(如 qwen-max)即可。
🎯 進階玩法:接入飛書與安裝技能
接入飛書:若想在辦公軟體中隨時召喚龍蝦,可以在初始化嚮導或後續配置中選擇「Feishu/Lark」。你需要前往飛書開放平台建立一個企業自建應用,取得 App ID 和 App Secret,並在 OpenClaw 中填入這些訊息,同時配置好事件訂閱和權限,就能讓機器人在群組中上線了。
安裝視覺技能:OpenClaw 預設只能處理文字,但透過安裝社群開發的「Screenshot」技能,就能讓它「看見」螢幕上的圖表、App 界面,解決視覺盲區。
❓ 常見問題速查
安裝失敗,提示命令無法識別:請檢查是否以「系統管理員」身分執行 PowerShell,並確認 Node.js 已成功加入 PATH 環境變數。
服務啟動後無法訪問控制台:檢查 http://127.0.0.1:18789 是否正確,或使用 openclaw gateway status 查看服務狀態,並用 openclaw logs follow 查看日誌定位問題。
如何完全卸載:在 PowerShell 中執行 openclaw uninstall,或手動刪除 C:\Users\你的用戶名\.openclaw 資料夾。
遵循以上步驟,你就能在 Windows 系統上成功部署 OpenClaw,擁有第一隻能幫你「跑腿辦事」的 AI 龍蝦。從此,繁雜的文件處理、資訊彙總,只需一句話,它就能為你效勞。



After tinkering with my old Windows setup for weeks, I finally got OpenClaw running smoothly. What a game-changer for handling routine file tasks and quick searches without constant babysitting. It feels like having a reliable digital helper that actually executes steps instead of just chatting. Took some patience with Node.js and the gateway service, but once it was live on localhost, things clicked. No more juggling tabs endlessly. If you're into customizing your own setup, it's worth the effort. Reminds me of streamlining workflows with tools like sexrai https://sexrai.com/ for extra efficiency. Solid guide overall—saved me plenty of trial and error.