Windows 上的 OpenClaw 推薦通過(guò) WSL2（推薦 Ubuntu）。CLI + Gateway 網(wǎng)關(guān)在 Linux 內(nèi)運(yùn)行，這保持了運(yùn)行時(shí)的一致性并使工具兼容性大大提高（Node/Bun/pnpm、Linux 二進(jìn)制文件、Skills）。原生 Windows 可能更棘手。WSL2 給你完整的 Linux 體驗(yàn)——一條命令安裝：wsl --install。原生 Windows 配套應(yīng)用已在計(jì)劃中。

在 Windows 系統(tǒng)下的 WSL2 中安裝 OpenClaw 的完整詳細(xì)教程（2026 年 2 月最新版）OpenClaw 是一個(gè)開源的個(gè)人 AI 助手（原 Clawdbot / Moltbot），你可以讓它運(yùn)行在自己的電腦上，通過(guò) WhatsApp、Telegram、Discord、Slack 等你已經(jīng)在用的聊天軟件與它對(duì)話。它支持工具調(diào)用、持久記憶、多代理工作流等強(qiáng)大功能。為什么推薦在 WSL2 中安裝？

• Windows 原生安裝 Node 環(huán)境兼容性差，技能（skills）和二進(jìn)制依賴經(jīng)常出問(wèn)題。
• WSL2 提供完整的 Linux 環(huán)境，運(yùn)行穩(wěn)定、性能好、容易做成后臺(tái)服務(wù)。
• 官方文檔明確推薦 Windows 用戶使用 WSL2 + Ubuntu。

一、前提條件（務(wù)必檢查）

• Windows 10 版本 2004 或更高 / Windows 11（推薦 Win11）。
• BIOS 已開啟 虛擬化（Intel VT-x 或 AMD SVM），可在任務(wù)管理器 → 性能 → 虛擬化：已啟用。
• 至少 8GB 內(nèi)存（推薦 16GB+），因?yàn)?AI 助手 + LLM 會(huì)占用資源。
• 穩(wěn)定的網(wǎng)絡(luò)（安裝過(guò)程中會(huì)下載 Node、依賴、模型等）。

二、安裝 WSL2 + Ubuntu

1：安裝 WSL2 + Ubuntu（只需一次）以管理員身份打開 PowerShell（或終端），依次執(zhí)行：

# 一鍵安裝 WSL2 和默認(rèn) Ubuntu（推薦）
wsl --install
# 如果想指定 Ubuntu 24.04 LTS（更穩(wěn)定）
wsl --list --online
wsl --install -d Ubuntu-24.04

安裝完成后重啟電腦（Windows 會(huì)提示）。重啟后再次打開 PowerShell，進(jìn)入 WSL：

wsl -d Ubuntu-24.04   # 或直接輸入 wsl

更新系統(tǒng)（重要）：

sudo apt update && sudo apt upgrade -y
sudo apt install curl git -y

三、啟用 systemd

2：?jiǎn)⒂?systemd（必需！否則 daemon 服務(wù)裝不上）在 WSL 終端中執(zhí)行：

sudo tee /etc/wsl.conf > /dev/null <<'EOF'
[boot]
systemd=true
EOF

然后在 Windows PowerShell 中重啟 WSL：

wsl --shutdown

重新進(jìn)入 WSL，驗(yàn)證 systemd 已啟用：

systemctl --user status   # 應(yīng)該能看到正常輸出

 四、安裝 OpenClaw

3：安裝 OpenClaw（推薦方式）方法 A：使用官方一鍵安裝腳本（最推薦，自動(dòng)處理 Node 22+）在 WSL 終端中直接運(yùn)行：

curl -fsSL https://openclaw.ai/install.sh | bash

腳本會(huì)：

• 自動(dòng)檢測(cè)/安裝 Node.js 22+
• 全局安裝 openclaw@latest
• 啟動(dòng) onboarding 向?qū)?/li>

方法 B：手動(dòng) npm 安裝（如果你喜歡自己控制）

# 確保 Node 版本
node -v   # 應(yīng)該顯示 v22.x 或更高
npm install -g openclaw@latest

如果 sharp 編譯報(bào)錯(cuò)（常見于某些 WSL 環(huán)境），加環(huán)境變量重試：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

五、 Onboarding配置向?qū)?/h2>

4：完成 Onboarding（配置向?qū)В┌惭b完成后，立即運(yùn)行（強(qiáng)烈建議加 --install-daemon 做成系統(tǒng)服務(wù)）：

openclaw onboard --install-daemon

