日付と時刻

OpenClaw は、トランスポートのタイムスタンプにホストのローカル時刻を使用し、システムプロンプトにはタイムゾーンのみを含めます。 プロバイダーのタイムスタンプは保持されるため、ツールはネイティブのセマンティクスを維持します。エージェントが現在時刻を必要とする場合は、 session_status ツールを実行します。

メッセージエンベロープ（デフォルトではローカル）

受信メッセージは、曜日と秒精度のタイムスタンプでラップされます。

[WhatsApp +1555 Mon 2026-01-05 16:26:34 PST] メッセージテキスト

エンベロープのタイムスタンプは、プロバイダーのタイムゾーンに関係なく、デフォルトではホストのローカル時刻です。 agents.defaults で上書きできます。

{  agents: {    defaults: {      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone      envelopeTimestamp: "on", // "on" | "off"      envelopeElapsed: "on", // "on" | "off"    },  },}

例

ローカル（デフォルト）:

[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] こんにちは

ユーザーのタイムゾーン:

[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] こんにちは

envelopeTimezone: "utc" を使用した経過時間:

[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] フォローアップ

システムプロンプト: 現在の日付と時刻

プロンプトキャッシュを安定させるため、システムプロンプトにはタイムゾーンのみを含む 現在の日付と時刻セクションが含まれます（時計や時刻形式は含まれません）。

タイムゾーン: America/Chicago

設定されている場合、タイムゾーンは agents.defaults.userTimezone です。それ以外の場合はホストのタイムゾーンです。 またプロンプトは、現在の日付、時刻、または曜日が必要な場合に session_status ツールを実行するよう エージェントに指示します。

システムイベント行（デフォルトではローカル）

エージェントのコンテキストに挿入されるキュー内のシステムイベントには、メッセージエンベロープと 同じ envelopeTimezone の選択を使用したタイムスタンプがプレフィックスとして付加されます（デフォルト: ホストのローカル時刻）。

システム: [2026-01-12 12:19:17 PST] モデルが切り替えられました。

ユーザーのタイムゾーンと形式を設定する

{  agents: {    defaults: {      userTimezone: "America/Chicago",      timeFormat: "auto", // auto | 12 | 24    },  },}

• userTimezone は、プロンプトコンテキスト（および envelopeTimezone: "user"）のユーザーのローカルタイムゾーンを設定します。
• timeFormat は、プロンプトに表示される時刻の 12 時間制/24 時間制表示を制御します。auto は OS の設定に従います。

時刻形式の検出（自動）

timeFormat: "auto" の場合、OpenClaw は OS の設定（macOS および Windows）を調べ、 ロケール形式にフォールバックします。検出された値は、システム呼び出しの繰り返しを避けるため、 プロセスごとにキャッシュされます。

ツールペイロードとコネクター（プロバイダーの未加工時刻と正規化フィールド）

チャンネルツールはプロバイダーネイティブのタイムスタンプを返し、一貫性を確保するために正規化されたフィールドを追加します。

• timestampMs: エポックミリ秒（UTC）
• timestampUtc: ISO 8601 UTC 文字列

情報が失われないように、プロバイダーの未加工フィールドは保持されます。

• Discord: UTC ISO タイムスタンプ
• Slack: API からのエポック形式の文字列
• Telegram/WhatsApp: プロバイダー固有の数値/ISO タイムスタンプ

ローカル時刻が必要な場合は、既知のタイムゾーンを使用して後続処理で変換してください。

関連ドキュメント

• システムプロンプト
• タイムゾーン
• メッセージ