跳轉到主要內容

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，或先解析密鑰來源。
  • 如果探測成功，未解析 auth-ref 警告會被抑制，以避免誤判。
  • status --deep 會加入盡力而為的系統層級服務掃描。當它找到其他類似 gateway 的服務時，人類可讀輸出會列印清理提示，並警告每台機器一個 gateway 仍是一般建議。
  • status --deep 也會以 Plugin 感知模式執行設定驗證，並顯示已設定 Plugin 清單的警告（例如缺少通道設定中繼資料），讓安裝與更新冒煙檢查能捕捉到這些問題。預設 status 會保留快速唯讀路徑，略過 Plugin 驗證。
  • 在 Linux systemd 安裝中，status 權杖漂移檢查會同時包含 Environment= 與 EnvironmentFile= 單元來源。
  • 漂移檢查會使用合併後的執行階段 env 解析 gateway.auth.token SecretRefs（先使用服務命令 env，再後援至程序 env）。
  • 如果權杖驗證實際上未啟用（明確的 gateway.auth.mode 為 password/none/trusted-proxy，或 mode 未設定且密碼可勝出而沒有權杖候選可勝出），權杖漂移檢查會略過設定權杖解析。
  • 當權杖驗證需要權杖且 gateway.auth.token 由 SecretRef 管理時，install 會驗證該 SecretRef 可解析，但不會將解析後的權杖持久化到服務環境中繼資料中。
  • 如果權杖驗證需要權杖且已設定的權杖 SecretRef 未解析，安裝會以失敗關閉。
  • 如果同時設定了 gateway.auth.token 與 gateway.auth.password，且 gateway.auth.mode 未設定，安裝會被封鎖，直到明確設定 mode。
  • 在 macOS 上，install 會讓 LaunchAgent plists 僅限擁有者存取，並透過僅限擁有者存取的檔案與包裝器載入受管理的服務環境值，而不是將 API 金鑰或 auth-profile env refs 序列化到 EnvironmentVariables。
  • 如果你有意在同一台主機上執行多個 gateways，請隔離連接埠、設定/狀態與工作區；請參閱 /gateway#multiple-gateways-same-host。
  • restart --safe 會要求正在執行的 Gateway 預檢作用中的工作，並在作用中工作耗盡後排程一次合併的重新啟動。一般 restart 會保留既有的服務管理器行為；--force 仍是立即覆寫路徑。
  • restart --safe --skip-deferral 會執行 OpenClaw 感知的安全重新啟動，但繞過作用中工作延後閘門，因此即使回報封鎖項目，Gateway 也會立即發出重新啟動。這是操作員在卡住的任務執行釘住安全重新啟動時的逃生口；需要 --safe。

​
建議使用

使用 openclaw gateway 查看目前文件與範例。

​
相關