Skip to main content

時區

OpenClaw 會將時間戳標準化,讓模型看到單一參考時間

訊息封套(預設為本地)

傳入訊息會被包裝在如下的封裝中:
  1. 信封中的時間戳預設為主機本地時間,精確到分鐘。
您可以使用以下方式覆寫:
  • envelopeTimezone: "utc" 使用 UTC。
  • envelopeTimezone: "user" 使用 agents.defaults.userTimezone(回退至主機時區)。
  • 使用明確的 IANA 時區(例如:"Europe/Vienna")以取得固定偏移。
  • envelopeTimestamp: "off" 會從封裝標頭中移除絕對時間戳。
  • envelopeElapsed: "off" 會移除經過時間的後綴(+2m 樣式)。

範例

本地(預設):
固定時區:
經過時間:

工具承載(原始提供者資料 + 正規化欄位)

工具呼叫(channels.discord.readMessageschannels.slack.readMessages 等) 31. 31. 會回傳原始供應商時間戳。 我們也會附加標準化欄位以保持一致性:
  • timestampMs(UTC epoch 毫秒)
  • timestampUtc(ISO 8601 UTC 字串)
原始提供者欄位會被保留。

系統提示所使用的使用者時區

設定 agents.defaults.userTimezone 以告知模型使用者的本地時區。若未設定, OpenClaw 會在執行階段解析主機時區(不寫入設定)。 34. 若未設定,OpenClaw 會在執行階段解析主機時區(不寫入設定)。
系統提示包含:
  • Current Date & Time 區段,包含本地時間與時區
  • Time format: 12-hour24-hour
您可以使用 agents.defaults.timeFormatauto | 12 | 24)來控制提示格式。 完整行為與範例請參閱 Date & Time