Windows 环境下 Clawdbot Gateway 持久化运行避坑指南
Windows 环境下 Clawdbot Gateway 持久化运行避坑指南
环境：Windows 11 + Node.js 24.9.0 + Clawdbot 2026.1.24-3
目标：实现 Clawdbot Gateway 开机自启、后台持久运行
核心结论：绕过.cmd包装器，直接启动 JS 入口 + 启动文件夹脚本 = 100% 可靠方案
📌 问题背景
在 Windows 环境开发 Clawdbot 时，遇到以下连锁问题：
| 问题 | 表现 | 根本原因 |
|---|---|---|
| Gateway 服务安装失败 | schtasks create failed: 拒绝访问 | 需管理员权限创建系统服务 |
PM2 启动 .cmd 失败 | SyntaxError: Invalid or unexpected token | PM2 用 Node.js 解析批处理文件 |
pm2 resurrect 无效 | 恢复后进程仍为 stopped | 保存了错误的进程状态快照 |
pm2 startup 报错 | Init system not found | Windows 无标准 init 系统，该命令仅适用于 Linux |
⚠️ 踩坑记录（按时间线）
坑点 1：Gateway 服务安装权限问题
Gateway service install failed: schtasks create failed: : ܾʡ 根因：安装系统服务需创建 Windows 计划任务（schtasks），必须管理员权限。
临时绕过方案：
# 以普通用户身份手动启动（无需管理员） clawdbot onboard ✅ 优点：快速启动
❌ 缺点：关闭终端 → 服务立即退出
坑点 2：PM2 启动 .cmd 文件的 4 种失败方式
❌ 失败方式 1：参数顺序错误（-- 分隔符误用）
# 错误：--interpreter 在 -- 之后 → 被当作脚本参数 pm2 start "clawdbot.cmd" --name "clawdbot" -- onboard --interpreter shell 原理：-- 是分隔符，之前是 PM2 参数，之后是传递给脚本的
