OpenClaw Gateway 开机自启 + 自动打开 Dashboard 完整解决方案（非静默版）
最近在部署 OpenClaw Gateway 的过程中遇到了几个麻烦：
- 手动启动不稳定
- 每次启动 Gateway 都会提示
already running (pid xxx) - 必须手动去杀掉残留 PID，并删除 lock 文件，才能重新启动
- 每次启动 Gateway 都会提示
- 计划任务自启动失败
- 用
openclaw gateway install创建计划任务时，报错系统找不到指定的文件或权限问题 - 放在
C:\Windows\System32下又遇到访问权限问题
- 用
- 静默启动的问题
- 默认后台静默启动时，终端看不到日志
- Dashboard 不会自动打开，需要手动访问
- 启动失败或者端口冲突时，很难发现
问题分析
总结下来，主要问题有三个：
- PID / lock 文件残留 → 导致
already running - Windows 权限限制 → System32 无法随意写文件，需要管理员
- 静默模式 → 虽然方便无人值守，但启动失败不易察觉
因此，需要一个 既能开机自启，又能自动打开 Dashboard，同时避免 already running 的方案。
让 OpenClaw Gateway 可以在 Windows 上实现 开机自动启动，同时 自动打开默认浏览器访问 Dashboard，并且可以看到终端输出，避免静默模式带来的问题。
核心目标
- 开机自动启动 Gateway
- 延时启动，保证系统初始化完成
- 清理残留 Node/OpenClaw 进程 & lock 文件
- 非静默终端，直接显示日志
- 自动打开默认浏览器访问 Dashboard
- 创建计划任务，开机自动运行脚本
以下是优化后的 OpenClaw Gateway Windows 自动启动方案的技术实现细节，整合了进程管理、计划任务和用户体验的完整闭环：
核心组件部署
脚本路径建议标准化为 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" }
