CLI commands

デーモン

openclaw daemon

Gatewayサービス管理用のレガシーエイリアスです。openclaw daemon ...は、openclaw gateway ...と同じサービス制御コマンドに対応します。最新のドキュメントと例については、openclaw gatewayを使用してください。

使用方法

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

サブコマンドとオプション

サブコマンド オプション
status --url, --token, --password, --timeout, --no-probe, --require-rpc, --deep, --json
install --port, --runtime <node|bun>, --token, --wrapper <path>, --force, --json
uninstall --json
start --json
stop --json, --disable(launchdのみ:次回の起動までKeepAlive/RunAtLoadを継続的に抑止)
restart --force, --safe, --skip-deferral, --wait <duration>, --json
  • status:サービスのインストール状態(launchd/systemd/schtasks)を表示し、Gatewayの正常性を検査します。
  • install:サービスをインストールします。--forceを指定すると、既存のインストールを再インストールまたは上書きします。
  • restart --safe:実行中のGatewayに対し、進行中の処理を事前確認し、処理が完了した後に統合された1回の再起動をスケジュールするよう要求します。待機時間はgateway.reload.deferralTimeoutMs(デフォルトは300000ミリ秒/5分、無期限に待機するには0を設定)で制限されます。この時間を超えると、再起動は強制的に実行されます。通常のrestartはサービスマネージャーを直接使用し、--forceは即時実行を強制します。
  • restart --safe --skip-deferral:進行中の処理による延期ゲートを回避し、ブロッカーが報告されている場合でもGatewayを直ちに再起動します。--safeが必要です。

注意事項

  • statusは、可能な場合、検査時の認証用に設定済みの認証SecretRefを解決します。必須のSecretRefを解決できない場合、status --jsonrpc.authWarningを報告します。--token--passwordを明示的に渡すか、先にシークレットのソースを解決してください。検査がそれ以外の点で成功すると、未解決の認証に関する警告は表示されなくなります。
  • status --deepは、Gatewayに類似する他のサービスを対象に、ベストエフォート方式のシステムレベルスキャンを追加します(クリーンアップのヒントを表示しますが、マシン1台につきGatewayを1つにすることを引き続き推奨します)。また、Pluginを認識するモードで設定検証を実行し、高速なデフォルト経路では省略されるPluginマニフェストの警告を表示します。
  • Linuxのsystemdインストールでは、トークンの差異チェックによってEnvironment=EnvironmentFile=の両方のユニットソースが検査されます。
  • トークンの差異チェックでは、統合された実行時環境変数(最初にサービスコマンドの環境変数、次にプロセスの環境変数)を使用して、gateway.auth.tokenのSecretRefを解決します。トークン認証が実質的に有効でない場合(gateway.auth.modepasswordnonetrusted-proxyである場合、または未設定でパスワード認証が優先される場合)、設定トークンの解決はスキップされます。
  • installは、SecretRefで管理されるgateway.auth.tokenが解決可能であることを検証しますが、解決した値をサービス環境のメタデータに保存することはありません。解決できない場合、インストールは安全側に倒して失敗します。
  • gateway.auth.tokengateway.auth.passwordの両方が設定され、gateway.auth.modeが未設定の場合、モードを明示的に設定するまでinstallは処理を停止します。
  • macOSでは、installはシークレットをEnvironmentVariablesに埋め込む代わりに、LaunchAgentのplistと生成された環境変数ファイル/ラッパーを所有者のみがアクセス可能な状態(モード06000700)に保ちます。
  • 1台のホストで複数のGatewayを実行する場合は、ポート、設定/状態、およびワークスペースを分離してください。複数のGatewayを参照してください。

関連項目

Was this useful?
On this page

On this page