session_status ツールを実行します。
メッセージエンベロープ(デフォルトでローカル)
受信メッセージは、曜日と秒精度のタイムスタンプ付きでラップされます。agents.defaults の下で上書きします。
| キー | 値 | 動作 |
|---|---|---|
envelopeTimezone | local(デフォルト)、utc、user、明示的な IANA 名 | user は agents.defaults.userTimezone を使用します(未設定の場合はホストのタイムゾーン)。明示的な IANA 名(例: "America/Chicago")は固定ゾーンに固定されます。認識されない名前は UTC にフォールバックします。 |
envelopeTimestamp | on(デフォルト)、off | off は、エンベロープヘッダー、直接のエージェントプロンプト接頭辞、埋め込みモデル入力接頭辞から絶対タイムスタンプを削除します。 |
envelopeElapsed | on(デフォルト)、off | off は、セッション内の前のメッセージ以降に表示される経過時間サフィックス(+30s / +2m スタイル)を削除します。 |
例
ローカル(デフォルト):envelopeTimezone: "utc" での経過時間:
システムプロンプト: 現在の日付と時刻
システムプロンプトには、プロンプトキャッシュを安定させるため、タイムゾーンのみを含む 現在の日付と時刻セクションが含まれます(時計や時刻形式は含みません)。agents.defaults.userTimezone、それ以外の場合はホストのタイムゾーンです。
プロンプトはまた、現在の日付、時刻、曜日が必要な場合は常に session_status ツールを実行するよう
エージェントに指示します。
システムイベント行(デフォルトでローカル)
エージェントコンテキストに挿入されるキュー済みシステムイベントには、メッセージエンベロープと同じenvelopeTimezone の選択(デフォルト: ホストローカル)を使用したタイムスタンプが接頭辞として付与されます。
ユーザーのタイムゾーンと形式を設定する
userTimezoneは、プロンプトコンテキスト用(およびenvelopeTimezone: "user"用)のユーザーローカルタイムゾーンを設定します。timeFormatは、プロンプトに表示される時刻の 12時間/24時間表示を制御します。autoは OS の設定に従います。
時刻形式の検出(auto)
timeFormat: "auto" の場合、OpenClaw は OS の設定(macOS と Windows)を検査し、
ロケール形式にフォールバックします。検出された値は、繰り返しのシステムコールを避けるため、
プロセスごとにキャッシュされます。
ツールペイロード + コネクター(生のプロバイダー時刻 + 正規化フィールド)
チャンネルツールは プロバイダーネイティブのタイムスタンプを返し、一貫性のために正規化フィールドを追加します。timestampMs: エポックミリ秒(UTC)timestampUtc: ISO 8601 UTC 文字列
- Discord: UTC ISO タイムスタンプ
- Slack: API からのエポック風文字列
- Telegram/WhatsApp: プロバイダー固有の数値/ISO タイムスタンプ