OpenClaw從安裝到開機(jī)自啟完整部署指南

發(fā)布時(shí)間：2026-03-24 11:55:19 作者：絕不裸奔001

本文檔提供了在Windows WSL2環(huán)境中安裝和配置OpenClaw的詳細(xì)指南,提供常用命令和路徑的速查表,該指南適用于希望在Windows和Linux之間無縫切換開發(fā)和測(cè)試環(huán)境的用戶，感興趣的朋友跟隨小編一起看看吧

OpenClaw 完整部署指南：Windows WSL2 環(huán)境安裝與開機(jī)自啟動(dòng)配置

文檔版本: 1.0
最后更新: 2026-03-22
適用環(huán)境: Windows 10/11 + WSL2 + Ubuntu 20.04/22.04/24.04
OpenClaw 版本: latest (2026.3.13+)
作者: 小e工作室

1. 概述

本指南提供了在 Windows WSL2 環(huán)境中完整部署 OpenClaw 的端到端解決方案，包括：

? 完整安裝流程：從零開始安裝 WSL2、Ubuntu、Node.js 和 OpenClaw
? 網(wǎng)絡(luò)配置：實(shí)現(xiàn)從 Windows 瀏覽器訪問 WSL 中的 OpenClaw
? 開機(jī)自啟：配置 Windows 啟動(dòng)時(shí)自動(dòng)運(yùn)行 OpenClaw，無需手動(dòng)登錄 WSL
? 生產(chǎn)就緒：包含日志管理、錯(cuò)誤處理和故障排查

1.1 為什么選擇 WSL2 部署？

優(yōu)勢(shì)：

?? 原生性能：接近 Linux 原生性能，優(yōu)于虛擬機(jī)
?? 易于管理：集成 Windows 生態(tài)系統(tǒng)，便于文件共享
?? 自動(dòng)啟動(dòng)：可實(shí)現(xiàn)開機(jī)自啟，無需手動(dòng)操作
??? 安全隔離：沙箱環(huán)境，不影響 Windows 系統(tǒng)
?? 零成本：Windows 內(nèi)置功能，無需額外虛擬化軟件

適用場(chǎng)景：

Windows 用戶需要使用 OpenClaw
需要開機(jī)自動(dòng)運(yùn)行 OpenClaw 服務(wù)
希望在 Windows 和 Linux 之間無縫切換
開發(fā)和測(cè)試環(huán)境

2. 系統(tǒng)要求

2.1 硬件要求

組件	最低配置	推薦配置
操作系統(tǒng)	Windows 10 版本 2004+	Windows 11
處理器	雙核 CPU	四核及以上
內(nèi)存	4 GB RAM	8 GB+ RAM
磁盤空間	10 GB 可用空間	20 GB+ SSD
網(wǎng)絡(luò)	穩(wěn)定的互聯(lián)網(wǎng)連接	寬帶連接

2.2 軟件要求

Windows 版本: Windows 10 (2004+) 或 Windows 11
WSL 版本: WSL2 (非 WSL1)
Linux 發(fā)行版: Ubuntu 20.04 / 22.04 / 24.04
Node.js: 22.16+ (推薦 24.x)
PowerShell: 5.1+ (Windows 內(nèi)置)

2.3 檢查系統(tǒng)環(huán)境

在開始之前，請(qǐng)運(yùn)行以下命令檢查您的環(huán)境：

# 在 PowerShell 中運(yùn)行
# 檢查 Windows 版本
winver
# 檢查 WSL 版本
wsl --version
# 檢查 WSL 狀態(tài)
wsl --status

3. 架構(gòu)說明

3.1 整體架構(gòu)圖

┌─────────────────────────────────────────────────────────────┐
│                         Windows 主機(jī)                        │
│                                                               │
│  ┌──────────────────────────────────────────────────────┐  │
│  │         Windows 任務(wù)計(jì)劃程序 (Task Scheduler)         │  │
│  │  觸發(fā)器: 開機(jī)后 30 秒                                 │  │
│  │  運(yùn)行: 啟動(dòng)OpenClaw.ps1                              │  │
│  └───────────────────┬──────────────────────────────────┘  │
│                      │                                       │
│                      ▼                                       │
│  ┌──────────────────────────────────────────────────────┐  │
│  │         WSL2 Ubuntu (Linux 子系統(tǒng))                    │  │
│  │                                                       │  │
│  │  ┌────────────────────────────────────────────────┐ │  │
│  │  │  systemd 用戶服務(wù)                              │ │  │
│  │  │  openclaw-gateway.service                      │ │  │
│  │  │  - 自動(dòng)重啟                                    │ │  │
│  │  │  - 日志管理                                    │ │  │
│  │  │  - 狀態(tài)監(jiān)控                                    │ │  │
│  │  └───────────────┬────────────────────────────────┘ │  │
│  │                  │                                     │  │
│  │                  ▼                                     │  │
│  │  ┌────────────────────────────────────────────────┐ │  │
│  │  │  OpenClaw Gateway                              │ │  │
│  │  │  - 監(jiān)聽端口: 127.0.0.1:18789                   │ │  │
│  │  │  - 提供 Web UI 和 API                          │ │  │
│  │  └───────────────┬────────────────────────────────┘ │  │
│  └──────────────────┼──────────────────────────────────┘  │
│                     │                                        │
└─────────────────────┼────────────────────────────────────────┘
                      │
                      ▼
              ┌─────────────────┐
              │  Windows 瀏覽器  │
              │  localhost:18789│
              └─────────────────┘

3.2 啟動(dòng)流程詳解

Windows 啟動(dòng)
    ↓
等待 30 秒 (WSL 初始化時(shí)間)
    ↓
任務(wù)計(jì)劃程序觸發(fā)
    ↓
PowerShell 執(zhí)行啟動(dòng)腳本
    ↓
啟動(dòng) WSL Ubuntu (無需登錄)
    ↓
執(zhí)行: systemctl --user start openclaw-gateway.service
    ↓
systemd 啟動(dòng) OpenClaw Gateway
    ↓
OpenClaw 監(jiān)聽 127.0.0.1:18789
    ↓
? 服務(wù)就緒，可訪問

3.3 關(guān)鍵技術(shù)點(diǎn)

雙層啟動(dòng)機(jī)制：
- Windows 層：任務(wù)計(jì)劃程序負(fù)責(zé)觸發(fā)
- Linux 層：systemd 負(fù)責(zé)服務(wù)管理
用戶級(jí)服務(wù) (user-level service)：
- 使用 systemctl --user 而非 sudo systemctl
- 更安全，無需 root 權(quán)限
- OpenClaw 安裝時(shí)自動(dòng)創(chuàng)建
網(wǎng)絡(luò)訪問：
- WSL2 自動(dòng) localhost 轉(zhuǎn)發(fā) (Windows 11 默認(rèn))
- 無需額外端口轉(zhuǎn)發(fā)配置

