時區

OpenClaw 統一所有時間戳記，讓模型看到單一參考時間。

訊息信封（預設為當地時間）

收到的訊息會被包裝成這樣的信封：

[Provider ... 2026-01-05 16:26 PST] message text

信封中的時間戳記預設為主機當地時間，精確到分鐘。

可透過以下設定覆蓋：

{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA 時區
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}

• envelopeTimezone: "utc" 使用 UTC。
• envelopeTimezone: "user" 使用 agents.defaults.userTimezone（若未設定則退回為主機時區）。
• 使用明確的 IANA 時區（例如 "Europe/Vienna"）以取得固定偏移。
• envelopeTimestamp: "off" 移除信封標頭中的絕對時間戳記。
• envelopeElapsed: "off" 移除經過時間後綴（+2m 格式）。

範例

當地時間（預設）：

[Signal Alice +1555 2026-01-18 00:19 PST] hello

固定時區：

[Signal Alice +1555 2026-01-18 06:19 GMT+1] hello

經過時間：

[Signal Alice +1555 +2m 2026-01-18T05:19Z] follow-up

工具酬載（原始供應商資料 + 正規化欄位）

工具呼叫（channels.discord.readMessages、channels.slack.readMessages 等）回傳供應商原始時間戳記。 我們另外附加正規化欄位以確保一致性：

• timestampMs（UTC epoch 毫秒）
• timestampUtc（ISO 8601 UTC 字串）

供應商原始欄位保持不變。

系統提示詞的使用者時區

設定 agents.defaults.userTimezone 可告知模型使用者的當地時區。若未設定，OpenClaw 會在執行期間解析主機時區（不寫入設定）。

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

系統提示詞包含：

• Current Date & Time 章節，顯示當地時間和時區
• Time format: 12-hour 或 24-hour

可透過 agents.defaults.timeFormat（auto | 12 | 24）控制提示詞中的格式。

完整行為與範例請參閱 Date & Time。