快速开始
守护进程
openclaw daemon
Gateway 网关服务管理命令的旧版别名。
openclaw daemon ... 映射到与 openclaw gateway ... 服务命令相同的服务控制面。
用法
openclaw daemon statusopenclaw daemon installopenclaw daemon startopenclaw daemon stopopenclaw daemon restartopenclaw daemon uninstall子命令
status：显示服务安装状态并探测 Gateway 网关健康状态install：安装服务（launchd/systemd/schtasks）uninstall：移除服务start：启动服务stop：停止服务restart：重启服务
常用选项
status：--url、--token、--password、--timeout、--no-probe、--require-rpc、--deep、--jsoninstall：--port、--runtime <node|bun>、--token、--force、--jsonrestart：--safe、--skip-deferral、--force、--wait <duration>、--json- 生命周期（
uninstall|start|stop）：--json
说明：
status会在可行时解析已配置的探测认证 SecretRefs。- 如果此命令路径中必需的认证 SecretRef 未解析，且探测连接性/认证失败，
daemon status --json会报告rpc.authWarning；请显式传入--token/--password，或先解析密钥来源。 - 如果探测成功，会抑制未解析认证引用警告以避免误报。
status --deep会添加一次尽力而为的系统级服务扫描。当它发现其他类似 Gateway 网关的服务时，人类可读输出会打印清理提示，并警告每台机器一个 Gateway 网关仍然是常规建议。status --deep还会以插件感知模式运行配置验证，并暴露已配置的插件清单警告（例如缺少渠道配置元数据），以便安装和更新冒烟检查能够捕获这些问题。默认status保持快速只读路径，跳过插件验证。- 在 Linux systemd 安装中，
statustoken 漂移检查会同时包含Environment=和EnvironmentFile=单元来源。 - 漂移检查会使用合并后的运行时环境解析
gateway.auth.tokenSecretRefs（先使用服务命令环境，再回退到进程环境）。 - 如果 token 认证没有实际启用（显式
gateway.auth.mode为password/none/trusted-proxy，或者模式未设置且 password 可以胜出、并且没有 token 候选可以胜出），token 漂移检查会跳过配置 token 解析。 - 当 token 认证需要 token 且
gateway.auth.token由 SecretRef 管理时，install会验证该 SecretRef 可解析，但不会将解析后的 token 持久化到服务环境元数据中。 - 如果 token 认证需要 token 且已配置的 token SecretRef 未解析，安装会失败并关闭。
- 如果同时配置了
gateway.auth.token和gateway.auth.password，并且gateway.auth.mode未设置，安装会被阻止，直到显式设置模式。 - 在 macOS 上，
install会保持 LaunchAgent plist 仅限所有者，并通过仅限所有者的文件和包装器加载托管服务环境值，而不是将 API key 或认证配置文件环境引用序列化到EnvironmentVariables。 - 如果你有意在一台主机上运行多个 Gateway 网关，请隔离端口、配置/状态和工作区；参见 /gateway#multiple-gateways-same-host。
restart --safe会要求正在运行的 Gateway 网关预检活动工作，并在活动工作排空后调度一次合并后的重启。普通restart保持现有服务管理器行为；--force仍然是立即覆盖路径。restart --safe --skip-deferral会运行 OpenClaw 感知的安全重启，但绕过活动工作延迟门控，因此即使报告了阻塞项，Gateway 网关也会立即发出重启。当卡住的任务运行固定住安全重启时，这是操作员的逃生通道；需要--safe。
建议使用
当前文档和示例请使用 openclaw gateway。