4. 第一部分：安裝 OpenClaw

4.1 安裝 WSL2

4.1.1 啟用 WSL

打開 PowerShell (管理員)，執(zhí)行：

# 啟用 WSL 功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
# 啟用虛擬機(jī)平臺(tái)
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
# 重啟計(jì)算機(jī)
Restart-Computer

4.1.2 設(shè)置 WSL2 為默認(rèn)

重啟后，繼續(xù)在 PowerShell (管理員) 中執(zhí)行：

# 設(shè)置 WSL2 為默認(rèn)版本
wsl --set-default-version 2

4.1.3 安裝 Ubuntu

方法 A：從 Microsoft Store 安裝 (推薦)

打開 Microsoft Store
搜索 “Ubuntu 24.04 LTS” 或 “Ubuntu 22.04 LTS”
點(diǎn)擊"獲取"或"安裝"
等待安裝完成

方法 B：使用命令行安裝

# 查看可用的 Linux 發(fā)行版
wsl --list --online
# 安裝 Ubuntu 24.04
wsl --install -d Ubuntu-24.04
# 安裝完成后會(huì)提示重啟

4.1.4 初始化 Ubuntu

首次啟動(dòng)會(huì)要求創(chuàng)建用戶名和密碼：

Installing, this may take a few minutes...
Please create a default UNIX user account. The username does not need to match your Windows username.
For more information visit: https://aka.ms/wslusers
Enter new UNIX username: parobot
Enter new UNIX password: ******
Retype new UNIX password: ******

?? 重要：請(qǐng)記住您的用戶名和密碼，后續(xù)配置需要用到。

4.2 配置 WSL2 Ubuntu

4.2.1 更新系統(tǒng)包

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

# 更新軟件包列表
sudo apt update
# 升級(jí)已安裝的包
sudo apt upgrade -y
# 安裝基礎(chǔ)工具
sudo apt install -y curl git build-essential python3 make g++ cmake

4.2.2 驗(yàn)證安裝

# 檢查 Ubuntu 版本
lsb_release -a
# 檢查 WSL 版本
wsl --version

預(yù)期輸出示例：

Distributor ID: Ubuntu
Description:    Ubuntu 24.04 LTS
Release:        24.04
Codename:       noble

4.3 安裝 Node.js

OpenClaw 需要 Node.js 22.16 或更高版本。

4.3.1 方法 A：使用 NodeSource (推薦)

# 添加 NodeSource 倉(cāng)庫(kù) (Node.js 24.x)
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
# 安裝 Node.js
sudo apt-get install -y nodejs
# 驗(yàn)證安裝
node --version
npm --version

預(yù)期輸出：

v24.x.x
10.x.x

4.3.2 方法 B：使用 nvm (Node Version Manager)

如果需要管理多個(gè) Node.js 版本：

# 安裝 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
# 重新加載配置
source ~/.bashrc
# 安裝最新的 LTS 版本
nvm install --lts
nvm use --lts
# 驗(yàn)證
node --version

4.4 安裝 OpenClaw

4.4.1 方法 A：使用官方安裝腳本 (最簡(jiǎn)單)

# 在 WSL Ubuntu 中執(zhí)行
curl -fsSL https://openclaw.ai/install.sh | bash

如果不想運(yùn)行 onboarding 向?qū)В梢允褂茫?/p>

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

4.4.2 方法 B：使用 npm 安裝

# 確保使用最新的 npm 版本
npm install -g npm@latest
# 安裝 OpenClaw
npm install -g openclaw@latest
# 運(yùn)行 onboarding 配置向?qū)?
openclaw onboard --install-daemon

4.4.3 驗(yàn)證安裝

# 檢查 OpenClaw 版本
openclaw --version
# 檢查配置
openclaw doctor
# 查看 Gateway 狀態(tài)
openclaw gateway status

預(yù)期輸出示例：

openclaw: 2026.3.13
node: v24.0.0
...
Gateway: running (pid 1234, state active)
Listening: 127.0.0.1:18789

4.4.4 配置 OpenClaw

首次安裝后，運(yùn)行配置向?qū)В?/p>

openclaw onboard

按照提示完成：

配置 API 密鑰 (如 OpenAI API)
設(shè)置默認(rèn)模型
配置插件
啟用網(wǎng)關(guān)服務(wù)

5. 第二部分：配置網(wǎng)絡(luò)訪問

OpenClaw 默認(rèn)監(jiān)聽 127.0.0.1 (localhost)，在 WSL2 中可以直接從 Windows 瀏覽器訪問。

5.1 檢查當(dāng)前網(wǎng)絡(luò)配置

# 在 WSL 中查看 Gateway 狀態(tài)
openclaw gateway status

關(guān)鍵信息：

Gateway: bind=loopback (127.0.0.1), port=18789
Dashboard: http://127.0.0.1:18789/
Listening: 127.0.0.1:18789

5.2 從 Windows 訪問

打開 Windows 瀏覽器，訪問：

http://127.0.0.1:18789/

或

http://localhost:18789/

5.3 WSL2 網(wǎng)絡(luò)模式說明

Windows 11 (22H2+) 默認(rèn)行為：

? 自動(dòng) localhost 轉(zhuǎn)發(fā)
? 無需額外配置
? 直接訪問 localhost:18789

Windows 10 或舊版本：

如果無法訪問，需要配置端口轉(zhuǎn)發(fā)（見 5.4）。

5.4 手動(dòng)配置端口轉(zhuǎn)發(fā) (Windows 10)

如果自動(dòng)轉(zhuǎn)發(fā)不工作，在 PowerShell (管理員) 中執(zhí)行：

# 1. 獲取 WSL IP 地址
$wslIP = wsl hostname -I
Write-Host "WSL IP: $wslIP"
# 2. 添加端口轉(zhuǎn)發(fā)規(guī)則
netsh interface portproxy add v4tov4 listenport=18789 listenaddress=0.0.0.0 connectport=18789 connectaddress=$wslIP
# 3. 配置防火墻規(guī)則
New-NetFirewallRule -DisplayName "OpenClaw WSL" -Direction Inbound -LocalPort 18789 -Protocol TCP -Action Allow
# 4. 驗(yàn)證規(guī)則
netsh interface portproxy show all

刪除端口轉(zhuǎn)發(fā)規(guī)則：

