ClawCN - OpenClaw 中文版

主题

日期与时间 ​

OpenClaw 默认对传输时间戳使用主机本地时间,仅在系统提示中使用用户时区。 保留提供商时间戳,以便工具保持其原生语义(当前时间可通过 session_status 获取)。

消息信封(默认为本地) ​

入站消息会包装一个时间戳(分钟精度):

[Provider ... 2026-01-05 16:26 PST] message text

此信封时间戳默认为主机本地时间,与提供商时区无关。

您可以覆盖此行为:

json5
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      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.

配置用户时区 + 格式 ​

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

时间格式检测(自动) ​

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

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

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

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

保留原始提供商字段,因此不会丢失任何信息。

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

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

相关文档 ​