折騰過各種“AI 工具箱”的朋友，大概率都會遇到同一個尷尬：看上去功能很多，真正要跑起來卻卡在環(huán)境、權(quán)限、網(wǎng)絡(luò)和端口上。尤其是 Windows 機器，明明只是想把 OpenClaw 先裝起來試試，結(jié)果不是腳本沒權(quán)限，就是依賴裝不對，再不然就是跑起來了但網(wǎng)頁打不開——心態(tài)直接被磨沒。

這篇文章我就只做一件事：把 Windows 上安裝 OpenClaw 這件事講清楚、講順手。你不用先理解一堆概念，也不需要“照著感覺自己補步驟”。我把安裝路徑分成兩條：一條是更穩(wěn)妥的 WSL2（更接近 Linux 的官方環(huán)境，后續(xù)坑更少），另一條是原生 Windows（更快上手，但對 PowerShell 和系統(tǒng)環(huán)境更挑剔）。你按自己的習(xí)慣選一條走完，最終目標(biāo)只有一個——在瀏覽器里打開 http://127.0.0.1:18789，看到 OpenClaw 的界面，這就算成了。

零、徹底卸載 OpenClaw

很多人之前自己嘗試裝過 OpenClaw，但是報錯了，后來放棄了，還留了部分殘余，要先處理一下。

#停止網(wǎng)關(guān)
openclaw gateway stop
#卸載系統(tǒng)服務(wù)（launchd/systemd/schtasks）
openclaw gateway uninstall
# 卸載全局包
npm uninstall -g openclaw
# 刪除配置目錄（替換為你的用戶名，或者手動刪除該目錄。
Remove-Item -Recurse -Force C:\Users\你的用戶名\.openclaw
# 清理緩存
npm cache clean --force
# 驗證
openclaw --version

一、打好地基：選擇你的安裝方案

方案A：通過WSL2安裝（推薦大多數(shù)用戶）

• 特點：在Windows內(nèi)創(chuàng)建一個獨立的Linux小環(huán)境，兼容性最好，后續(xù)問題最少

• 適合誰：希望穩(wěn)定、長期使用，不介意多幾步配置的用戶

• 預(yù)計時間：20-30分鐘

方案B：原生Windows安裝（適合熟悉系統(tǒng)的用戶）

• 特點：直接在Windows環(huán)境下運行，更符合Windows用戶的操作習(xí)慣

• 適合誰：熟悉PowerShell，希望快速體驗，不想折騰WSL的用戶

• 預(yù)計時間：10-15分鐘

方案C：通過docker安裝（略）

二、方案A詳細(xì)步驟：通過WSL2安裝（最穩(wěn)妥的路徑）

第1步：啟用Windows的WSL功能

• 在電腦左下角搜索框輸入“PowerShell”

• 在出現(xiàn)的“Windows PowerShell”應(yīng)用上，右鍵單擊，選擇“以管理員身份運行”（這是關(guān)鍵?。?/p>

• 在彈出的藍(lán)色窗口里，逐一輸入下面兩條命令，每條輸入后按回車：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

• 輸入完畢后，重啟你的電腦

• 第2步：手動安裝Ubuntu系統(tǒng)（避開官方命令的坑）

很多朋友卡在 wsl --install命令，下載進(jìn)度永遠(yuǎn)是0%。我們換一種更可靠的手動安裝法。

• 電腦重啟后，再次以管理員身份打開PowerShell

• 輸入以下命令并回車，將WSL的默認(rèn)版本設(shè)置為性能更好的第2代：

wsl --set-default-version 2 #切換為wsl2
wsl --list --verbose #查看所有安裝的發(fā)行版
wsl --unregister Ubuntu-22.04 #卸載已經(jīng)安裝的舊版本Ubuntu-22.04
wsl --install -d Ubuntu-22.04 #在線安裝指定版的Ubuntu-22.04

• 打開你的瀏覽器（如Edge或Chrome），直接訪問以下鏈接，會開始自動下載一個安裝包：

https://aka.ms/wslubuntu2204

下載的文件名類似*Ubuntu2204-221101.AppxBundle*，請記住它的保存位置（通常在“下載”文件夾里）

• 回到剛才的管理員PowerShell窗口。我們需要導(dǎo)航到下載目錄，例如：