netsh interface portproxy delete v4tov4 listenport=18789 listenaddress=0.0.0.0
Remove-NetFirewallRule -DisplayName "OpenClaw WSL"

5.5 配置鏡像網(wǎng)絡(luò)模式 (高級(jí)，Windows 11 22H2+)

編輯 Windows 用戶目錄下的 .wslconfig 文件：

# 在 PowerShell 中執(zhí)行
notepad $env:USERPROFILE\.wslconfig

添加以下內(nèi)容：

[wsl2]
# 使用鏡像網(wǎng)絡(luò)模式 (Windows 11 22H2+)
networkingMode=mirrored
# 自動(dòng)代理配置
autoProxy=true

保存后重啟 WSL：

wsl --shutdown
wsl -d Ubuntu-24.04

6. 第三部分：配置開機(jī)自啟動(dòng)

本部分詳細(xì)介紹如何實(shí)現(xiàn) OpenClaw 隨 Windows 自動(dòng)啟動(dòng)。

6.1 理解自動(dòng)啟動(dòng)機(jī)制

6.1.1 為什么需要雙層機(jī)制？

WSL2 的特性：
- WSL2 不是傳統(tǒng)虛擬機(jī)，不會(huì)自動(dòng)啟動(dòng)所有服務(wù)
- systemd 用戶服務(wù)需要觸發(fā)啟動(dòng)
解決方案：
- WSL 層：使用 systemd 用戶服務(wù)管理 OpenClaw
- Windows 層：使用任務(wù)計(jì)劃程序在啟動(dòng)時(shí)觸發(fā)

6.1.2 OpenClaw 的服務(wù)架構(gòu)

OpenClaw 安裝時(shí)會(huì)自動(dòng)創(chuàng)建用戶級(jí) systemd 服務(wù)：

# 查看服務(wù)文件
ls ~/.config/systemd/user/openclaw-gateway.service
# 查看服務(wù)狀態(tài)
systemctl --user status openclaw-gateway.service

關(guān)鍵點(diǎn)：

服務(wù)文件位置：~/.config/systemd/user/openclaw-gateway.service
這是用戶級(jí)服務(wù)，不需要 root 權(quán)限
OpenClaw 安裝時(shí)自動(dòng)創(chuàng)建并啟用

6.2 配置 WSL 層服務(wù)

6.2.1 檢查現(xiàn)有服務(wù)

在 WSL Ubuntu 中執(zhí)行：

# 查看服務(wù)狀態(tài)
systemctl --user status openclaw-gateway.service
# 查看服務(wù)是否啟用
systemctl --user is-enabled openclaw-gateway.service
# 查看 Gateway 狀態(tài)
openclaw gateway status

預(yù)期輸出：

● openclaw-gateway.service - OpenClaw Gateway Service
   Loaded: loaded (/home/youruser/.config/systemd/user/openclaw-gateway.service; enabled)
   Active: active (running)

6.2.2 手動(dòng)啟用服務(wù) (如果未啟用)

如果服務(wù)顯示 disabled，執(zhí)行：

# 啟用開機(jī)自啟
systemctl --user enable openclaw-gateway.service
# 啟動(dòng)服務(wù)
systemctl --user start openclaw-gateway.service
# 驗(yàn)證
systemctl --user status openclaw-gateway.service

6.2.3 配置 linger (保持用戶服務(wù)運(yùn)行)

為確保用戶級(jí)服務(wù)在沒有登錄時(shí)也能運(yùn)行，需要啟用 linger：

# 啟用 linger
loginctl enable-linger $(whoami)

# 驗(yàn)證
loginctl show-user $(whoami) | grep Linger

輸出應(yīng)該是：

Linger=yes

?? 重要：linger 允許用戶服務(wù)在登出后繼續(xù)運(yùn)行，這是開機(jī)自啟的關(guān)鍵。

6.3 創(chuàng)建 Windows 啟動(dòng)腳本

現(xiàn)在創(chuàng)建一個(gè) PowerShell 腳本，用于從 Windows 啟動(dòng) WSL 中的 OpenClaw 服務(wù)。

6.3.1 創(chuàng)建腳本文件

在 Windows 上創(chuàng)建文件：F:\OpenClaw_Installed\啟動(dòng)OpenClaw.ps1

# OpenClaw WSL Startup Script
# 功能: 通過 WSL 啟動(dòng) OpenClaw Gateway 服務(wù)
# 作者: OpenClaw 社區(qū)
# 版本: 1.0
$ErrorActionPreference = "Continue"
# 配置參數(shù)
$WSLDistro = "Ubuntu-24.04"  # WSL 發(fā)行版名稱
$LogPath = "$env:USERPROFILE\OpenClaw-Startup.log"
# 日志記錄函數(shù)
function Write-Log {
    param([string]$Message)
    $Timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
    $LogMessage = "[$Timestamp] $Message"
    Add-Content -Path $LogPath -Value $LogMessage
    Write-Host $Message
}
try {
    Write-Log "========================================"
    Write-Log "OpenClaw WSL Startup Script"
    Write-Log "========================================"
    Write-Log "Starting OpenClaw..."
    Write-Log "Using WSL distro: $WSLDistro"
    # 啟動(dòng) OpenClaw 用戶服務(wù)
    Write-Log "Starting OpenClaw gateway service..."
    $result = wsl -d $WSLDistro -- bash -c 'export XDG_RUNTIME_DIR=/run/user/$(id -u) && systemctl --user start openclaw-gateway.service' 2>&1
    Write-Log "Start command result: $result"
    # 等待服務(wù)啟動(dòng)
    Start-Sleep -Seconds 3
    # 檢查服務(wù)狀態(tài)
    Write-Log "Checking service status..."
    $status = wsl -d $WSLDistro -- bash -c 'export XDG_RUNTIME_DIR=/run/user/$(id -u) && systemctl --user is-active openclaw-gateway.service' 2>&1
    Write-Log "Service status: $status"
    # 檢查 Gateway 狀態(tài)
    Write-Log "Checking OpenClaw gateway..."
    $gateway = wsl -d $WSLDistro -- bash -c 'cd ~ && openclaw gateway status 2>&1' | Select-String -Pattern "running|active" -Context 0,2
    Write-Log "Gateway status: $gateway"
    Write-Log "========================================"
    Write-Log "OpenClaw startup completed!"
    Write-Log "Dashboard: http://127.0.0.1:18789/"
    Write-Log "========================================"
    Write-Host "SUCCESS: OpenClaw is running!" -ForegroundColor Green
    Write-Host "Access at: http://127.0.0.1:18789/" -ForegroundColor Cyan
} catch {
    Write-Log "Error occurred: $_"
    Write-Host "Error: $_" -ForegroundColor Red
    exit 1
}