向?qū)?huì)引導(dǎo)你：

• 選擇 LLM 提供商（推薦 Anthropic Claude / OpenAI / Grok / Minimax 等，免費(fèi)額度夠用）。
• 輸入 API Key（去對(duì)應(yīng)官網(wǎng)申請(qǐng)）。
• 配置主聊天通道（WhatsApp / Telegram / Discord 等）。
• 設(shè)置是否開機(jī)自啟 daemon。
• 完成安全設(shè)置（prompt injection 防護(hù)等）。

整個(gè)過(guò)程 3-5 分鐘，跟著提示點(diǎn)就行。

六、常用命令（安裝后必記）

openclaw doctor          # 檢查配置問(wèn)題
openclaw status          # 查看網(wǎng)關(guān)狀態(tài)
openclaw dashboard       # 打開瀏覽器控制臺(tái)（http://127.0.0.1:18789）
openclaw gateway start   # 手動(dòng)啟動(dòng)網(wǎng)關(guān)
openclaw gateway --port 18789   # 指定端口
# 重啟服務(wù)
openclaw gateway restart
# 查看日志
openclaw logs

七、Dashboard訪問(wèn)

從 Windows 瀏覽器訪問(wèn) Dashboard在 WSL 中啟動(dòng)網(wǎng)關(guān)后：

• Windows 瀏覽器直接輸入 http://localhost:18789 通常就能訪問(wèn)（WSL2 默認(rèn)端口轉(zhuǎn)發(fā)）。
• 如果無(wú)法訪問(wèn)，用以下命令查看 WSL IP：

hostname -I

然后在 Windows 瀏覽器輸入 http://WSL-IP:18789

八、進(jìn)階配置

（可選）

1. 把服務(wù)做成開機(jī)自啟（已通過(guò) --install-daemon 完成）2. 暴露端口給局域網(wǎng)其他設(shè)備（手機(jī)也能直接聊）在 Windows PowerShell（管理員）中設(shè)置端口轉(zhuǎn)發(fā)（示例 SSH 22 端口）：

$Distro = "Ubuntu-24.04"
$ListenPort = 2222
$TargetPort = 22
$WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]
netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort connectaddress=$WslIp connectport=$TargetPort

并添加防火墻規(guī)則。3. 使用 Ollama 本地模型（完全離線）先在 WSL 安裝 Ollama：

curl -fsSL https://ollama.com/install.sh | sh
ollama serve &
ollama pull llama3.2   # 或你喜歡的模型

然后在 OpenClaw onboarding 時(shí)選擇本地 Ollama 端點(diǎn)。

九、常見問(wèn)題排查

十、后續(xù)操作建議

• 進(jìn)入 Dashboard → Channels 添加你常用的聊天軟件。
• 安裝官方 Skills（ClawHub）讓它能操作電腦、寫代碼、查郵件等。
• 推薦搭配 Tailscale / ngrok 實(shí)現(xiàn)手機(jī)遠(yuǎn)程控制。
• 定期運(yùn)行 openclaw update 保持最新。

官方文檔地址（強(qiáng)烈建議收藏）：

• 主文檔：https://docs.openclaw.ai/
• WSL2 專用頁(yè)：https://docs.openclaw.ai/platforms/windows
• GitHub：https://github.com/openclaw/openclaw

按照上面步驟操作，99% 的用戶都能在 15-30 分鐘內(nèi)成功跑起來(lái)。如果你卡在某一步，請(qǐng)把報(bào)錯(cuò)截圖 + 當(dāng)前步驟告訴我，我繼續(xù)幫你排查！現(xiàn)在就去試試吧，安裝完后你的個(gè)人 AI 助手就正式上線了

常見問(wèn)題

WSL2 安裝失??？
確保您的 Windows 版本支持 WSL2（Windows 10 版本 2004 及更高版本，或 Windows 11）。

systemd 無(wú)法啟動(dòng)？
檢查 /etc/wsl.conf 配置是否正確，并確保執(zhí)行了 wsl --shutdown。

端口轉(zhuǎn)發(fā)不工作？
確認(rèn) Windows 防火墻規(guī)則已添加
檢查 WSL IP 地址是否正確：wsl -- hostname -I
使用 netsh interface portproxy show all 查看當(dāng)前轉(zhuǎn)發(fā)規(guī)則
Gateway 服務(wù)無(wú)法啟動(dòng)？
運(yùn)行診斷工具：

openclaw doctor

運(yùn)行項(xiàng)目并下載源碼
項(xiàng)目地址：https://github.com/openclaw/openclaw

最新評(píng)論