日期和时间
openclaw 默认使用主机本地时间作为传输时间戳,仅在系统提示中使用用户时区。 提供程序时间戳被保留,以便工具保持其原生语义(当前时间可通过 session_status 获取)。
消息信封(默认本地)
传入消息包装有时间戳(分钟精度):
[Provider ... 2026-01-05 16:26 PST] 消息文本此信封时间戳默认为主机本地时间,无论提供程序时区如何。
您可以覆盖此行为:
json5
{
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] 你好用户时区:
[WhatsApp +1555 2026-01-18 00:19 CST] 你好启用经过时间:
[WhatsApp +1555 +30s 2026-01-18T05:19Z] 后续消息系统提示:当前日期和时间
如果用户时区已知,系统提示包含一个专门的 当前日期和时间部分,仅包含时区(无时钟/时间格式) 以保持提示缓存稳定:
时区:America/Chicago当智能体需要当前时间时,使用 session_status 工具;状态 卡片包含一个时间戳行。
系统事件行(默认本地)
插入到智能体上下文中的排队系统事件使用与 消息信封相同的时区选择(默认:主机本地)添加时间戳前缀。
系统:[2026-01-12 12:19:17 PST] 模型已切换。配置用户时区 + 格式
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 时间戳
如果您需要本地时间,请使用已知时区在下游转换。