6.3.2 測(cè)試腳本

在 PowerShell (普通用戶) 中執(zhí)行：

F:\OpenClaw_Installed\啟動(dòng)OpenClaw.ps1

預(yù)期輸出：

Starting OpenClaw...
Using WSL distro: Ubuntu-24.04
Starting OpenClaw gateway service...
Start command result: ...
Checking service status...
Service status: active
Gateway status: running
========================================
OpenClaw startup completed!
Dashboard: http://127.0.0.1:18789/
========================================
SUCCESS: OpenClaw is running!
Access at: http://127.0.0.1:18789/

6.3.3 檢查日志

# 查看日志文件
notepad $env:USERPROFILE\OpenClaw-Startup.log

6.4 配置 Windows 任務(wù)計(jì)劃程序

現(xiàn)在創(chuàng)建 Windows 任務(wù)計(jì)劃程序任務(wù)，實(shí)現(xiàn)開機(jī)自動(dòng)運(yùn)行啟動(dòng)腳本。

6.4.1 創(chuàng)建任務(wù)配置腳本

創(chuàng)建文件：F:\OpenClaw_Installed\創(chuàng)建任務(wù)計(jì)劃程序.ps1

# OpenClaw AutoStart Task Creator
# 功能: 創(chuàng)建 Windows 任務(wù)計(jì)劃程序任務(wù)
# 作者: OpenClaw 社區(qū)
# 版本: 1.0
# 配置參數(shù)
$TaskName = "OpenClaw WSL AutoStart"
$ScriptPath = "F:\OpenClaw_Installed\啟動(dòng)OpenClaw.ps1"
$DelaySeconds = 30  # 啟動(dòng)延遲(秒)
Write-Host "========================================" -ForegroundColor Cyan
Write-Host "OpenClaw AutoStart Task Creator" -ForegroundColor Cyan
Write-Host "========================================" -ForegroundColor Cyan
Write-Host ""
# 檢查管理員權(quán)限
$isAdmin = ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
if (-not $isAdmin) {
    Write-Host "ERROR: This script requires administrator privileges!" -ForegroundColor Red
    Write-Host ""
    Write-Host "Please:" -ForegroundColor Yellow
    Write-Host "1. Right-click on PowerShell" -ForegroundColor Yellow
    Write-Host "2. Select 'Run as Administrator'" -ForegroundColor Yellow
    Write-Host "3. Run this script again" -ForegroundColor Yellow
    Write-Host ""
    $null = Read-Host "Press Enter to exit"
    exit 1
}
Write-Host "? Administrator privileges confirmed" -ForegroundColor Green
Write-Host ""
# 檢查腳本文件
if (-not (Test-Path $ScriptPath)) {
    Write-Host "ERROR: Script file not found: $ScriptPath" -ForegroundColor Red
    $null = Read-Host "Press Enter to exit"
    exit 1
}
Write-Host "Configuration:" -ForegroundColor Cyan
Write-Host "  Task Name: $TaskName"
Write-Host "  Script: $ScriptPath"
Write-Host "  Startup Delay: $DelaySeconds seconds"
Write-Host ""
# 刪除現(xiàn)有任務(wù)(如果存在)
$existingTask = Get-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue
if ($existingTask) {
    Write-Host "Existing task found. Removing..." -ForegroundColor Yellow
    Unregister-ScheduledTask -TaskName $TaskName -Confirm:$false
    Write-Host "? Existing task removed" -ForegroundColor Green
    Write-Host ""
}
# 創(chuàng)建觸發(fā)器 (開機(jī)啟動(dòng) + 延遲)
Write-Host "Creating task trigger..." -ForegroundColor Cyan
$trigger = New-ScheduledTaskTrigger -AtStartup
$trigger.Delay = "PT${DelaySeconds}S"
# 創(chuàng)建操作
Write-Host "Creating task action..." -ForegroundColor Cyan
$action = New-ScheduledTaskAction `
    -Execute "PowerShell.exe" `
    -Argument "-NoProfile -ExecutionPolicy Bypass -File `"$ScriptPath`"" `
    -WorkingDirectory "F:\OpenClaw_Installed"
# 創(chuàng)建設(shè)置
Write-Host "Configuring task settings..." -ForegroundColor Cyan
$settings = New-ScheduledTaskSettingsSet `
    -AllowStartIfOnBatteries `
    -DontStopIfGoingOnBatteries `
    -StartWhenAvailable `
    -DontStopOnIdleEnd
# 注冊(cè)任務(wù)
Write-Host "Registering scheduled task..." -ForegroundColor Cyan
Register-ScheduledTask `
    -TaskName $TaskName `
    -Trigger $trigger `
    -Action $action `
    -Settings $settings `
    -Description "Automatically start OpenClaw WSL service at Windows startup" `
    -User "SYSTEM" `
    | Out-Null
Write-Host ""
Write-Host "========================================" -ForegroundColor Green
Write-Host "Task created successfully!" -ForegroundColor Green
Write-Host "========================================" -ForegroundColor Green
Write-Host ""
# 顯示任務(wù)信息
Write-Host "Task Details:" -ForegroundColor Cyan
Get-ScheduledTask -TaskName $TaskName | Format-List Name, State, Description
Write-Host ""
Write-Host "Configuration Summary:" -ForegroundColor Cyan
Write-Host "  ? Task will run $DelaySeconds seconds after Windows startup" -ForegroundColor Green
Write-Host "  ? Log file: $env:USERPROFILE\OpenClaw-Startup.log" -ForegroundColor Green
Write-Host "  ? Task runs as SYSTEM user" -ForegroundColor Green
Write-Host ""
Write-Host "Management Commands:" -ForegroundColor Cyan
Write-Host "  Manual start:    Start-ScheduledTask -TaskName '$TaskName'" -ForegroundColor White
Write-Host "  Disable task:    Disable-ScheduledTask -TaskName '$TaskName'" -ForegroundColor White
Write-Host "  Enable task:     Enable-ScheduledTask -TaskName '$TaskName'" -ForegroundColor White
Write-Host "  Remove task:     Unregister-ScheduledTask -TaskName '$TaskName' -Confirm:`$false" -ForegroundColor White
Write-Host ""
# 詢問是否立即測(cè)試
$response = Read-Host "Test the task now? (Y/N)"
if ($response -eq 'Y' -or $response -eq 'y') {
    Write-Host ""
    Write-Host "Starting task test..." -ForegroundColor Cyan
    Start-ScheduledTask -TaskName $TaskName
    Write-Host "? Task started. Please wait a few seconds..." -ForegroundColor Green
    Start-Sleep -Seconds 5
    if (Test-Path $env:USERPROFILE\OpenClaw-Startup.log) {
        Write-Host ""
        Write-Host "Recent log entries:" -ForegroundColor Cyan
        Get-Content $env:USERPROFILE\OpenClaw-Startup.log -Tail 15
    }
    Write-Host ""
    Write-Host "Test completed!" -ForegroundColor Green
}
Write-Host ""
$null = Read-Host "Press Enter to exit"

