# openclaw system

Gateway向けのシステムレベルヘルパーです。システムイベントのエンキュー、Heartbeatの制御、 プレゼンスの表示を行います。

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

• --url <url>
• --token <token>
• --timeout <ms>
• --expect-final

# よく使うコマンド

openclaw system event --text "Check for urgent follow-ups" --mode now
openclaw system event --text "Check for urgent follow-ups" --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"
openclaw system heartbeat enable
openclaw system heartbeat last
openclaw system presence

# system event

メインセッションにシステムイベントをエンキューします。次のHeartbeatで、 プロンプト内にSystem:行として注入されます。Heartbeatを即時に トリガーするには--mode nowを使用します。next-heartbeatは次回のスケジュールされたティックまで待機します。

フラグ:

• --text <text>: 必須のシステムイベントテキスト。
• --mode <mode>: nowまたはnext-heartbeat（デフォルト）。
• --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が認識している現在のシステムプレゼンスエントリ（Node、 インスタンス、および同様のステータス行）を一覧表示します。

フラグ:

• --json: 機械可読な出力。
• --url、--token、--timeout、--expect-final: 共有Gateway RPCフラグ。

# 注意

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

# 関連

• CLI reference