OpenClawSkills
GitHub
コア概念 • 5分で読める

タイムゾーン

エージェント、エンベロープ、プロンプトのタイムゾーン処理

OpenClawはタイムスタンプを正規化し、モデルが単一の参照時刻を確認できるようにします。

Tutorial.step

メッセージエンベロープ(デフォルト:ローカル)

受信メッセージは次のようにエンベロープでラップされます:

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

エンベロープ内のタイムスタンプは分精度のデフォルトのホストローカルです。

以下でオーバーライドできます:

Json5
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}

- ''envelopeTimezone: "utc"'' でUTCを使用。

- ''envelopeTimezone: "user"'' で''agents.defaults.userTimezone''を使用(ホストタイムゾーンにフォールバック)。

- Use an explicit IANA timezone (e.g., `"Europe/Vienna"`) as a fixed offset.

- ''envelopeTimestamp: "off"'' でエンベロープヘッダーから絶対タイムスタンプを削除。

- ''envelopeElapsed: "off"'' で経過時間サフィックス(''+2m''スタイル)を削除。

#

Tutorial.step

Tool payloads (raw provider data + normalized fields)

Tool calls (''channels.discord.readMessages'', ''channels.slack.readMessages'', etc.) return **raw provider timestamps**.

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

固定タイムゾーン:

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

- ''timestampMs'' (UTC epoch milliseconds)

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

ツールペイロード(生プロバイダーデータ+正規化フィールド)

Set ''agents.defaults.userTimezone'' to tell the model the user's local time zone. If it is

一貫性のために正規化フィールドも追加します:

The system prompt includes:

- ''Current Date & Time'' section with local time and timezone

- ''Time format: 12-hour'' or ''24-hour''

Tutorial.step

システムプロンプトのユーザータイムゾーン

**Local (default):**

されていない場合、OpenClawは実行時にホストタイムゾーンを解析します(設定書き込みなし)。

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

システムプロンプトには以下が含まれます:

- ''Current Date & Time''セクション(ローカル時刻とタイムゾーン)

- ''Time format: 12-hour''または''24-hour''

''agents.defaults.timeFormat'' (''auto'' | ''12'' | ''24'')でプロンプト形式を制御できます。

完全な動作と例については、''日付と時刻''を参照してください。