Windows 下让 OpenClaw Gateway 开机自启并自动打开 Dashboard

$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)

Dashboard 默认地址是 http://127.0.0.1:18789，如果你本地改过端口，就把这里同步掉。

启动时保留日志窗口

静默启动省事，但排障时很难受。我更倾向于让终端保持打开，至少第一次配置时能直接看到输出。

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

验证任务是否真的生效

计划任务建成功不代表执行没问题，最好还是单独写个检查脚本看状态。能省掉很多'明明创建了但就是没跑'的猜测。

$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"
}

这套方案的重点不在于'自动化得多漂亮'，而是把几个常见的不稳定点都兜住：残留进程先处理，lock 文件先清掉，计划任务用系统级方式托管，Dashboard 再单独拉起。对 Windows 环境来说，这比直接让 Gateway 自己静默跑要靠谱一些。