OpenClaw Gateway Windows 开机自启与 Dashboard 自动打开方案

最近在部署 OpenClaw Gateway 的过程中遇到了几个常见问题：

手动启动不稳定：每次启动都会提示 already running (pid xxx)，需手动杀掉残留 PID 并删除 lock 文件。
计划任务自启动失败：使用 openclaw gateway install 创建计划任务时可能报错或遇到权限问题。
静默启动的问题：默认后台静默启动时终端看不到日志，Dashboard 不会自动打开，启动失败难以发现。

问题分析

主要问题集中在以下三点：

PID / lock 文件残留：导致 already running 错误。
Windows 权限限制：System32 无法随意写文件，需要管理员权限。
静默模式：虽然方便无人值守，但启动失败不易察觉。

因此，需要一个既能开机自启，又能自动打开 Dashboard，同时避免 already running 的方案。本方案旨在让 OpenClaw Gateway 在 Windows 上实现开机自动启动，同时自动打开默认浏览器访问 Dashboard，并显示终端输出。

核心目标

开机自动启动 Gateway
延时启动，保证系统初始化完成
清理残留 Node/OpenClaw 进程 & lock 文件
非静默终端，直接显示日志
自动打开默认浏览器访问 Dashboard
创建计划任务，开机自动运行脚本

核心组件部署

脚本路径建议标准化为 C:\ProgramData\OpenClaw\startup.ps1，避免用户路径依赖。需创建目录并设置权限：

New-Item -Path "C:\ProgramData\OpenClaw" -ItemType Directory -Force
$acl = Get-Acl "C:\ProgramData\OpenClaw"
$acl.SetAccessRuleProtection($true, $false)
Set-Acl -Path "C:\ProgramData\OpenClaw" -AclObject $acl

增强型进程清理

采用递归方式终止相关进程树：

function Stop-ProcessTree {
    param($pid)
    Get-CimInstance Win32_Process | Where-Object { $_.ParentProcessId -eq $pid } | ForEach-Object { Stop-ProcessTree $_.ProcessId }
    Stop-Process -Id $pid -Force -ErrorAction SilentlyContinue
}
Get-Process -Name node,openclaw -ErrorAction SilentlyContinue | ForEach-Object { Stop-ProcessTree $_.Id }

智能锁文件处理

增加文件存在性验证和日志记录：

$LockFiles = @( "$env:USERPROFILE\.openclaw\gateway.lock", "$env:LOCALAPPDATA\Temp\openclaw\*.lock" )
foreach ($file in $LockFiles) {
    if (Test-Path $file) {
        Remove-Item $file -Force
        Add-Content -Path "$env:ProgramData\OpenClaw\cleanup.log" -Value "$(Get-Date) Removed: $file"
    }
}

计划任务优化配置

使用 PowerShell 原生命令创建更可靠的任务：

$action = New-ScheduledTaskAction -Execute "powershell.exe" -Argument "-NoProfile -ExecutionPolicy Bypass -File `"C:\ProgramData\OpenClaw\startup.ps1`""
$trigger = New-ScheduledTaskTrigger -AtLogOn -RandomDelay (New-TimeSpan -Seconds 30)
$settings = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable
Register-ScheduledTask -TaskName "OpenClaw Gateway" -Action $action -Trigger $trigger -Settings $settings -RunLevel Highest -Force

浏览器启动容错机制

增加端口检测和重试逻辑：

$maxRetries = 3
$retryInterval = 5
do {
    try {
        Start-Process "http://127.0.0.1:18789"
        break
    } catch {
        Start-Sleep -Seconds $retryInterval
        $maxRetries--
    }
} while ($maxRetries -gt 0)

日志监控增强

建议在启动命令中添加实时日志输出：

Start-Process powershell -ArgumentList "-NoExit", "openclaw gateway --log-level debug" -WindowStyle Normal

验证与调试

创建验证脚本 verify.ps1：

$task = Get-ScheduledTask -TaskName "OpenClaw Gateway" -ErrorAction SilentlyContinue
if ($task) {
    Write-Output "计划任务状态：$($task.State)"
    Write-Output "最后运行结果：$(Get-EventLog -LogName Microsoft-Windows-TaskScheduler/Operational -InstanceId 110 -Newest 1 | Select-Object -ExpandProperty Message)"
}

卸载方案

创建对应的清理脚本：

Unregister-ScheduledTask -TaskName "OpenClaw Gateway" -Confirm:$false
Remove-Item -Path "C:\ProgramData\OpenClaw" -Recurse -Force

该方案通过系统级目录部署、进程树终止、计划任务健壮性增强和多重验证机制，实现了生产环境可用的自动化部署方案。日志记录和验证脚本为运维提供了有效工具，而卸载脚本则完善了生命周期管理。

总脚本示例

保存为 C:\Users\Administrator\start_openclaw.ps1：

# 延时启动（秒）
$delaySeconds = 5
# 检查管理员权限
$principal = New-Object Security.Principal.WindowsPrincipal([Security.Principal.WindowsIdentity]::GetCurrent())
if (-not $principal.IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) {
    Write-Warning "Please run this script as Administrator."
    exit
}
Start-Sleep -Seconds $delaySeconds
# 杀掉残留 Node/OpenClaw 进程
Get-Process node -ErrorAction SilentlyContinue | ForEach-Object { Stop-Process $_.Id -Force }
# 删除 lock 文件
$LockFiles = @( "$env:USERPROFILE\.openclaw\gateway.lock", "$env:LOCALAPPDATA\Temp\openclaw\*.lock" )
foreach ($file in $LockFiles) {
    Remove-Item $file -Force -ErrorAction SilentlyContinue
}
# 启动 Gateway（终端可见）
Start-Process powershell -ArgumentList "openclaw gateway" -WindowStyle Normal
# 自动打开 Dashboard
$dashboardURL = "http://127.0.0.1:18789"
Start-Process $dashboardURL
# 创建开机自启计划任务
$taskName = "OpenClaw Gateway AutoStart"
$scriptPath = "$env:USERPROFILE\start_openclaw.ps1"
$taskExists = schtasks /Query /TN $taskName 2>$null
if (-not $taskExists) {
    schtasks /Create /TN $taskName `
    /TR "powershell -ExecutionPolicy Bypass -File `"$scriptPath`"" `
    /SC ONLOGON `
    /RL HIGHEST `
    /F
    Write-Host "Scheduled task created: $taskName"
} else {
    Write-Host "Scheduled task already exists: $taskName"
}

OpenClaw Gateway Windows 开机自启与 Dashboard 自动打开方案