跳转至

日期和时间

OpenClaw 为消息信封、系统事件和每轮运行时上下文使用已配置的 用户时区。当 agents.defaults.userTimezone 未设置时,这些场景使用主机时区。提供商时间戳会被保留,以便工具保持其原生语义。 当代理需要精确当前时间且 session_status 可用时,它会运行该工具。

消息信封(默认本地)

入站消息会被包装上星期几以及秒级精度的时间戳:

[WhatsApp +1555 Mon 2026-01-05 16:26:34 PST] message text

信封时间戳在配置时使用 agents.defaults.userTimezone,否则使用主机时区。绝对时间戳和经过时间后缀是内置的。

示例

本地(默认):

[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] hello

用户时区:

[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] hello

经过时间:

[WhatsApp +1555 +30s Sun 2026-01-18 00:20:12 CST] follow-up

运行时上下文:日期与时区

每一轮都会收到一个 时间上下文 部分,包含本地日历日期和时区,位于系统提示之外,并且没有实时时钟:

Current date: 2026-01-05
Time zone: America/Chicago

该时区在配置时为 agents.defaults.userTimezone,否则为主机时区。 该部分随当前轮次的运行时上下文传递,而不会重写较早的消息,因此日期切换会保留完整的系统提示和对话历史前缀以用于缓存。 Chat Completions 和原生 Ollama 默认在历史中保留隐藏的轮次上下文;显式的提供商重放策略可以覆盖该行为。正常的压缩预算仍然适用。 原始模型探测会省略 OpenClaw 运行时上下文。当可用时,session_status 仍然是精确当前时间的来源。

系统事件行(默认本地)

插入到代理上下文中的排队系统事件在配置时使用 agents.defaults.userTimezone,否则使用主机时区。

System: [2026-01-12 12:19:17 PST] Model switched.

配置用户时区

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
    },
  },
}
  • userTimezone 为消息信封、系统事件和提示上下文设置用户本地时区。
  • 使用 IANA 时区,例如 America/Chicago、Europe/Vienna 或 Asia/Tokyo。

时间格式检测

渲染的时钟值遵循操作系统和区域设置偏好。OpenClaw 在 macOS 和 Windows 上检测 12 小时制或 24 小时制显示,然后回退到区域设置格式化。检测到的值按进程缓存。

工具负载 + 连接器(原始提供商时间 + 规范化字段)

通道工具返回 提供商原生时间戳,并添加规范化字段以保持一致性:

  • timestampMs:纪元毫秒(UTC)
  • timestampUtc:ISO 8601 UTC 字符串

原始提供商字段会被保留,因此不会丢失任何内容。

  • Discord:UTC ISO 时间戳
  • Slack:来自 API 的类纪元字符串
  • Telegram/WhatsApp:提供商特定的数字/ISO 时间戳

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

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