Skip to main content

​
openclaw system

Gateway のシステムレベルヘルパー：システムイベントのキューへの追加、Heartbeat の制御、プレゼンスの表示を行います。 すべての system サブコマンドは Gateway RPC を使用し、共通のクライアントフラグを受け付けます。

​
よく使うコマンド

​
system event

デフォルトでは、メインセッションのキューにシステムイベントを追加します。次の Heartbeat により、プロンプトへ System: 行として挿入されます。Heartbeat を即座にトリガーするには --mode now を使用します。next-heartbeat（デフォルト）では、次にスケジュールされたティックまで待機します。 特定のセッションを対象にするには --session-key を渡します。たとえば、非同期タスクの完了を、そのタスクを開始したチャネルへ返す場合に使用します。
--session-key を使用する場合のタイミングの例外： --session-key が指定されると、--mode next-heartbeat は、次にスケジュールされたティックを待つのではなく、対象を指定した即時ウェイクとして処理されます。対象を指定したウェイクでは Heartbeat インテント immediate を使用するため、ランナーの実行時刻未到来ゲートを回避できます。このゲートを回避しない場合、event インテントのウェイクは延期され（事実上破棄され）ます。配信を遅らせる場合は、--session-key を省略してください。これにより、イベントはメインセッションに追加され、次の通常の Heartbeat で配信されます。
フラグ：
  • --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 が実行されている必要があります。
  • システムイベントは一時的なものであり、再起動後は保持されません。

​
関連項目