日期和时间

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 时区      envelopeTimestamp: "on", // "on" | "off"      envelopeElapsed: "on", // "on" | "off"    },  },}

示例

本地时间（默认）：

[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

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

系统提示词包含一个当前日期和时间部分，其中仅包含时区 （不包含时钟时间或时间格式），以保持提示词缓存稳定：

时区：America/Chicago

配置后，时区使用 agents.defaults.userTimezone；否则使用主机时区。 提示词还会指示智能体在需要当前日期、时间或星期时运行 session_status 工具。

系统事件行（默认使用本地时间）

插入智能体上下文的排队系统事件会添加时间戳前缀，其 envelopeTimezone 选择方式与消息信封相同（默认：主机本地时间）。

系统：[2026-01-12 12:19:17 PST] 模型已切换。

配置用户时区和格式

{  agents: {    defaults: {      userTimezone: "America/Chicago",      timeFormat: "auto", // auto | 12 | 24    },  },}

• userTimezone 设置提示词上下文使用的用户本地时区（也用于 envelopeTimezone: "user"）。
• timeFormat 控制提示词所显示时间采用 12 小时制还是 24 小时制。auto 遵循操作系统偏好设置。

时间格式检测（自动）

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

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

渠道工具会返回提供商原生时间戳，并添加规范化字段以确保一致性：

• timestampMs：纪元毫秒数（UTC）
• timestampUtc：ISO 8601 UTC 字符串

原始提供商字段会被保留，确保不会丢失任何信息。

• Discord：UTC ISO 时间戳
• Slack：API 返回的类纪元字符串
• Telegram/WhatsApp：提供商特定的数值或 ISO 时间戳

如果需要本地时间，请在下游使用已知时区进行转换。

相关文档

• 系统提示词
• 时区
• 消息