OpenClaw 守护进程与开机自启:LaunchAgent、systemd 与 Windows 计划任务
AI 助手的价值一半来自「随时在线」。网关必须常驻,心跳、定时任务、渠道消息这些功能才有意义。这一页讲怎么让它像服务一样活着。
官方推荐路径
新手引导带上 --install-daemon 参数时,会自动安装对应的系统服务;事后想补装也可以单独执行网关服务安装命令。
各平台的机制
- macOS:LaunchAgent 用户级服务。登录后自动拉起,不需要管理员权限。
- Linux / WSL2:systemd 用户服务。服务器上最稳的方式,配合 journalctl 看日志。
- Windows 原生:优先使用计划任务;如果计划任务创建被策略拒绝,官方的回退方案是往当前用户的「启动」文件夹放登录项。
- Docker 部署:容器本身就是守护进程,配合主机的重启策略实现自启。
日常管理命令
openclaw gateway status # 看运行状态
openclaw gateway restart # 改完配置后重启
openclaw gateway install # 安装/重装系统服务
常驻之后的两个提醒
- 服务器部署要留神休眠策略:某些 VPS 或 NAS 会在空闲时休眠,心跳就再也不会响了;把机器设为永不睡眠是服务端部署的标准动作。
- 升级后记得重启服务:更新 CLI 之后旧网关进程仍在内存里跑,执行一次 gateway restart 才会切换到新版本。
判断服务是否健康
openclaw gateway status --deep 做深度体检(配置、插件、连通性一起查);只想快速确认进程活着用普通 status 就够。日志用 openclaw logs --follow 实时跟。