概述

OpenClaw 推薦在 Windows 上通過(guò) WSL2（Windows Subsystem for Linux 2） 運(yùn)行，建議使用 Ubuntu 發(fā)行版。CLI 和 Gateway 運(yùn)行在 Linux 環(huán)境中，這樣可以保持運(yùn)行時(shí)的一致性，并使工具鏈（Node/Bun/pnpm、Linux 二進(jìn)制文件、技能包）具有更好的兼容性。

雖然原生 Windows 支持可能會(huì)更復(fù)雜，但 WSL2 為您提供了完整的 Linux 體驗(yàn)——只需一條命令即可安裝。

注意： 原生 Windows 配套應(yīng)用正在計(jì)劃中。

第一步：安裝 WSL2 和 Ubuntu

1.1 快速安裝

以管理員身份打開(kāi) PowerShell，執(zhí)行：

wsl --install

如果想指定特定的發(fā)行版（推薦 Ubuntu 24.04）：

# 查看可用發(fā)行版
wsl --list --online
# 安裝指定版本
wsl --install -d Ubuntu-24.04

1.2 重啟系統(tǒng)

如果 Windows 提示需要重啟，請(qǐng)重啟計(jì)算機(jī)以完成 WSL2 安裝。

1.3 首次啟動(dòng)配置

重啟后，從開(kāi)始菜單啟動(dòng) Ubuntu，系統(tǒng)會(huì)要求您：

• 創(chuàng)建 Linux 用戶名
• 設(shè)置密碼

完成后，您就進(jìn)入了 Ubuntu 終端環(huán)境。

第二步：?jiǎn)⒂?systemd

OpenClaw 的 Gateway 服務(wù)需要 systemd 支持。

2.1 配置 WSL

在 Ubuntu 終端中執(zhí)行：

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

2.2 重啟 WSL

回到 Windows PowerShell 執(zhí)行：

wsl --shutdown

2.3 驗(yàn)證 systemd

重新打開(kāi) Ubuntu 終端，驗(yàn)證 systemd 是否正常運(yùn)行：

systemctl --user status

如果看到服務(wù)列表輸出，說(shuō)明配置成功。

第三步：安裝 OpenClaw

3.1 克隆倉(cāng)庫(kù)

在 WSL Ubuntu 終端中執(zhí)行：

git clone https://github.com/openclaw/openclaw.git
cd openclaw

3.2 安裝依賴

pnpm install

3.3 構(gòu)建 UI

pnpm ui:build  # 首次運(yùn)行會(huì)自動(dòng)安裝 UI 依賴

3.4 構(gòu)建項(xiàng)目

pnpm build

3.5 初始化配置

openclaw onboard

按照交互式提示完成初始配置。

第四步：安裝 Gateway 服務(wù)

Gateway 是 OpenClaw 的核心服務(wù)組件。有多種安裝方式：

方式一：自動(dòng)安裝（推薦）

openclaw onboard --install-daemon

方式二：直接安裝

openclaw gateway install

方式三：通過(guò)配置向?qū)?/h3>

openclaw configure

在提示時(shí)選擇 “Gateway service”。

修復(fù)或遷移

如果遇到問(wèn)題，可以運(yùn)行診斷工具：

openclaw doctor

高級(jí)配置：局域網(wǎng)訪問(wèn)（可選）

為什么需要端口轉(zhuǎn)發(fā)？

WSL2 擁有獨(dú)立的虛擬網(wǎng)絡(luò)。如果您需要從其他設(shè)備訪問(wèn) WSL 內(nèi)運(yùn)行的服務(wù)（如 SSH、本地 TTS 服務(wù)器或 Gateway），必須將 Windows 端口轉(zhuǎn)發(fā)到 WSL 的 IP 地址。

注意： WSL 的 IP 地址在每次重啟后會(huì)變化，因此可能需要刷新轉(zhuǎn)發(fā)規(guī)則。

配置端口轉(zhuǎn)發(fā)

以管理員身份打開(kāi) PowerShell，執(zhí)行以下腳本：

# 配置參數(shù)
$Distro = "Ubuntu-24.04"
$ListenPort = 2222  # Windows 監(jiān)聽(tīng)端口
$TargetPort = 22    # WSL 內(nèi)目標(biāo)端口
# 獲取 WSL IP 地址
$WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]
if (-not $WslIp) { throw "無(wú)法獲取 WSL IP 地址" }
# 添加端口轉(zhuǎn)發(fā)規(guī)則
netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort `
  connectaddress=$WslIp connectport=$TargetPort

配置防火墻規(guī)則（一次性）

New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow

WSL 重啟后刷新轉(zhuǎn)發(fā)

每次 WSL 重啟后，需要刷新端口轉(zhuǎn)發(fā)規(guī)則：

# 刪除舊規(guī)則
netsh interface portproxy delete v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 | Out-Null
# 重新獲取 IP 并添加規(guī)則
$WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]
netsh interface portproxy add v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 `
  connectaddress=$WslIp connectport=$TargetPort | Out-Null

重要提示

• 局域網(wǎng)訪問(wèn)： 使用 listenaddress=0.0.0.0 允許局域網(wǎng)訪問(wèn)；使用 127.0.0.1 僅限本機(jī)訪問(wèn)
• 遠(yuǎn)程連接示例： ssh user@windows-host -p 2222（使用 Windows 主機(jī)的 IP 地址）
• Gateway 配置： 遠(yuǎn)程節(jié)點(diǎn)必須指向可訪問(wèn)的 Gateway URL（不能是 127.0.0.1），使用 openclaw status --all 確認(rèn)配置
• 自動(dòng)化： 可以創(chuàng)建 Windows 計(jì)劃任務(wù)，在登錄時(shí)自動(dòng)運(yùn)行刷新腳本

驗(yàn)證安裝

檢查服務(wù)狀態(tài)

openclaw status --all

查看 Gateway 狀態(tài)

systemctl --user status openclaw-gateway

查看日志

journalctl --user -u openclaw-gateway -f

常見(jiàn)問(wèn)題

WSL2 安裝失?。?/h3>

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

systemd 無(wú)法啟動(dòng)？

檢查 /etc/wsl.conf 配置是否正確，并確保執(zhí)行了 wsl --shutdown。

端口轉(zhuǎn)發(fā)不工作？

1. 確認(rèn) Windows 防火墻規(guī)則已添加
2. 檢查 WSL IP 地址是否正確：wsl -- hostname -I
3. 使用 netsh interface portproxy show all 查看當(dāng)前轉(zhuǎn)發(fā)規(guī)則

Gateway 服務(wù)無(wú)法啟動(dòng)？

運(yùn)行診斷工具：

openclaw doctor

項(xiàng)目地址：https://github.com/openclaw/openclaw

到此這篇關(guān)于OpenClaw 在 Windows 上的完整安裝教指南的文章就介紹到這了,更多相關(guān)Windows OpenClaw安裝內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論