跳转到主要内容
OpenClaw 使用主机本地时间作为传输时间戳，并且在系统提示中只放入时区。 保留提供商时间戳，因此工具会保持其原生语义。当智能体需要当前 时间时，它会运行 session_status 工具。

​
消息信封（默认本地）

入站消息会用星期和精确到秒的时间戳包装： 
[WhatsApp +1555 Mon 2026-01-05 16:26:34 PST] message text
无论提供商时区是什么，信封时间戳默认都是主机本地时间。 可在 agents.defaults 下覆盖： 
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
键值行为
envelopeTimezonelocal（默认）、utc、user、显式 IANA 名称user 使用 agents.defaults.userTimezone（未设置时使用主机时区）。显式 IANA 名称（例如 "America/Chicago"）会固定到指定时区；无法识别的名称会回退到 UTC。
envelopeTimestampon（默认）、offoff 会从信封标头、直接智能体提示前缀和嵌入式模型输入前缀中移除绝对时间戳。
envelopeElapsedon（默认）、offoff 会移除会话中自上一条消息以来显示的经过时间后缀（+30s / +2m 样式）。

​
示例

本地（默认）： 
[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] hello
用户时区： 
[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] hello
使用 envelopeTimezone: "utc" 的经过时间： 
[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] follow-up

​
系统提示：当前日期和时间

系统提示包含一个 Current Date & Time 部分，其中仅包含时区 （不包含时钟或时间格式），以保持提示缓存稳定： 
Time zone: America/Chicago
配置后，时区为 agents.defaults.userTimezone；否则为主机时区。 提示还会指示智能体在需要当前日期、时间或星期几时运行 session_status 工具。

​
系统事件行（默认本地）

插入智能体上下文的排队系统事件会加上时间戳前缀，使用与消息信封相同的 envelopeTimezone 选择（默认：主机本地）。 
System: [2026-01-12 12:19:17 PST] Model switched.

​
配置用户时区 + 格式

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}
  • userTimezone 为提示上下文设置用户本地时区（也用于 envelopeTimezone: "user"）。
  • timeFormat 控制面向提示的时间中的 12 小时/24 小时显示。auto 会遵循操作系统偏好设置。

​
时间格式检测（auto）

当 timeFormat: "auto" 时，OpenClaw 会检查操作系统偏好设置（macOS 和 Windows） 并回退到区域设置格式。检测到的值会按进程缓存， 以避免重复系统调用。

​
工具载荷 + 连接器（原始提供商时间 + 规范化字段）

渠道工具会返回提供商原生时间戳，并添加规范化字段以保持一致性：
  • timestampMs：纪元毫秒（UTC）
  • timestampUtc：ISO 8601 UTC 字符串
原始提供商字段会被保留，确保不会丢失任何内容。
  • Discord：UTC ISO 时间戳
  • Slack：来自 API 的类纪元字符串
  • Telegram/WhatsApp：提供商特定的数字/ISO 时间戳
如果你需要本地时间，请在下游使用已知时区进行转换。

​
相关文档