6.4.2 運(yùn)行配置腳本

右鍵點(diǎn)擊 PowerShell
選擇 “以管理員身份運(yùn)行”
執(zhí)行腳本：

F:\OpenClaw_Installed\創(chuàng)建任務(wù)計(jì)劃程序.ps1

按提示操作
選擇 Y 立即測(cè)試

6.4.3 驗(yàn)證任務(wù)創(chuàng)建

# 查看任務(wù)狀態(tài)
Get-ScheduledTask -TaskName "OpenClaw WSL AutoStart"
# 查看詳細(xì)信息
Get-ScheduledTaskInfo -TaskName "OpenClaw WSL AutoStart"

預(yù)期輸出：

Name                          State
----                          -----
OpenClaw WSL AutoStart        Ready

7. 驗(yàn)證與測(cè)試

7.1 完整驗(yàn)證清單

7.1.1 WSL 服務(wù)檢查

# 在 WSL Ubuntu 中執(zhí)行
# 1. 檢查服務(wù)狀態(tài)
systemctl --user status openclaw-gateway.service
# 2. 檢查是否啟用
systemctl --user is-enabled openclaw-gateway.service
# 輸出應(yīng)該: enabled
# 3. 檢查 linger 狀態(tài)
loginctl show-user $(whoami) | grep Linger
# 輸出應(yīng)該: Linger=yes
# 4. 檢查 Gateway 狀態(tài)
openclaw gateway status

預(yù)期輸出示例：

● openclaw-gateway.service - OpenClaw Gateway Service
   Loaded: loaded (/home/parobot/.config/systemd/user/openclaw-gateway.service; enabled)
   Active: active (running)
Service: systemd (enabled)
Gateway: running (pid 1234, state active)
Listening: 127.0.0.1:18789

7.1.2 Windows 任務(wù)檢查

# 在 PowerShell 中執(zhí)行
# 1. 查看任務(wù)狀態(tài)
Get-ScheduledTask -TaskName "OpenClaw WSL AutoStart"
# 2. 查看任務(wù)歷史
Get-ScheduledTaskInfo -TaskName "OpenClaw WSL AutoStart"
# 3. 查看日志文件
Get-Content $env:USERPROFILE\OpenClaw-Startup.log -Tail 20

7.1.3 網(wǎng)絡(luò)訪問測(cè)試

# 在瀏覽器中訪問
# http://127.0.0.1:18789/
# 或使用 curl 測(cè)試
curl http://127.0.0.1:18789/

7.2 重啟測(cè)試 (終極驗(yàn)證)

重啟 Windows：

Restart-Computer

等待 40-60 秒 (30 秒延遲 + WSL 啟動(dòng)時(shí)間)
檢查服務(wù)：

# 在 WSL 中
systemctl --user status openclaw-gateway.service

訪問 Dashboard：

打開瀏覽器訪問 http://127.0.0.1:18789/

檢查日志：

notepad $env:USERPROFILE\OpenClaw-Startup.log

7.3 性能檢查

# 檢查服務(wù)資源使用
systemctl --user show openclaw-gateway.service -p CPUUsage,MemoryCurrent
# 查看進(jìn)程
ps aux | grep openclaw
# 檢查端口監(jiān)聽
ss -tlnp | grep 18789

8. 常見問題排查

8.1 OpenClaw 安裝問題

問題 1: Node.js 版本不兼容

錯(cuò)誤信息：

error: openclaw@latest requires Node.js version >= 22.16

解決方案：

# 升級(jí) Node.js
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs
# 驗(yàn)證
node --version  # 應(yīng)該 >= 22.16

問題 2: npm 權(quán)限錯(cuò)誤

錯(cuò)誤信息：

npm ERR! code EACCES
npm ERR! syscall mkdir

解決方案：

# 方案 A: 修復(fù) npm 權(quán)限
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
# 方案 B: 使用 sudo (不推薦)
sudo npm install -g openclaw@latest --unsafe-perm

問題 3: sharp 庫(kù)構(gòu)建失敗

錯(cuò)誤信息：

sharp: Installation failed

解決方案：

# 安裝 sharp 依賴
sudo apt-get install -y libvips-dev
# 或忽略全局 libvips
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

8.2 網(wǎng)絡(luò)訪問問題

問題 4: 無法從 Windows 瀏覽器訪問

癥狀：WSL 中 OpenClaw 運(yùn)行正常，但瀏覽器無法訪問 localhost:18789

診斷步驟：

# 1. 在 WSL 中測(cè)試
curl http://127.0.0.1:18789/
# 2. 檢查端口監(jiān)聽
ss -tlnp | grep 18789
# 3. 檢查 Gateway 狀態(tài)
openclaw gateway status

解決方案：

# 方案 A: 配置端口轉(zhuǎn)發(fā) (Windows 10)
$wslIP = wsl hostname -I
netsh interface portproxy add v4tov4 listenport=18789 listenaddress=0.0.0.0 connectport=18789 connectaddress=$wslIP
New-NetFirewallRule -DisplayName "OpenClaw" -Direction Inbound -LocalPort 18789 -Protocol TCP -Action Allow
# 方案 B: 使用鏡像網(wǎng)絡(luò)模式 (Windows 11)
# 編輯 $env:USERPROFILE\.wslconfig
# 添加: networkingMode=mirrored
# 重啟: wsl --shutdown

8.3 開機(jī)自啟問題

問題 5: Windows 重啟后 OpenClaw 未啟動(dòng)

診斷步驟：

# 1. 檢查任務(wù)是否運(yùn)行
Get-ScheduledTask -TaskName "OpenClaw WSL AutoStart"
# 2. 查看任務(wù)歷史
Get-ScheduledTaskInfo -TaskName "OpenClaw WSL AutoStart"
# 3. 查看日志
Get-Content $env:USERPROFILE\OpenClaw-Startup.log -Tail 50
# 4. 手動(dòng)運(yùn)行測(cè)試
Start-ScheduledTask -TaskName "OpenClaw WSL AutoStart"
Start-Sleep -Seconds 10
Get-Content $env:USERPROFILE\OpenClaw-Startup.log -Tail 20