cd D:\TDDOWNLOAD

請將“路徑”替換成你自己電腦的路徑

• 然后執(zhí)行安裝命令（請確保文件名一致）：

 Add-AppxPackage Ubuntu2204-221101.AppxBundle

看到提示“操作成功完成”后，關(guān)閉這個窗口。

第3步：初始化Linux系統(tǒng)

• 點擊屏幕左下角的“開始”菜單，找到并點擊新出現(xiàn)的 “Ubuntu 22.04 LTS” 圖標(biāo)

• 首次啟動會進(jìn)行安裝，等待幾分鐘后，會提示你 “Enter new UNIX username:”，意思是讓你設(shè)置一個Linux系統(tǒng)的用戶名（比如 openclawuser），輸入后回車

• 接著會提示你設(shè)置密碼。輸入時屏幕不會顯示任何字符，這是正常的，憑感覺輸完回車即可。請務(wù)必記住這個密碼

至此，一個完美的Linux環(huán)境就準(zhǔn)備好了。后續(xù)所有操作，除非特別說明，都在這個 “Ubuntu” 窗口里進(jìn)行。

第4步，Ubuntu 中安裝 OpenClaw

1. 更新系統(tǒng)包列表

sudo apt update && sudo apt upgrade -y

#2. 安裝Git（下載源碼用）

sudo apt install git -y

#3. 安裝Node.js（LTS版，OpenClaw核心依賴）

方法1：用官方源安裝（推薦，版本新）

#下載并執(zhí)行Node.js 22.x的源配置腳本 #安裝 Node.js 22.x（含 npm）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 卸載node和npm，便于重裝
sudo apt remove -y nodejs npm
# 清理殘留文件
sudo apt autoremove -y

方法2：若方法1失敗，用Ubuntu默認(rèn)源（版本可能稍舊）

sudo apt install nodejs npm -y

驗證安裝（顯示版本號即成功）

node -v
npm -v
git --version

4.安裝 OpenClaw（全局安裝）

依賴裝好后，在終端執(zhí)行 Ubuntu 下的 OpenClaw 安裝命令：

#全局安裝最新版OpenClaw，這一部時間可能較長

sudo npm install -g openclaw@latest #總是出錯，不知道什么原因，使用下面的官方命令吧
官方命令：curl -fsSL https://openclaw.ai/install.sh | bash
# 驗證安裝（顯示版本號即成功）
openclaw --version #簡寫成這樣好像也可以openclaw -v

第5步，Ubuntu 中啟動 OpenClaw 并訪問控制界面

1. 先完成初始化配置（解決“Missing config”報錯）

openclaw setup

# 按提示選“l(fā)ocal”模式，回車默認(rèn)即可

2. 啟動網(wǎng)關(guān)（默認(rèn)端口18789）

openclaw gateway

# 或臨時跳過配置快速啟動
# openclaw gateway --allow-unconfigured --mode local

三、方案B詳細(xì)步驟：原生Windows安裝（最直接的路徑）

如果你不想配置WSL，希望直接在Windows環(huán)境下運行，可以按照以下步驟操作：

[圖片上傳失敗...(image-f0fcad-1771912166473)]

第1步：安裝運行環(huán)境

1.1 OpenClaw基于Node.js開發(fā)，所以首先需要安裝Node.js環(huán)境。

1. 訪問Node.js官網(wǎng)下載頁面：

   https://nodejs.org/zh-cn/download/

2. 下載 Windows安裝程序 (.msi)，建議選擇 長期支持版(LTS)，目前是Node.js 22.x版本

3. 雙擊下載的.msi文件，按照向?qū)崾就瓿砂惭b

4. 安裝完成后，驗證是否安裝成功：

• 在開始菜單搜索“PowerShell”，打開Windows PowerShell（無需管理員權(quán)限）

• 輸入以下命令查看版本：

node --version
npm --version

如果兩個命令都能正確顯示版本號（如v22.x.x），說明安裝成功。

1.2 OpenClaw 的部分功能依賴 Git，需要提前安裝。

訪問 Git 官網(wǎng)：https://git-scm.com/install/windows
點擊下載最新版本
雙擊安裝，一路 Next 即可（保持默認(rèn)選項）

