時區 - OpenClaw

OpenClaw 會標準化時間戳記，讓模型看到的是單一參考時間，而不是混雜各提供者本地時鐘。時區會出現在三個介面，各自有不同用途：

三個時區介面

介面	顯示內容	預設值	設定方式
訊息封套	包裝傳入的頻道訊息：`[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 對齊的日誌符合診斷輸出時，請使用 UTC 封套（envelopeTimezone: "utc"）。
當 Gateway 主機位於某個時區，但使用者位於另一個時區，且你希望封套無論主機如何遷移都以使用者的時區閱讀時，請使用固定 IANA 時區（例如 "Europe/Vienna"）。
當時間戳記脈絡對對話沒有幫助，且你想使用低 Token 封套時，請設定 envelopeTimestamp: "off"。

如需完整行為參考、各提供者範例，以及經過時間格式化，請參閱日期與時間。