跳到主要内容

时区 (Timezones)

Clawdbot 标准化了时间戳，使模型看到的是单一的参考时间。

消息信封 (默认本地)​

入站消息被包装在一个信封中，如下所示：

[Provider ... 2026-01-05 16:26 PST] 消息文本

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

您可以通过以下方式覆盖此设置：

{
  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 来告诉模型用户的本地时区。如果未设置，Clawdbot 会在运行时解析宿主机时区（不写入配置）。

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

系统提示词包括：

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

您可以使用 agents.defaults.timeFormat (auto | 12 | 24) 来控制提示词格式。

有关完整行为和示例，请参阅 日期与时间 (Date & Time)。