时区

OpenClaw 标准化时间戳，使模型看到的是单一参考时间，而不是各提供方本地时钟的混合。三个展示面会显示时区，各有其用途：

三个时区展示面¶

日期和时区位于系统提示缓存边界之下，因此跨日不会使稳定的前缀失效。提示词有意省略实时时钟；当智能体需要精确的当前时间且 session_status 可用时，它会调用该工具。

设置用户时区¶

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

如果未设置 userTimezone，OpenClaw 会在运行时通过 Intl.DateTimeFormat().resolvedOptions().timeZone 解析主机时区，而无需写入配置。解析出的同一个时区将用于消息信封、已排队的系统事件、提示词中的本地日期以及心跳活跃时段。

时钟渲染遵循主机操作系统和区域设置偏好。没有单独的 12 小时或 24 小时配置项。

有关提供方示例和经过时间格式化，请参阅日期与时间。

相关¶

• 日期与时间 - 完整的消息信封/工具/系统提示行为及示例。
• 心跳 - 活跃时段使用时区进行调度。
• 定时任务 - cron 表达式使用时区进行调度。
• 系统提示 - Temporal Context 部分将用户本地日期和时区带入提示词。