简要总结
Timezones
这页说明书在讲“时间”这个魔法标签。你知道吗？电脑和机器人聊天时，需要知道每条消息是“什么时候”说的。这页就是教你如何给消息贴上正确的时间标签，这样机器人就不会搞混时间啦！当你需要设置机器人的时间，或者想知道消息上的时间是怎么来的，就可以看看这页。
五岁小孩版解释
OpenClaw 会把所有的时间都变成一种标准的样子，这样机器人看时间的时候就不会糊涂了。你可以把它想成把全世界不同的钟表，都调到一个统一的“参考时间”上。
首先，我们来看看消息的“信封”。每条消息外面都包着一个“信封”，上面写着时间。这个时间默认是你自己电脑的时间，精确到分钟。信封的样子像这样：[Provider ... 2026-01-05 16:26 PST] 消息内容。
你可以用一些设置来改变信封上的时间标签。这些设置写在配置文件里，就像给机器人写小纸条一样。
- 设置时间标签的时区：用
envelopeTimezone这个设置。你可以把它想成选择用哪个城市的钟表来显示时间。- 写
"local"，就用你电脑自己的时间（这是默认的）。 - 写
"utc"，就用全世界统一的“协调世界时”。 - 写
"user"，就用你给用户设置的时间（userTimezone），如果没设置，就还是用电脑的时间。 - 你也可以直接写一个城市的名字，比如
"Europe/Vienna"，这样时间就固定用那个城市的时间了。
- 写
- 要不要显示具体时间：用
envelopeTimestamp这个设置。写"on"就显示，写"off"就不显示。 - 要不要显示过了多久：用
envelopeElapsed这个设置。写"on"，信封上就会多一个像+2m（表示过了2分钟）这样的标签。写"off"就不显示。
这里要小心：这些设置是写在 agents.defaults 下面的，别写错地方了哦。
接下来，当机器人使用工具（比如 channels.discord.readMessages 去读消息）时，它会收到消息的原始时间。但为了保持统一，我们还会给它两个整理好的时间字段：timestampMs（一个很长的时间数字）和 timestampUtc（一个标准的时间字符串）。原来的时间信息也会保留着。
最后，为了让机器人知道“你”在哪个时区，你需要告诉它。这通过设置 agents.defaults.userTimezone 来完成，比如 "America/Chicago"。如果你不设置，机器人就会用你电脑的时区。机器人知道了你的时区后，会在它的“系统提示”里加上“当前日期和时间”这一部分，这样它和你聊天时就能知道你的本地时间了。你还可以用 agents.defaults.timeFormat 设置它显示时间是12小时制（比如下午3点）还是24小时制（比如15点）。