解決方案：

# 方案 A: 增加啟動(dòng)延遲時(shí)間
# 編輯任務(wù)計(jì)劃程序，將延遲從 30 秒改為 60 秒
# 方案 B: 檢查 linger 狀態(tài)
wsl -d Ubuntu-24.04 -- bash -c 'loginctl show-user $(whoami) | grep Linger'
# 如果輸出不是 Linger=yes，執(zhí)行:
wsl -d Ubuntu-24.04 -- bash -c 'loginctl enable-linger $(whoami)'
# 方案 C: 重新啟用服務(wù)
wsl -d Ubuntu-24.04 -- bash -c 'systemctl --user enable openclaw-gateway.service'

問題 6: 任務(wù)計(jì)劃程序任務(wù)失敗

錯(cuò)誤信息（在任務(wù)計(jì)劃程序歷史中）：

Task Start Failed

解決方案：

# 1. 檢查腳本路徑
Test-Path "F:\OpenClaw_Installed\啟動(dòng)OpenClaw.ps1"
# 2. 手動(dòng)測(cè)試腳本
powershell.exe -ExecutionPolicy Bypass -File "F:\OpenClaw_Installed\啟動(dòng)OpenClaw.ps1"
# 3. 檢查執(zhí)行策略
Get-ExecutionPolicy -List
# 設(shè)置為: RemoteSigned 或 Unrestricted
# 4. 重新創(chuàng)建任務(wù)
Unregister-ScheduledTask -TaskName "OpenClaw WSL AutoStart" -Confirm:$false
# 然后重新運(yùn)行創(chuàng)建腳本

問題 7: WSL 發(fā)行版名稱不正確

錯(cuò)誤信息：

WSL distro 'Ubuntu-24.04' not found

解決方案：

# 1. 列出所有 WSL 發(fā)行版
wsl --list --verbose
# 2. 修改啟動(dòng)腳本中的 WSL 發(fā)行版名稱
# 編輯 F:\OpenClaw_Installed\啟動(dòng)OpenClaw.ps1
# 將 $WSLDistro = "Ubuntu-24.04" 改為實(shí)際的名稱

問題 8: systemctl 命令失敗

錯(cuò)誤信息：

System has not been booted with systemd as init system

解決方案：

# 1. 檢查 WSL 版本 (必須是 WSL2)
wsl --version
# 2. 確保 systemd 已啟用
# 編輯 /etc/wsl.conf
sudo nano /etc/wsl.conf
# 添加:
# [boot]
# systemd=true
# 3. 重啟 WSL
# 在 PowerShell 中執(zhí)行:
wsl --shutdown
wsl -d Ubuntu-24.04
# 4. 驗(yàn)證
systemctl --user status

8.4 性能問題

問題 9: OpenClaw 啟動(dòng)緩慢

診斷：

# 查看啟動(dòng)時(shí)間
systemctl --user show openclaw-gateway.service -p ExecMainStartTimestamp
# 查看資源使用
top -p $(pgrep -f openclaw)

優(yōu)化方案：

# 1. 清理日志
> ~/.openclaw/logs/*.log
# 2. 減少插件數(shù)量
openclaw plugin list
# 卸載不需要的插件
# 3. 升級(jí)到最新版本
npm update -g openclaw@latest

9. 維護(hù)與管理

9.1 日常管理命令

9.1.1 WSL 服務(wù)管理

# 查看服務(wù)狀態(tài)
systemctl --user status openclaw-gateway.service
# 啟動(dòng)服務(wù)
systemctl --user start openclaw-gateway.service
# 停止服務(wù)
systemctl --user stop openclaw-gateway.service
# 重啟服務(wù)
systemctl --user restart openclaw-gateway.service
# 查看日志
journalctl --user -u openclaw-gateway.service -f
# 查看最近的錯(cuò)誤
journalctl --user -u openclaw-gateway.service -p err -n 20

9.1.2 Windows 任務(wù)管理

# 查看任務(wù)狀態(tài)
Get-ScheduledTask -TaskName "OpenClaw WSL AutoStart"
# 手動(dòng)啟動(dòng)任務(wù)
Start-ScheduledTask -TaskName "OpenClaw WSL AutoStart"
# 禁用任務(wù)
Disable-ScheduledTask -TaskName "OpenClaw WSL AutoStart"
# 啟用任務(wù)
Enable-ScheduledTask -TaskName "OpenClaw WSL AutoStart"
# 刪除任務(wù)
Unregister-ScheduledTask -TaskName "OpenClaw WSL AutoStart" -Confirm:$false
# 查看任務(wù)歷史
Get-ScheduledTaskInfo -TaskName "OpenClaw WSL AutoStart"

9.2 更新 OpenClaw

# 更新到最新版本
npm update -g openclaw@latest
# 或使用安裝腳本更新
curl -fsSL https://openclaw.ai/install.sh | bash
# 重啟服務(wù)
systemctl --user restart openclaw-gateway.service
# 驗(yàn)證版本
openclaw --version

9.3 備份與恢復(fù)

9.3.1 備份配置

# 創(chuàng)建備份目錄
mkdir -p ~/openclaw-backup-$(date +%Y%m%d)
# 備份配置文件
cp -r ~/.openclaw ~/openclaw-backup-$(date +%Y%m%d)/
cp -r ~/.config/systemd/user/openclaw-gateway.service ~/openclaw-backup-$(date +%Y%m%d)/
# 備份 npm 全局包
npm list -g --depth=0 > ~/openclaw-backup-$(date +%Y%m%d)/npm-global-list.txt

9.3.2 恢復(fù)配置

# 停止服務(wù)
systemctl --user stop openclaw-gateway.service
# 恢復(fù)配置
cp -r ~/openclaw-backup-YYYYMMDD/.openclaw ~/
cp ~/openclaw-backup-YYYYMMDD/openclaw-gateway.service ~/.config/systemd/user/
# 重啟服務(wù)
systemctl --user daemon-reload
systemctl --user start openclaw-gateway.service

9.4 日志管理

9.4.1 查看日志

# OpenClaw 日志
openclaw logs
# systemd 日志
journalctl --user -u openclaw-gateway.service -n 100
# 實(shí)時(shí)日志
journalctl --user -u openclaw-gateway.service -f
# Windows 啟動(dòng)日志
# 在 PowerShell 中:
notepad $env:USERPROFILE\OpenClaw-Startup.log

9.4.2 清理日志

# 清理舊日志 (保留最近 7 天)
find ~/.openclaw/logs/ -name "*.log" -mtime +7 -delete
# 清空 systemd 日志
journalctl --user --rotate --vacuum-time=7d

9.5 監(jiān)控與告警

創(chuàng)建簡(jiǎn)單的監(jiān)控腳本：~/check-openclaw.sh

#!/bin/bash
# OpenClaw Health Check Script
SERVICE_NAME="openclaw-gateway.service"
PORT=18789
ALERT_EMAIL="your-email@example.com"
# 檢查服務(wù)狀態(tài)
if ! systemctl --user is-active --quiet "$SERVICE_NAME"; then
    echo "[$(date)] Service $SERVICE_NAME is not running" >> ~/openclaw-health.log
    systemctl --user start "$SERVICE_NAME"
    # 發(fā)送告警郵件 (需要配置 mailx)
    # echo "OpenClaw service was restarted" | mailx -s "OpenClaw Alert" $ALERT_EMAIL
fi
# 檢查端口監(jiān)聽
if ! ss -tlnp | grep -q ":$PORT "; then
    echo "[$(date)] Port $PORT is not listening" >> ~/openclaw-health.log
fi
echo "[$(date)] Health check passed" >> ~/openclaw-health.log

添加到 cron：

# 編輯 crontab
crontab -e
# 添加: 每 5 分鐘檢查一次
*/5 * * * * ~/check-openclaw.sh