第2步：放寬PowerShell執(zhí)行權(quán)限

由于OpenClaw安裝腳本需要執(zhí)行權(quán)限，我們需要調(diào)整PowerShell的安全策略。

• 在開始菜單搜索“PowerShell”

• 在“Windows PowerShell”上右鍵單擊，選擇“以管理員身份運行”

• 在彈出的窗口中輸入以下命令并按回車：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
執(zhí)行效果：靜默、無交互地將當(dāng)前用戶的 PowerShell 執(zhí)行策略設(shè)為 RemoteSigned。
或者以下命令
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
需要交互確認(rèn)，才能將當(dāng)前用戶的執(zhí)行策略設(shè)為 RemoteSigned。

• 當(dāng)系統(tǒng)詢問是否更改執(zhí)行策略時，輸入 Y并按回車
  查看當(dāng)前權(quán)限

Get-ExecutionPolicy -List
如果 CurrentUser 顯示 Restricted，說明不允許運行腳本。
RemoteSigned 的意思是：本地腳本可以運行，從網(wǎng)上下載的腳本需要有簽名。

第3步：一鍵安裝OpenClaw

• 確保你還在剛才的管理員PowerShell窗口中

• 輸入以下命令開始安裝：

iwr -useb https://openclaw.ai/install.ps1 | iex

• 安裝過程會自動進(jìn)行，可能會持續(xù)幾分鐘。期間如果系統(tǒng)彈出安全警告，請選擇“是”或“允許”以繼續(xù)安裝

• 安裝完成后，你會看到成功的提示信息

第4步：驗證安裝

驗證安裝

openclaw --version # 驗證安裝成功
openclaw gateway start # 啟動 gateway 服務(wù)
openclaw onboard # 然后再配置
openclaw --help # 查看所有命令
openclaw gateway status # 查看 gateway 狀態(tài)
openclaw gateway stop # 停止 gateway
openclaw doctor # 診斷問題

• 安裝完成后，可以直接運行以下命令啟動配置向?qū)В?/li>

openclaw onboard

• 為了快速驗證，在配置向?qū)е校?/p>

• 遇到任何風(fēng)險提示都選 Y

• Onboarding模式選擇 QuickStart

• 當(dāng)問及配置模型和渠道時，選擇 Skip for now

• 完成后，在瀏覽器中訪問：

http://127.0.0.1:18789

如果能看到OpenClaw的Web管理界面，說明安裝成功。
如果一直提示拒絕連接，可能的原因是OpenClaw Gateway 根本沒在監(jiān)聽。
可以通過以下代碼檢查并處理：

# 啟動配置向?qū)Вò刺崾就瓿桑?openclaw onboard
# 查看版本
openclaw --version
# 啟動網(wǎng)關(guān)
openclaw gateway start
# 查看狀態(tài)
openclaw status
openclaw gateway run --verbose
$ netstat -ano | findstr 18789
Get-Process -Id 2144 -ErrorAction SilentlyContinue | Select-Object Id,ProcessName,Path,StartTime
Start-Process -FilePath openclaw -ArgumentList 'gateway','run','--verbose' -WindowStyle Hidden
#把 openclaw gateway run --verbose 作為后臺進(jìn)程啟動了：
openclaw gateway run --verbose
#前臺跑，日志會直接顯示在當(dāng)前窗口里，關(guān)掉窗口通常就停了

四、安裝后的重要提醒

無論你選擇了方案A還是方案B，安裝成功后都需要注意以下幾點：

1、如果你選擇了方案A（WSL2路徑）：

• 所有后續(xù)的OpenClaw操作（如配置、更新、查看日志）都需要在Ubuntu終端中進(jìn)行

• 啟動命令是：在Ubuntu終端輸入 openclaw onboard

• 查看日志命令是：在Ubuntu終端輸入 openclaw logs follow

2、如果你選擇了方案B（原生Windows路徑）：

• 所有后續(xù)的OpenClaw操作都需要在PowerShell中進(jìn)行

• 啟動命令是：在PowerShell輸入 openclaw onboard

• 查看日志命令是：在PowerShell輸入 openclaw logs follow

3、兩個方案的區(qū)別總結(jié)：

4、常見問題處理：

