CLI commands
デーモン
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 らしいサービスを見つけると、人間向け出力にはクリーンアップのヒントが表示され、1 台のマシンにつき 1 つの Gateway が通常の推奨であることを警告します。status --deepは Plugin 対応モードで設定検証も実行し、設定済み Plugin マニフェストの警告（たとえばチャンネル設定メタデータの欠落）を表面化するため、インストールと更新のスモークチェックで検出できます。既定のstatusは、Plugin 検証をスキップする高速な読み取り専用パスを維持します。- Linux systemd インストールでは、
statusのトークンドリフトチェックにEnvironment=とEnvironmentFile=の両方のユニットソースが含まれます。 - ドリフトチェックは、マージ済みランタイム env（まずサービスコマンドの env、次にプロセス env フォールバック）を使って
gateway.auth.tokenSecretRefs を解決します。 - トークン認証が実質的に有効でない場合（明示的な
gateway.auth.modeがpassword/none/trusted-proxy、またはモード未設定でパスワードが優先され得て、トークン候補が優先され得ない場合）、トークンドリフトチェックは設定トークンの解決をスキップします。 - トークン認証にトークンが必要で、
gateway.auth.tokenが SecretRef 管理の場合、installは SecretRef が解決可能であることを検証しますが、解決済みトークンをサービス環境メタデータに永続化しません。 - トークン認証にトークンが必要で、設定済みトークン SecretRef が未解決の場合、インストールはフェイルクローズします。
gateway.auth.tokenとgateway.auth.passwordの両方が設定され、gateway.auth.modeが未設定の場合、モードが明示的に設定されるまでインストールはブロックされます。- macOS では、
installは LaunchAgent plists を所有者専用に保ち、API キーや認証プロファイルの env 参照をEnvironmentVariablesにシリアライズする代わりに、所有者専用ファイルとラッパーを通じて管理対象サービス環境値を読み込みます。 - 1 つのホストで複数の Gateway を意図的に実行する場合は、ポート、設定/状態、ワークスペースを分離してください。/gateway#multiple-gateways-same-host を参照してください。
restart --safeは、実行中の Gateway にアクティブな作業を事前確認し、アクティブな作業が排出された後に 1 回の集約された再起動をスケジュールするよう要求します。既定の安全な再起動は、設定済みのgateway.reload.deferralTimeoutMs（既定 5 分）までアクティブな作業を待機します。その予算を使い切ると再起動は強制されます。強制しない無期限の安全待機にするには、gateway.reload.deferralTimeoutMsを0に設定してください。通常のrestartは既存のサービスマネージャーの挙動を維持します。--forceは即時上書きパスのままです。restart --safe --skip-deferralは OpenClaw 対応の安全な再起動を実行しますが、アクティブ作業の遅延ゲートをバイパスするため、ブロッカーが報告されていても Gateway は即座に再起動を発行します。停止したタスク実行が安全な再起動を固定している場合のオペレーター向け脱出口です。--safeが必要です。
推奨
現在のドキュメントと例には openclaw gateway を使用してください。
関連
Was this useful?
