时区

OpenClaw 对时间戳进行标准化，使模型看到单一的参考时间。

消息信封（默认为本地时间）

入站消息被包装在如下信封中：

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

信封中的时间戳默认为主机本地时间，精确到分钟。

你可以通过以下配置进行覆盖：

“`json5 theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
{
agents: {
defaults: {
envelopeTimezone: “local”, // “utc” | “local” | “user” | IANA 时区
envelopeTimestamp: “on”, // “on” | “off”
envelopeElapsed: “on”, // “on” | “off”
},
},
}

* `envelopeTimezone: "utc"` 使用 UTC。
* `envelopeTimezone: "user"` 使用 `agents.defaults.userTimezone`（回退到主机时区）。
* 使用显式 IANA 时区（例如 `"Europe/Vienna"`）可设置固定偏移量。
* `envelopeTimestamp: "off"` 从信封头中移除绝对时间戳。
* `envelopeElapsed: "off"` 移除已用时间后缀（`+2m` 样式）。

### 示例

**本地时间（默认）：**

[Signal Alice +1555 2026-01-18 00:19 PST] hello

**固定时区：**

[Signal Alice +1555 2026-01-18 06:19 GMT+1] hello

**已用时间：**

[Signal Alice +1555 +2m 2026-01-18T05:19Z] follow-up

## 工具负载（原始提供商数据 + 规范化字段）

工具调用（`channels.discord.readMessages`、`channels.slack.readMessages` 等）返回**原始提供商时间戳**。我们还附加规范化字段以保持一致性：

* `timestampMs`（UTC 纪元毫秒数）
* `timestampUtc`（ISO 8601 UTC 字符串）

原始提供商字段保持不变。

## 系统提示词的用户时区

设置 `agents.defaults.userTimezone` 来告知模型用户的本地时区。如果未设置，OpenClaw 会在运行时**解析主机时区**（无需写入配置）。

```json5  theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: { defaults: { userTimezone: "America/Chicago" } },
}

系统提示词包含：

• Current Date & Time 部分，显示本地时间和时区
• Time format: 12-hour 或 24-hour

你可以通过 agents.defaults.timeFormat（auto | 12 | 24）控制提示词格式。

详情参见日期与时间的完整行为和示例。