openclaw daemon

用于 Gateway 网关服务管理的旧版别名。openclaw daemon ... 映射到与 openclaw gateway ... 相同的服务控制命令。当前文档和示例请优先参阅 openclaw gateway。

用法

openclaw daemon statusopenclaw daemon installopenclaw daemon startopenclaw daemon stopopenclaw daemon restartopenclaw daemon uninstall

子命令和选项

• status：显示服务安装状态（launchd/systemd/schtasks）并探测 Gateway 健康。
• install：安装服务；--force 会重新安装或覆盖现有安装。
• restart --safe：请求正在运行的 Gateway 网关预检活动工作，并在工作清空后安排一次合并重启，等待时间受 gateway.reload.deferralTimeoutMs 限制（默认 300000ms/5 分钟；设为 0 可无限期等待）。该时间预算到期后，仍会强制重启。普通的 restart 会直接使用服务管理器；--force 是立即执行的覆盖选项。
• restart --safe --skip-deferral：绕过活动工作延迟门控，即使报告了阻塞项，也会立即重启 Gateway 网关。需要 --safe。

说明

• status 会在可能的情况下解析已配置的身份验证 SecretRef，以用于探测身份验证。如果必需的 SecretRef 未解析，status --json 会报告 rpc.authWarning；请显式传入 --token/--password，或先解析密钥来源。如果探测在其他方面成功，则不会显示未解析身份验证警告。
• status --deep 会额外执行尽力而为的系统级扫描，以查找其他类似 Gateway 网关的服务（输出清理提示；仍建议每台机器仅运行一个 Gateway 网关），并以插件感知模式运行配置验证，显示快速默认路径会跳过的插件清单警告。
• 在 Linux systemd 安装中，令牌漂移检查会检查 Environment= 和 EnvironmentFile= 两种单元来源。
• 令牌漂移检查使用合并后的运行时环境变量解析 gateway.auth.token SecretRef（先使用服务命令环境变量，再使用进程环境变量）。如果令牌身份验证实际上未启用（gateway.auth.mode 为 password/none/trusted-proxy，或者未设置且密码可优先采用），则跳过配置令牌解析。
• install 会验证由 SecretRef 管理的 gateway.auth.token 是否可解析，但绝不会将解析后的值持久化到服务环境元数据中；如果无法解析，安装会以关闭方式失败。
• 如果同时配置了 gateway.auth.token 和 gateway.auth.password，但未设置 gateway.auth.mode，则 install 会阻塞，直到你显式设置模式。
• 在 macOS 上，install 会将 LaunchAgent plist 以及生成的环境文件/包装器设为仅所有者可访问（模式 0600/0700），而不是将密钥嵌入 EnvironmentVariables。
• 在一台主机上运行多个 Gateway 网关：隔离端口、配置/状态和工作区。请参阅多个 Gateway 网关。

相关内容

• CLI 参考
• Gateway 网关运行手册