openclaw daemon

用於閘道服務管理的舊版別名。openclaw daemon ... 會對應到與 openclaw gateway ... 相同的服務控制命令。目前的文件與範例請優先參閱 openclaw gateway。

使用方式

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

子命令與選項

• status：顯示服務安裝狀態（launchd/systemd/schtasks），並探測閘道健康狀態。
• install：安裝服務；--force 會重新安裝/覆寫既有安裝。
• restart --safe：要求執行中的閘道預檢作用中的工作，並在工作排空後排程一次合併的重新啟動，受 gateway.reload.deferralTimeoutMs 限制（預設 300000ms/5 分鐘；設為 0 可無限期等待）。當該預算到期時，仍會強制重新啟動。一般 restart 會直接使用服務管理器；--force 是立即覆寫。
• restart --safe --skip-deferral：略過作用中工作延後閘門，因此即使回報阻擋項，閘道也會立即重新啟動。需要 --safe。

備註

• status 會在可行時解析已設定的驗證 SecretRefs 以供探測驗證使用。如果必要的 SecretRef 未解析，status --json 會回報 rpc.authWarning；請明確傳入 --token/--password，或先解析祕密來源。一旦探測在其他方面成功，就會抑制未解析驗證警告。
• status --deep 會加入盡力而為的系統層級掃描，尋找其他類閘道服務（列印清理提示；仍建議每台機器一個閘道），並以外掛感知模式執行設定驗證，浮現快速預設路徑會略過的外掛資訊清單警告。
• 在 Linux systemd 安裝中，權杖漂移檢查會檢查 Environment= 和 EnvironmentFile= 這兩種 unit 來源。
• 權杖漂移檢查會使用合併後的執行階段 env（先是服務命令 env，接著是程序 env）解析 gateway.auth.token SecretRefs。如果權杖驗證實際上未啟用（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 plists 和產生的 env 檔案/wrapper 僅限擁有者存取（模式 0600/0700），而不是在 EnvironmentVariables 中嵌入祕密。
• 在同一台主機上執行多個閘道：隔離連接埠、設定/狀態和工作區。請參閱多個閘道。

相關

• 命令列介面參考
• 閘道操作手冊