10. 卸載指南

10.1 完全卸載 OpenClaw

10.1.1 停止并禁用服務(wù)

# 停止 OpenClaw 服務(wù)
systemctl --user stop openclaw-gateway.service
systemctl --user disable openclaw-gateway.service
# 停止所有 OpenClaw 進(jìn)程
pkill -f openclaw

10.1.2 卸載 OpenClaw

# 使用 npm 卸載
npm uninstall -g openclaw
# 或手動(dòng)刪除
rm -rf ~/.npm-global/lib/node_modules/openclaw
rm -f ~/.npm-global/bin/openclaw

10.1.3 刪除配置和數(shù)據(jù)

# 刪除配置文件
rm -rf ~/.openclaw
rm -rf ~/.config/systemd/user/openclaw-gateway.service
# 刪除數(shù)據(jù)
rm -rf ~/.local/share/openclaw
rm -rf ~/.local/state/openclaw
# 刪除日志
rm -rf /tmp/openclaw

10.1.4 刪除 Windows 任務(wù)計(jì)劃程序

# 在 PowerShell (管理員) 中執(zhí)行
Unregister-ScheduledTask -TaskName "OpenClaw WSL AutoStart" -Confirm:$false

10.1.5 刪除啟動(dòng)腳本

# 刪除腳本文件
Remove-Item F:\OpenClaw_Installed\啟動(dòng)OpenClaw.ps1
Remove-Item F:\OpenClaw_Installed\創(chuàng)建任務(wù)計(jì)劃程序.ps1
# 刪除日志
Remove-Item $env:USERPROFILE\OpenClaw-Startup.log

10.2 重新安裝

如果需要重新安裝：

# 清理 (可選)
npm cache clean --force
# 重新安裝
curl -fsSL https://openclaw.ai/install.sh | bash
# 運(yùn)行配置向?qū)?
openclaw onboard --install-daemon
# 重新配置開機(jī)自啟
# 按照第 6 節(jié)的步驟重新配置

附錄 A: 快速參考

A.1 常用端口

服務(wù)	默認(rèn)端口	訪問地址
OpenClaw Gateway	18789	http://127.0.0.1:18789/
OpenClaw Web UI	18789	http://127.0.0.1:18789/

A.2 重要路徑

