時區

OpenClaw 會將時間戳記標準化，讓模型看到單一參照時間，而不是混合各提供者的本地時鐘。共有三個介面會顯示時區，各有不同用途：

三種時區介面

系統提示詞刻意省略即時時鐘，以維持各輪對話間的提示詞快取穩定。當代理程式需要目前時間時，會呼叫 session_status。

設定使用者時區

{  agents: {    defaults: {      userTimezone: "America/Chicago",    },  },}

若未設定 userTimezone，OpenClaw 會在執行階段透過 Intl.DateTimeFormat().resolvedOptions().timeZone 解析主機時區（不寫入設定）。agents.defaults.timeFormat（auto | 12 | 24）控制訊息封裝及下游介面的 12 小時制／24 小時制顯示方式，但不影響系統提示詞區段。

訊息封裝時區值

agents.defaults.envelopeTimezone 接受：

• "local"（預設）或 "host"：主機的時區。
• "utc" 或 "gmt"：UTC。
• "user"：解析後的 agents.defaults.userTimezone（若未設定，則回退至主機時區）。
• 任何明確的 IANA 時區字串，例如 "Europe/Vienna"。

何時需要覆寫

• 使用 "utc"：在不同地區的主機間保持時間戳記一致，或配合採用 UTC 的診斷／日誌輸出。
• 使用 "user"：無論閘道主機在哪個時區執行，都讓訊息封裝與設定的使用者時區保持一致。
• 使用固定的 IANA 時區：當閘道主機位於某個時區，但無論主機如何遷移，訊息封裝都應固定顯示另一個時區時。
• 設定 envelopeTimestamp: "off"：當時間戳記脈絡對對話沒有幫助時。這會從訊息封裝、直接代理程式提示詞前綴，以及嵌入的模型輸入前綴中移除絕對時間戳記。

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

相關內容

• 日期與時間：完整的訊息封裝／工具／提示詞行為與範例。
• 心跳偵測：活動時段會使用時區進行排程。
• 排程工作：排程運算式會使用時區進行排程。