Skip to main content

​
日期和时间

OpenClaw 默认对传输时间戳使用主机本地时间,并且仅在系统提示中使用用户时区。 提供程序时间戳被保留,因此工具保持其原生语义(当前时间可通过 session_status 获得)。

​
消息信封(默认本地)

入站消息用时间戳包装(分钟精度): 
[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: "local" 使用主机时区。
  • envelopeTimezone: "user" 使用 agents.defaults.userTimezone(回退到主机时区)。
  • 使用显式 IANA 时区(例如,"America/Chicago")来固定时区。
  • envelopeTimestamp: "off" 从信封标题中删除绝对时间戳。
  • envelopeElapsed: "off" 删除经过时间后缀(+2m 样式)。

​
示例

本地(默认): 
[WhatsApp +1555 2026-01-18 00:19 PST] hello
用户时区: 
[WhatsApp +1555 2026-01-18 00:19 CST] hello
启用经过时间: 
[WhatsApp +1555 +30s 2026-01-18T05:19Z] follow-up

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

如果已知用户时区,系统提示包含一个专用的当前日期和时间部分,仅包含时区(没有时钟/时间格式)以保持提示缓存稳定: 
Time zone: America/Chicago
当代理需要当前时间时,使用 session_status 工具;状态卡包含时间戳行。

​
系统事件行(默认本地)

插入到代理上下文中的排队系统事件带有时间戳前缀,使用与消息信封相同的时区选择(默认:主机本地)。 
System: [2026-01-12 12:19:17 PST] Model switched.

​
配置用户时区 + 格式

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto" // auto | 12 | 24
    }
  }
}
  • userTimezone 设置提示上下文的用户本地时区。
  • timeFormat 控制提示中的 12h/24h 显示。auto 遵循操作系统偏好。

​
时间格式检测(auto)

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

​
工具有效载荷 + 连接器(原始提供程序时间 + 规范化字段)

通道工具返回提供程序原生时间戳并添加规范化字段以保持一致性:
  • timestampMs: epoch 毫秒(UTC)
  • timestampUtc: ISO 8601 UTC 字符串
保留原始提供程序字段,因此不会丢失任何内容。
  • Slack: 来自 API 的 epoch 样式字符串
  • Discord: UTC ISO 时间戳
  • Telegram/WhatsApp: 提供程序特定的数字/ISO 时间戳
如果您需要本地时间,请使用已知时区在下游进行转换。

​
相关文档