問題1：安裝過程中網(wǎng)絡(luò)連接失敗

• 解決方案：檢查網(wǎng)絡(luò)連接，特別是如果使用了代理，請確保代理設(shè)置正確。對于方案A，可以嘗試手動下載安裝包；對于方案B，可以稍后重試。

問題2：權(quán)限不足導(dǎo)致安裝失敗

• 解決方案：確保全程使用管理員身份運行PowerShell。對于方案A，安裝Ubuntu時也要用管理員PowerShell。

問題3：端口沖突（18789端口被占用）

• 解決方案：可以修改OpenClaw的默認(rèn)端口，或者關(guān)閉占用該端口的程序。運行以下命令查看端口占用：

# 在方案A的Ubuntu中

問題4：殺毒軟件或防火墻阻止安裝

• 解決方案：暫時關(guān)閉第三方殺毒軟件（如360、騰訊電腦管家）或Windows Defender防火墻，安裝完成后再重新開啟。

成功安裝OpenClaw只是第一步，就像剛裝好操作系統(tǒng)的電腦。為了讓你的AI助手真正“活”起來，后續(xù)還需要：

• 配置AI大腦：連接大語言模型（如通義千問、GLM等），讓OpenClaw能夠思考

• 配置溝通渠道：接入飛書、微信等，讓你能在常用工具中與AI對話

• 配置技能和工作流：讓AI學(xué)會處理特定任務(wù)，如總結(jié)文檔、安排日程等

五、接入智慧

1.配置通義千問AI大腦，免費

OpenClaw需要連接一個AI大模型才能“思考”。我們以阿里云的通義千問為例，采用更安全的OAuth授權(quán)方式。這一步最簡單，選擇Qwen就會彈出網(wǎng)頁，登錄即可，沒有賬號的可以注冊一個。

2. 美團龍貓 LongCat，每天免費額度，普通人完全夠用

1. 注冊龍貓平臺
   打開：https://longcat.chat/platform/usage

• 手機號注冊，- 完成實名認(rèn)證（必須，不然不給API）以前美團實名過的可以直接用。

2. 獲取 API Key https://longcat.chat/platform/api_keys
   每天都有免費 token，輕度使用完全不花錢。

具體的配置可以參考這里：https://longcat.chat/platform/docs/zh/OpenClaw.html
簡單的辦法是直接修改這個文件 ~/.openclaw/openclaw.json

六：打開窗口——配置飛書機器人通道

最后一步，讓我們能在最常用的飛書里和AI助手對話。
建議直接參考官方文檔配置就可以 https://docs.openclaw.ai/zh-CN/channels/feishu

核心挑戰(zhàn)是：飛書服務(wù)器需要能把消息發(fā)送到一個公網(wǎng)可訪問的地址，而我們的OpenClaw只在本地運行。解決辦法是使用“內(nèi)網(wǎng)穿透”工具 ngrok。

1）、用ngrok創(chuàng)建公網(wǎng)隧道

