メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw はタイムスタンプを標準化し、モデルがプロバイダーごとのローカルクロックの混在ではなく、単一の基準時刻を見るようにします。タイムゾーンが現れるサーフェスは 3 つあり、それぞれ目的が異なります。

​
3 つのタイムゾーンサーフェス

サーフェス表示内容デフォルト設定方法
メッセージエンベロープ受信チャネルメッセージをラップします: [Signal +1555 2026-01-18 00:19 PST] helloホストローカルagents.defaults.envelopeTimezone
ツールペイロードチャネルの readMessages 形式のツールは、生のプロバイダー時刻 + 正規化済みの timestampMs / timestampUtc を返しますUTC フィールドは常に存在設定不可 — プロバイダーネイティブのタイムスタンプを保持
システムプロンプトタイムゾーンのみを含む小さな Current Date & Time ブロック（キャッシュ安定性のため、時刻値は含めない）userTimezone 未設定の場合はホストのタイムゾーンagents.defaults.userTimezone
システムプロンプトは、ターン間でプロンプトキャッシュを安定させるため、意図的に現在時刻を省略します。エージェントが現在時刻を必要とする場合は、session_status を呼び出します。

​
ユーザータイムゾーンの設定

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
    },
  },
}
userTimezone が未設定の場合、OpenClaw は実行時にホストのタイムゾーンを解決します（設定の書き込みはありません）。agents.defaults.timeFormat（auto | 12 | 24）は、エンベロープと下流サーフェスでの 12 時間/24 時間表示を制御しますが、システムプロンプトセクションでは制御しません。

​
上書きするタイミング

  • UTC エンベロープを使用する（envelopeTimezone: "utc"）のは、異なる地域のホスト間でタイムスタンプを安定させたい場合、または UTC に揃えたログを診断出力と一致させたい場合です。
  • 固定の IANA ゾーンを使用する（例: "Europe/Vienna"）のは、Gateway ホストがあるゾーンにあり、ユーザーが別のゾーンにいる場合で、ホスト移行に関係なくエンベロープをユーザーのゾーンで読みたい場合です。
  • 会話にタイムスタンプのコンテキストが役立たない場合は、低トークンのエンベロープとして envelopeTimestamp: "off" を設定します。
完全な動作リファレンス、プロバイダーごとの例、経過時間の書式設定については、日付と時刻を参照してください。

​
関連

  • 日付と時刻 — エンベロープ/ツール/プロンプトの完全な動作と例。
  • Heartbeat — アクティブ時間はスケジューリングにタイムゾーンを使用します。
  • Cron ジョブ — cron 式はスケジューリングにタイムゾーンを使用します。