Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw system
Gateway 用のシステムレベルヘルパーです。システムイベントをキューに入れ、Heartbeat を制御し、
プレゼンスを表示します。
すべての system サブコマンドは Gateway RPC を使用し、共通のクライアントフラグを受け付けます。
--url <url>--token <token>--timeout <ms>--expect-final
共通コマンド
system event
デフォルトでは、メインセッションにシステムイベントをキューに入れます。次の Heartbeat で、
プロンプト内の System: 行として注入されます。Heartbeat をすぐにトリガーするには --mode now を使用します。
next-heartbeat は次にスケジュールされたティックまで待機します。
特定のセッションを対象にするには --session-key を渡します（たとえば、
非同期タスクの完了を、それを開始したチャンネルへ中継して戻す場合）。
フラグ:--session-key使用時のタイミング例外:--session-keyが指定されている場合、--mode next-heartbeatは、次にスケジュールされたティックを待たずに、 即時の対象指定ウェイクに折りたたまれます。対象指定ウェイクは Heartbeat インテントimmediateを使用するため、runner の not-due ゲートをバイパスします。このゲートは通常、eventインテントのウェイクを遅延させます（実質的にはドロップします）。遅延配信したい場合は、--session-keyを省略し、イベントがメインセッションに届いて次の通常の Heartbeat に乗るようにしてください。
--text <text>: 必須のシステムイベントテキスト。--mode <mode>:nowまたはnext-heartbeat（デフォルト）。--session-key <sessionKey>: 任意。エージェントのメインセッションではなく、 特定のエージェントセッションを対象にします。解決されたエージェントに属さないキーは、 エージェントのメインセッションにフォールバックします。--json: 機械可読出力。--url、--token、--timeout、--expect-final: 共通の Gateway RPC フラグ。
system heartbeat last|enable|disable
Heartbeat 制御:
last: 最後の Heartbeat イベントを表示します。enable: Heartbeat を再びオンにします（無効化されていた場合に使用します）。disable: Heartbeat を一時停止します。
--json: 機械可読出力。--url、--token、--timeout、--expect-final: 共通の Gateway RPC フラグ。
system presence
Gateway が認識している現在のシステムプレゼンスエントリ（ノード、
インスタンス、および同様のステータス行）を一覧表示します。
フラグ:
--json: 機械可読出力。--url、--token、--timeout、--expect-final: 共通の Gateway RPC フラグ。
メモ
- 現在の設定（ローカルまたはリモート）から到達可能な、実行中の Gateway が必要です。
- システムイベントは一時的なもので、再起動をまたいで永続化されません。