OpenClaw daemonコマンド活用ガイド：サービス管理を効率化

開発を進める中で、バックグラウンドプロセスの管理は避けて通れない課題です。特に、OSごとに異なるサービス管理ツールを使い分けるのは手間がかかり、設定ミスも起きやすくなります。

openclaw daemon は、Gateway サービスの管理コマンドに使用されるレガシーなエイリアスです。このコマンドは、openclaw gateway ... のサービス制御機能と同じものに対応しています。

使い方

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

サブコマンド

• status: サービスのインストール状態を表示し、Gateway のヘルスチェック（probe）を実行します。
• 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
• ライフサイクル (uninstall|start|stop|restart): --json

注意点:

• status は、可能であれば probe 認証のために設定済みの認証用 SecretRef を解決します。
• 必要な認証用 SecretRef がこのコマンドパスで解決されない場合、probe の接続や認証に失敗した際に daemon status --json は rpc.authWarning を報告します。その場合は --token や --password を明示的に渡すか、先にシークレットのソースを解決してください。
• probe に成功した場合、誤検知を防ぐために未解決の認証リファレンスに関する警告は抑制されます。
• Linux の systemd インストールでは、status の token-drift チェックに Environment= と EnvironmentFile= の両方のユニットソースが含まれます。
• Drift チェックは、マージされたランタイム環境（最初にサービスコマンドの環境、次にプロセス環境のフォールバック）を使用して gateway.auth.token の SecretRef を解決します。
• トークン認証が実質的に有効でない場合（gateway.auth.mode が password/none/trusted-proxy に明示的に設定されている、またはモードが未設定でパスワードが優先されトークン候補が優先されない場合）、token-drift チェックは設定トークンの解決をスキップします。
• トークン認証にトークンが必要で、gateway.auth.token が SecretRef で管理されている場合、install は SecretRef が解決可能であることを検証しますが、解決されたトークンをサービスの環境メタデータに永続化することはありません。
• トークン認証にトークンが必要で、設定されたトークンの SecretRef が解決できない場合、インストールは失敗し、変更は適用されません。
• gateway.auth.token と gateway.auth.password の両方が設定されており、gateway.auth.mode が未設定の場合、モードが明示的に設定されるまでインストールはブロックされます。

推奨事項

最新のドキュメントや例については、openclaw gateway を使用してください。

次のステップ

• Gateway CLI リファレンス
• 認証設定のトラブルシューティング

AI Setup Assistant