Skip to main content
OpenClaw 对传输时间戳使用主机本地时间，并且在系统提示词中仅加入时区。 提供商时间戳会被保留，使工具维持其原生语义。当智能体需要当前 时间时，它会运行 session_status 工具。

​
消息信封（默认为本地时间）

入站消息会封装为包含星期和精确到秒的时间戳：
无论提供商采用哪个时区，信封时间戳默认都使用主机本地时间。 可在 agents.defaults 下覆盖：

​
示例

本地时间（默认）：
用户时区：
使用 envelopeTimezone: "utc" 的已用时间：

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

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

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

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

​
配置用户时区和格式

  • 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 时间戳
如果需要本地时间，请在下游使用已知时区进行转换。

​
相关文档