類型	WSL 路徑	Windows 路徑
配置文件	`~/.openclaw/`	`\\wsl$\Ubuntu-24.04\home\user\.openclaw\`
日志文件	`~/.local/state/openclaw/logs/`	`\\wsl$\Ubuntu-24.04\home\user\.local\state\openclaw\logs\`
服務(wù)文件	`~/.config/systemd/user/`	`\\wsl$\Ubuntu-24.04\home\user\.config\systemd\user\`
啟動(dòng)日志	-	`%USERPROFILE%\OpenClaw-Startup.log`

A.3 命令速查表

# === WSL 命令 ===
# 查看服務(wù)狀態(tài)
systemctl --user status openclaw-gateway.service
# 啟動(dòng)/停止/重啟
systemctl --user start|stop|restart openclaw-gateway.service
# 查看 Gateway 狀態(tài)
openclaw gateway status
# 查看日志
journalctl --user -u openclaw-gateway.service -f
# === PowerShell 命令 ===
# 查看 Windows 任務(wù)
Get-ScheduledTask -TaskName "OpenClaw WSL AutoStart"
# 手動(dòng)啟動(dòng)任務(wù)
Start-ScheduledTask -TaskName "OpenClaw WSL AutoStart"
# 查看啟動(dòng)日志
Get-Content $env:USERPROFILE\OpenClaw-Startup.log -Tail 20
# 重啟 WSL
wsl --shutdown
wsl -d Ubuntu-24.04

附錄 B: 故障排查流程圖

OpenClaw 無法訪問
    │
    ├─→ 在 WSL 中測(cè)試: curl http://127.0.0.1:18789/
    │   │
    │   ├→ 成功 → 問題在 Windows 層
    │   │   ├─→ 檢查 Windows 防火墻
    │   │   ├─→ 配置端口轉(zhuǎn)發(fā) (Windows 10)
    │   │   └─→ 啟用鏡像網(wǎng)絡(luò)模式 (Windows 11)
    │   │
    │   └→ 失敗 → 問題在 WSL 層
    │       ├─→ 檢查服務(wù)狀態(tài)
    │       ├─→ 重啟服務(wù)
    │       └─→ 檢查日志
    │
    ├─→ 檢查服務(wù)狀態(tài)
    │   ├─→ inactive (未運(yùn)行)
    │   │   ├─→ systemctl --user start openclaw-gateway.service
    │   │   └─→ 檢查錯(cuò)誤日志
    │   │
    │   ├─→ failed (失敗)
    │   │   ├─→ journalctl --user -u openclaw-gateway.service -p err
    │   │   └─→ 修復(fù)配置后重啟
    │   │
    │   └─→ active (運(yùn)行中)
    │       └─→ 檢查端口監(jiān)聽: ss -tlnp | grep 18789
    │
    └─→ 開機(jī)未啟動(dòng)
        ├─→ 檢查 Windows 任務(wù)
        ├─→ 檢查 linger 狀態(tài)
        ├─→ 檢查服務(wù)是否啟用
        └─→ 查看啟動(dòng)日志

附錄 C: 安全最佳實(shí)踐

C.1 訪問控制

? OpenClaw 默認(rèn)監(jiān)聽 127.0.0.1，僅本機(jī)可訪問
? 不要修改為 0.0.0.0 暴露到公網(wǎng)
? 使用 Windows 防火墻限制訪問
? 配置 WSL 防火墻 (ufw) 限制入站

C.2 密鑰管理

# 使用環(huán)境變量管理 API 密鑰
cat > ~/.openclaw/.env << EOF
OPENAI_API_KEY=your_key_here
ANTHROPIC_API_KEY=your_key_here
EOF
# 設(shè)置文件權(quán)限
chmod 600 ~/.openclaw/.env

C.3 更新與維護(hù)

? 定期更新 OpenClaw: npm update -g openclaw@latest
? 定期更新系統(tǒng)包: sudo apt update && sudo apt upgrade
? 定期審查日志: journalctl --user -u openclaw-gateway.service -p err
? 定期備份配置

C.4 日志審計(jì)

# 查看最近的認(rèn)證嘗試
journalctl --user -u openclaw-gateway.service -n 1000 | grep -i auth
# 檢查異常訪問
journalctl --user -u openclaw-gateway.service --since "1 hour ago"

總結(jié)

本指南提供了完整的 OpenClaw 在 Windows WSL2 環(huán)境中的部署和開機(jī)自啟動(dòng)配置方案。

關(guān)鍵要點(diǎn)

安裝：使用官方腳本或 npm 安裝 OpenClaw
網(wǎng)絡(luò)：WSL2 自動(dòng) localhost 轉(zhuǎn)發(fā)，Windows 11 無需額外配置
開機(jī)自啟：
- WSL 層：systemd 用戶服務(wù) + linger
- Windows 層：任務(wù)計(jì)劃程序
維護(hù)：定期更新、備份和監(jiān)控

獲取幫助

官方文檔: https://docs.openclaw.ai
GitHub Issues: https://github.com/openclaw/openclaw/issues
社區(qū)論壇: https://discord.gg/openclaw

文檔維護(hù): 本文檔會(huì)根據(jù) OpenClaw 版本更新持續(xù)維護(hù)。如發(fā)現(xiàn)問題或有改進(jìn)建議，歡迎提交 Issue 或 Pull Request。

最后更新: 2026-03-22
適用版本: OpenClaw 2026.3.13+, Windows 10/11, WSL2, Ubuntu 20.04/22.04/24.04

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

Tag：OpenClaw 安裝自啟部署

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线

OpenClaw從安裝到開機(jī)自啟完整部署指南

目錄

OpenClaw 完整部署指南：Windows WSL2 環(huán)境安裝與開機(jī)自啟動(dòng)配置

1. 概述

1.1 為什么選擇 WSL2 部署？

2. 系統(tǒng)要求

2.1 硬件要求

2.2 軟件要求

2.3 檢查系統(tǒng)環(huán)境

3. 架構(gòu)說明

3.1 整體架構(gòu)圖

3.2 啟動(dòng)流程詳解

3.3 關(guān)鍵技術(shù)點(diǎn)

4. 第一部分：安裝 OpenClaw

4.1 安裝 WSL2

4.1.1 啟用 WSL

4.1.2 設(shè)置 WSL2 為默認(rèn)

4.1.3 安裝 Ubuntu

4.1.4 初始化 Ubuntu

4.2 配置 WSL2 Ubuntu

4.2.1 更新系統(tǒng)包

4.2.2 驗(yàn)證安裝

4.3 安裝 Node.js

4.3.1 方法 A：使用 NodeSource (推薦)

4.3.2 方法 B：使用 nvm (Node Version Manager)

4.4 安裝 OpenClaw

4.4.1 方法 A：使用官方安裝腳本 (最簡(jiǎn)單)

4.4.2 方法 B：使用 npm 安裝

4.4.3 驗(yàn)證安裝

4.4.4 配置 OpenClaw

5. 第二部分：配置網(wǎng)絡(luò)訪問

5.1 檢查當(dāng)前網(wǎng)絡(luò)配置

5.2 從 Windows 訪問

5.3 WSL2 網(wǎng)絡(luò)模式說明

5.4 手動(dòng)配置端口轉(zhuǎn)發(fā) (Windows 10)

5.5 配置鏡像網(wǎng)絡(luò)模式 (高級(jí)，Windows 11 22H2+)

6. 第三部分：配置開機(jī)自啟動(dòng)

6.1 理解自動(dòng)啟動(dòng)機(jī)制

6.1.1 為什么需要雙層機(jī)制？

6.1.2 OpenClaw 的服務(wù)架構(gòu)

6.2 配置 WSL 層服務(wù)

6.2.1 檢查現(xiàn)有服務(wù)

6.2.2 手動(dòng)啟用服務(wù) (如果未啟用)

6.2.3 配置 linger (保持用戶服務(wù)運(yùn)行)

6.3 創(chuàng)建 Windows 啟動(dòng)腳本

6.3.1 創(chuàng)建腳本文件

6.3.2 測(cè)試腳本

6.3.3 檢查日志

6.4 配置 Windows 任務(wù)計(jì)劃程序

6.4.1 創(chuàng)建任務(wù)配置腳本

6.4.2 運(yùn)行配置腳本

6.4.3 驗(yàn)證任務(wù)創(chuàng)建

7. 驗(yàn)證與測(cè)試

7.1 完整驗(yàn)證清單

7.1.1 WSL 服務(wù)檢查

7.1.2 Windows 任務(wù)檢查

7.1.3 網(wǎng)絡(luò)訪問測(cè)試

7.2 重啟測(cè)試 (終極驗(yàn)證)

7.3 性能檢查

8. 常見問題排查

8.1 OpenClaw 安裝問題

問題 1: Node.js 版本不兼容

問題 2: npm 權(quán)限錯(cuò)誤

問題 3: sharp 庫(kù)構(gòu)建失敗

8.2 網(wǎng)絡(luò)訪問問題

問題 4: 無法從 Windows 瀏覽器訪問

8.3 開機(jī)自啟問題

問題 5: Windows 重啟后 OpenClaw 未啟動(dòng)

問題 6: 任務(wù)計(jì)劃程序任務(wù)失敗

問題 7: WSL 發(fā)行版名稱不正確

問題 8: systemctl 命令失敗

8.4 性能問題

問題 9: OpenClaw 啟動(dòng)緩慢

9. 維護(hù)與管理

9.1 日常管理命令

9.1.1 WSL 服務(wù)管理

9.1.2 Windows 任務(wù)管理

9.2 更新 OpenClaw

9.3 備份與恢復(fù)

1.1 為什么選擇 WSL2 部署？