跳转至

时区

OpenClaw 标准化时间戳,使模型看到单一参考时间,而不是混合的提供商本地时钟。三个时区展示面各自具有不同用途:

三个时区展示面

展示面 显示内容 默认值 配置方式
消息封装 封装入站频道消息:[Signal +1555 Sun 2026-01-18 00:19:42 PST] hello 未设置 userTimezone 时为主机时区 agents.defaults.userTimezone
工具载荷 频道 readMessages 风格工具返回原始提供商时间以及规范化后的 timestampMs / timestampUtc UTC 字段始终存在 不可配置;保留提供商原生时间戳
运行时上下文 每轮包含本地日期和时区的 Temporal Context 块;精确时间仍由工具提供 未设置 userTimezone 时为主机时区 agents.defaults.userTimezone

日期和时区位于当前轮的运行时上下文中,位于系统提示之外。日期跨天时,该上下文会更新,同时保留完整的系统提示和较早的对话字节,以便复用前缀缓存。该上下文有意省略实时时钟;当代理需要精确当前时间且 session_status 可用时,它会调用该工具。

设置用户时区

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

如果未设置 userTimezone,OpenClaw 会在运行时通过 Intl.DateTimeFormat().resolvedOptions().timeZone 解析主机时区,而不写入配置。相同的 已解析时区用于消息封装、队列中的系统事件、提示中的本地 日期以及心跳活跃时段。

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

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

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

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw