openclaw system

Gateway のシステムレベルヘルパー：システムイベントのキューへの追加、Heartbeat の制御、プレゼンスの表示を行います。

すべての system サブコマンドは Gateway RPC を使用し、共通のクライアントフラグを受け付けます。

よく使うコマンド

openclaw system event --text "緊急のフォローアップがないか確認する" --mode nowopenclaw system event --text "緊急のフォローアップがないか確認する" --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"openclaw system heartbeat enableopenclaw system heartbeat lastopenclaw system presence

system event

デフォルトでは、メインセッションのキューにシステムイベントを追加します。次の Heartbeat により、プロンプトへ System: 行として挿入されます。Heartbeat を即座にトリガーするには --mode now を使用します。next-heartbeat（デフォルト）では、次にスケジュールされたティックまで待機します。

特定のセッションを対象にするには --session-key を渡します。たとえば、非同期タスクの完了を、そのタスクを開始したチャネルへ返す場合に使用します。

フラグ：

• --text <text>：必須のシステムイベントテキスト。
• --mode <mode>：now または next-heartbeat（デフォルト）。
• --session-key <sessionKey>：省略可能。エージェントのメインセッションではなく、特定のエージェントセッションを対象にします。解決されたエージェントに属さないキーは、エージェントのメインセッションへフォールバックします。

system heartbeat last|enable|disable

• last：最後の Heartbeat イベントを表示します。
• enable：Heartbeat を再び有効にします（無効化されている場合に使用します）。
• disable：Heartbeat を一時停止します。

system presence

Gateway が認識している現在のシステムプレゼンスエントリ（Node、インスタンス、および同様のステータス行）を一覧表示します。

注記

• 現在の設定（ローカルまたはリモート）から到達可能な Gateway が実行されている必要があります。
• システムイベントは一時的なものであり、再起動後は保持されません。

関連項目

• CLI リファレンス