日期和时间
OpenClaw 为消息信封、系统事件和每轮运行时上下文使用已配置的 用户时区。当 agents.defaults.userTimezone 未设置时,这些场景使用主机时区。提供商时间戳会被保留,以便工具保持其原生语义。
当代理需要精确当前时间且 session_status 可用时,它会运行该工具。
消息信封(默认本地)¶
入站消息会被包装上星期几以及秒级精度的时间戳:
信封时间戳在配置时使用 agents.defaults.userTimezone,否则使用主机时区。绝对时间戳和经过时间后缀是内置的。
示例¶
本地(默认):
用户时区:
经过时间:
运行时上下文:日期与时区¶
每一轮都会收到一个 时间上下文 部分,包含本地日历日期和时区,位于系统提示之外,并且没有实时时钟:
该时区在配置时为 agents.defaults.userTimezone,否则为主机时区。
该部分随当前轮次的运行时上下文传递,而不会重写较早的消息,因此日期切换会保留完整的系统提示和对话历史前缀以用于缓存。
Chat Completions 和原生 Ollama 默认在历史中保留隐藏的轮次上下文;显式的提供商重放策略可以覆盖该行为。正常的压缩预算仍然适用。
原始模型探测会省略 OpenClaw 运行时上下文。当可用时,session_status 仍然是精确当前时间的来源。
系统事件行(默认本地)¶
插入到代理上下文中的排队系统事件在配置时使用 agents.defaults.userTimezone,否则使用主机时区。
配置用户时区¶
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