日付と時刻
OpenClawは、トランスポートタイムスタンプにはホストローカル時間、システムプロンプト内でのみユーザータイムゾーンを使用することをデフォルトとしています。プロバイダーのタイムスタンプは保持されるため、ツールはそのネイティブなセマンティクスを維持します(現在時刻は session_status で利用可能です)。
メッセージエンベロープ(デフォルトはローカル)
受信メッセージはタイムスタンプ(分単位の精度)でラップされます:
[Provider ... 2026-01-05 16:26 PST] メッセージテキスト
このエンベロープタイムスタンプは、プロバイダーのタイムゾーンに関係なく、デフォルトではホストローカルです。この動作は上書きできます:
{
agents: {
defaults: {
envelopeTimezone: "local", // "utc" | "local" | "user" | IANA タイムゾーン
envelopeTimestamp: "on", // "on" | "off"
envelopeElapsed: "on", // "on" | "off"
},
},
}
envelopeTimezone: "utc"はUTCを使用します。envelopeTimezone: "local"はホストのタイムゾーンを使用します。envelopeTimezone: "user"はagents.defaults.userTimezoneを使用します(フォールバックはホストタイムゾーン)。- 固定のタイムゾーンには明示的なIANAタイムゾーン(例:
"America/Chicago")を使用します。 envelopeTimestamp: "off"はエンベロープヘッダーから絶対タイムスタンプを削除します。envelopeElapsed: "off"は経過時間サフィックス(+2mスタイル)を削除します。
例
ローカル(デフォルト):
[WhatsApp +1555 2026-01-18 00:19 PST] こんにちは
ユーザータイムゾーン:
[WhatsApp +1555 2026-01-18 00:19 CST] こんにちは
経過時間有効:
[WhatsApp +1555 +30s 2026-01-18T05:19Z] フォローアップ
システムプロンプト:現在の日付と時刻
ユーザーのタイムゾーンが既知の場合、システムプロンプトには専用の 現在の日付と時刻 セクションが含まれ、タイムゾーンのみ(時計/時間フォーマットはなし)が記載され、プロンプトキャッシュの安定性を保ちます:
タイムゾーン: America/Chicago
エージェントが現在時刻を必要とする場合は、session_status ツールを使用してください。ステータスカードにはタイムスタンプ行が含まれます。
システムイベント行(デフォルトはローカル)
エージェントコンテキストに挿入されるキューイングされたシステムイベントには、メッセージエンベロープと同じタイムゾーン選択(デフォルト:ホストローカル)を使用したタイムスタンプが接頭辞として付けられます。
System: [2026-01-12 12:19:17 PST] モデルが切り替わりました。
ユーザータイムゾーンとフォーマットの設定
{
agents: {
defaults: {
userTimezone: "America/Chicago",
timeFormat: "auto", // auto | 12 | 24
},
},
}
userTimezoneは、プロンプトコンテキスト用のユーザーローカルタイムゾーンを設定します。timeFormatは、プロンプト内の12時間/24時間表示を制御します。autoはOS設定に従います。
時間フォーマット検出(自動)
timeFormat: "auto" の場合、OpenClawはOSの設定(macOS/Windows)を検査し、ロケールフォーマットにフォールバックします。検出された値は、システムコールの繰り返しを避けるためにプロセスごとにキャッシュされます。
ツールペイロードとコネクタ(生のプロバイダー時間 + 正規化フィールド)
チャネルツールはプロバイダーネイティブのタイムスタンプを返し、一貫性のために正規化フィールドを追加します:
timestampMs: エポックミリ秒(UTC)timestampUtc: ISO 8601 UTC文字列
生のプロバイダーフィールドは保持されるため、何も失われません。
- Slack: APIからのエポック風文字列
- Discord: UTC ISOタイムスタンプ
- Telegram/WhatsApp: プロバイダー固有の数値/ISOタイムスタンプ
ローカル時間が必要な場合は、既知のタイムゾーンを使用して下流で変換してください。