1. 訪問 ngrok 官網(wǎng) (https://ngrok.com/) 注冊一個免費賬號。

2. 登錄后，在后臺找到你的 “Authtoken”，并復(fù)制它。

3. 在Windows下（不是在Ubuntu里），打開一個新的普通PowerShell窗口（無需管理員）。輸入以下命令來配置你的token：

   ngrok config add-authtoken 你復(fù)制的Authtoken

4. 配置成功后，運行以下命令創(chuàng)建隧道：

   ngrok http 18789

5. 命令行會運行起來，并顯示重要的轉(zhuǎn)發(fā)信息。你會看到一行類似這樣的內(nèi)容：

   Forwarding https://a1b2-34-56-78-90.ngrok-free.app -> http://localhost:18789

   請復(fù)制**https://a1b2-...**這個開頭的完整地址，這就是你本地服務(wù)的公網(wǎng)大門。讓這個PowerShell窗口保持運行，不要關(guān)閉！

2）、在飛書開放平臺配置機器人

1. 瀏覽器訪問 飛書開放平臺：https://open.feishu.cn/，用飛書APP掃碼登錄。

2. 點擊右上角 “創(chuàng)建應(yīng)用”，選擇 “企業(yè)自建應(yīng)用”。

3. 填寫應(yīng)用名稱（如“我的工作助手”）和描述，點擊創(chuàng)建。

4. 進(jìn)入應(yīng)用后，在左側(cè)菜單欄完成以下子步驟：

• a. 添加能力：點擊“添加能力”，啟用 “機器人”。

• b. 配置權(quán)限：點擊“權(quán)限管理”，搜索并添加以下三個權(quán)限：

• im:message(獲取與發(fā)送單聊、群聊消息)

• im:message:send_as_bot(以機器人身份發(fā)送消息)

• im:message:read_feature(接收消息v2.0)

  添加后，點擊“批量開通”。

• c. 配置事件訂閱（核心）：

1. 點擊“事件訂閱”。

2. 在 “請求地址” 中，粘貼你從ngrok獲得的地址，并在其末尾加上固定的路徑，最終格式必須是：

   https://你獲得的ngrok地址.ngrok-free.app/api/channels/feishu/webhook

3. 點擊 “重新生成” 按鈕生成 Verification Token，并立即復(fù)制保存。

4. 點擊 “添加事件”，搜索并添加事件 im.message.receive_v1。

5. 點擊頁面最下方的 “保存” 按鈕。

• d. 獲取憑證：點擊“憑證與基礎(chǔ)信息”頁面，記錄下 App ID和 App Secret。

現(xiàn)在，從飛書平臺我們得到了三樣?xùn)|西：App ID、App Secret、Verification Token。

3）、在OpenClaw中綁定飛書

1. 回到你的Ubuntu窗口，運行飛書渠道配置命令：

   openclaw channel feishu

2. 跟隨交互式向?qū)В来握迟N你剛才記下的 App ID、App Secret和 Verification Token。

3. 配置完成后，再次重啟服務(wù)：

   openclaw gateway restart

4）、發(fā)布飛書應(yīng)用并測試

1. 回到飛書開放平臺的應(yīng)用管理頁面。

2. 在左側(cè)找到 “版本管理與發(fā)布”，點擊 “創(chuàng)建版本”。

3. 填寫一個版本號（如1.0.0），在 “可用范圍” 選擇“全員”或指定部分成員。

4. 點擊“保存”，然后點擊 “發(fā)布”。等待幾分鐘審核（企業(yè)自建應(yīng)用通常秒過）。

5. 審核通過后，在飛書APP的聊天列表頂部搜索你剛創(chuàng)建的應(yīng)用名稱（如“我的工作助手”），找到后點擊“打開”或“添加”。

6. 現(xiàn)在，你可以在飛書里直接私聊這個機器人，或者把它拉入群聊，然后@它并發(fā)送一句“你好”。稍等片刻，你應(yīng)該就能收到來自通義千問的回復(fù)了！

七、openclaw升級

openclaw出現(xiàn)新版本時會有提示：Update available: v2026.3.11 (running v2026.3.8).
升級前建議
停止服務(wù)（避免文件占用）：
openclaw gateway stop
備份配置文件（~/.openclaw 或項目目錄）。
查看當(dāng)前版本：
升級：
openclaw update --yes --no-restart
openclaw update 在 Windows 上有個常見坑：它自己正在從 node_modules/openclaw 運行時，npm 需要重命名同一個目錄就會報 EBUSY；我改用包管理器在外部直接升級（不走自更新），一般就能繞開這個鎖。
pnpm -v
npm config get prefix
npm install -g openclaw@2026.3.11
升級完成后：
openclaw --version #版本檢查
openclaw doctor # 健康檢查
openclaw gateway restart # 重啟服務(wù)

八、總結(jié)

到這里，其實你已經(jīng)完成了最關(guān)鍵的一步：讓 OpenClaw 在你的 Windows 機器上“站起來”，并且能穩(wěn)定訪問管理界面。后面的事情就不再是“裝不裝得上”，而是“用不用得順”——把大模型接上去，讓它能回答；把飛書/微信這類渠道接上去，讓它能在你日常工具里出現(xiàn)；再把技能和工作流配起來，讓它從“會聊天”變成“能干活”。

成功安裝只是起點。接下來，你可以把它變成一個真正能幫你分擔(dān)工作的助手。
Docker方式:https://mp.weixin.qq.com/s/tqTbun3hEa2-feAQxIRsUA