时区

OpenClaw 对时间戳进行标准化，使模型看到单一参考时间，而不是混杂的提供商本地时钟。以下三个界面会显示时区，各有不同用途：

三个时区界面

系统提示词特意省略实时时钟，以保持各轮次间的提示词缓存稳定。当智能体需要当前时间时，它会调用 session_status。

设置用户时区

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

如果未设置 userTimezone，OpenClaw 会在运行时通过 Intl.DateTimeFormat().resolvedOptions().timeZone 解析主机时区（不会写入配置）。agents.defaults.timeFormat（auto | 12 | 24）控制信封和下游界面中的 12 小时制或 24 小时制呈现方式，但不影响系统提示词部分。

信封时区值

agents.defaults.envelopeTimezone 接受：

• "local"（默认）或 "host"——主机的时区。
• "utc" 或 "gmt"——UTC。
• "user"——解析后的 agents.defaults.userTimezone（如未设置，则回退到主机时区）。
• 任何明确的 IANA 时区字符串，例如 "Europe/Vienna"。

何时覆盖

• 使用 "utc"，可在不同地区的主机之间保持时间戳稳定，或与采用 UTC 的诊断/日志输出保持一致。
• 使用 "user"，可使信封始终与配置的用户时区保持一致，无论 Gateway 网关主机在哪个时区运行。
• 使用固定的 IANA 时区，适用于 Gateway 网关主机位于一个时区，但无论主机如何迁移，信封都应始终按另一个时区显示的情况。
• 当时间戳上下文对对话无用时，设置 envelopeTimestamp: "off"。这会从信封、直接智能体提示词前缀和嵌入式模型输入前缀中移除绝对时间戳。

有关完整的行为参考、各提供商示例以及经过时间格式，请参阅日期与时间。

相关内容

• 日期与时间——完整的信封/工具/提示词行为及示例。
• Heartbeat——活跃时段使用时区进行调度。
• Cron 作业——cron 表达式使用时区进行调度。