必须先禁用并删除现有自启任务、清理残留进程与lock文件，再以system账户创建带清理逻辑的powershell开机任务，才能实现aionclaw稳定自启。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让 AionClaw 在电脑开机后自动启动并后台运行，避免每次手动双击、重复登录、Dashboard 手动打开、残留进程报错“already running (pid xxx)”，必须绕过默认安装脚本的简化逻辑，直击 Windows 系统级自启入口——任务计划程序，并配合进程清理与非静默启动策略。AionClaw 作为 OpenClaw 的商业发行版，其自启行为完全继承底层机制，但默认安装不处理 lock 文件残留、无管理员权限、不清理旧 Node 进程，导致自启失败率极高。
定位当前自启入口并彻底清空
第一步不是新建任务，而是确认 AionClaw 当前是否已被注册为自启项。打开任务计划程序（taskschd.msc）→ 左侧导航栏点“任务计划程序库”→ 在右侧列表中搜索关键词 openclaw 或 aionclaw。若存在相关任务，右键→“禁用”，再右键→“删除”。这一步必须做，否则新任务会和旧任务冲突，系统可能随机执行其中一个，造成 PID 冲突或端口占用假象。
接着清空残留：按 Ctrl+Shift+Esc 打开任务管理器 → 切换到“详细信息”页 → 排序“映像名称”，找到所有 node.exe 和 aionclaw.exe 进程 → 全选 → 右键“结束任务”。这一步不能跳过，否则 lock 文件不会被释放，新启动必然报 already running。
最后手动删 lock 文件：打开文件资源管理器，地址栏粘贴 %LOCALAPPDATA%\AionClaw\gateway\lock → 删除该目录下全部内容（通常只有一个 .lock 文件）。【不删 lock 文件，任何自启方案都会在第二秒失败】
创建带清理逻辑的 PowerShell 启动脚本
新建文本文档，重命名为 startup.ps1，用记事本或 VS Code 打开，粘贴以下内容（注意替换你的实际安装路径）：
```powershell
# 设置执行策略（仅首次运行需管理员权限执行一次）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
# 强制终止残留进程树
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, aionclaw -ErrorAction SilentlyContinue | ForEach-Object { Stop-ProcessTree $_.Id }
# 清理 lock 目录
Remove-Item "$env:LOCALAPPDATA\AionClaw\gateway\lock" -Recurse -Force -ErrorAction SilentlyContinue
# 启动 AionClaw Gateway（非静默模式，带终端日志）
Start-Process powershell -ArgumentList "-NoExit -Command & '$env:LOCALAPPDATA\AionClaw\bin\aionclaw.exe' gateway start --port 18789"
```
保存后，右键该文件 → “使用 PowerShell 运行”，验证是否能干净启动且终端窗口弹出日志。如果报错“无法加载脚本”，说明执行策略未放开，需以管理员身份运行 PowerShell，执行第一行命令后再试。
通过任务计划程序配置开机自启
步骤一：打开任务计划程序（taskschd.msc）→ 右侧“创建基本任务…” → 命名填 AionClaw AutoStart → 描述可写“开机自动拉起 AionClaw 网关并清理残留”。
步骤二：触发器选“计算机启动时” → 操作选“启动程序” → “程序或脚本”浏览到你刚保存的 startup.ps1 文件 → “起始于”填该脚本所在文件夹完整路径（例如：C:\ProgramData\AionClaw\）。
步骤三：勾选“不管用户是否登录都要运行” → 勾选“不存储密码（只限本地系统账户）” → 点击“更改用户或组…” → 输入 SYSTEM → 检查名称 → 确定。这一步最关键：【必须用 SYSTEM 账户，否则无法访问 %LOCALAPPDATA% 下的 AionClaw 目录，脚本直接静默失败】
步骤四：点击“完成”。此时任务已注册，但尚未生效。重启电脑前，先在任务计划程序中右键该任务 → “运行”，观察终端是否弹出、Dashboard 是否自动打开 http://127.0.0.1:18789。若成功，即可断定配置无误。
