時區

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"。這會移除封裝、直接代理程式提示前綴，以及嵌入式模型輸入前綴中的絕對時間戳記。

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

相關內容

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