Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
openclaw daemon

Gateway 网关服务管理命令的旧版别名。 openclaw daemon ... 映射到与 openclaw gateway ... 服务命令相同的服务控制面。

​
用法

openclaw daemon status
openclaw daemon install
openclaw daemon start
openclaw daemon stop
openclaw daemon restart
openclaw daemon uninstall

​
子命令

  • status：显示服务安装状态并探测 Gateway 网关健康状态
  • install：安装服务（launchd/systemd/schtasks）
  • uninstall：移除服务
  • start：启动服务
  • stop：停止服务
  • restart：重启服务

​
常用选项

  • status：--url、--token、--password、--timeout、--no-probe、--require-rpc、--deep、--json
  • install：--port、--runtime <node|bun>、--token、--force、--json
  • restart：--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 安装中，status token 漂移检查会同时包含 Environment= 和 EnvironmentFile= 单元来源。
  • 漂移检查会使用合并后的运行时环境解析 gateway.auth.token SecretRefs（先使用服务命令环境，再回退到进程环境）。
  • 如果 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。

​
相关内容