openclaw system で Gateway をスマートに管理する

開発を進めていると、システムの裏側で何が起きているのか、あるいは特定のタイミングでシステムに直接指示を出したい場面があります。ログを追い続けたり、複雑な設定を書き換えたりすることなく、手軽に状態を確認したり、割り込み処理を入れたりする方法があると便利ですよね。

openclaw system を使えば、Gateway のシステムレベルの操作をシンプルに完結できます。

必要なもの

この機能を利用するには、以下の条件を満たしている必要があります。

• 現在の設定（local または remote）で接続可能な、実行中の Gateway

クイックスタート

5 分で openclaw system の基本をマスターしましょう。おすすめの使い方は、イベントの即時実行と状態確認の組み合わせです。

1. システムイベントを即時登録する --mode now を指定すると、Heartbeat を待たずに即座にイベントを注入できます。

   openclaw system event --text "Check for urgent follow-ups" --mode now

2. Heartbeat を有効化する もし Heartbeat が停止している場合は、このコマンドで再開させます。

   openclaw system heartbeat enable

3. 現在の Presence を確認する Gateway が認識している Node や Instance の状態を一覧で表示します。

   openclaw system presence

4. 最新の Heartbeat ログを見る 最後に発生した Heartbeat イベントの内容を確認し、正常に動作しているかチェックします。

   openclaw system heartbeat last

トラブルシューティング

よくある問題と解決策です。

• Gateway に接続できない: Gateway が起動していること、および現在の設定で通信可能な状態であることを確認してください。
• 登録したイベントが消えた: System event は一時的な（ephemeral）データです。Gateway を再起動すると保持されないため注意してください。

設定の詳細や特定のステータスをプログラムから利用したい場合は、--json フラグを付けて実行すると解析しやすい出力が得られます。

さらに詳しい情報が必要な場合は、AI Setup Assistant で質問してください。

次のステップ

• Gateway 構成ガイド
• CLI リファレンス