Date and time

기준일: 2026-07-26
공식 기준: Date and time

Date and time 문서는 OpenClaw 공식 문서(date-time)를 한국어로 정리한 가이드입니다. Date and time handling across envelopes, prompts, tools, and connectors 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Date and time handling across envelopes, prompts, tools, and connectors

한국어 가이드 범위: date-time 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Message envelopes (local by default)
• 예제
• System prompt: current date and time
• System event lines (local by default)
• Configure user timezone + format
• Time format detection (auto)
• Tool payloads + connectors (raw provider time + normalized fields)
• Related docs

상세 내용

본문

OpenClaw uses host-local time for transport timestamps and puts only the time zone in the system prompt. Provider timestamps are preserved so tools keep their native semantics. When the agent needs the current time, it runs the session_status tool.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Message envelopes (local by default)

Inbound messages are wrapped with a weekday plus second-precision timestamp:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Key	Values	Behavior
envelopeTimezone	local (default), utc, user, explicit IANA name	user uses agents.defaults.userTimezone (host timezone when unset). An explicit IANA name (e.g. "America/Chicago") pins a fixed zone; unrecognized names fall back to UTC.
envelopeTimestamp	on (default), off	off removes absolute timestamps from envelope headers, direct agent prompt prefixes, and embedded model-input prefixes.
envelopeElapsed	on (default), off	off removes the elapsed-time suffix (the +30s / +2m style) shown since the previous message in the session.

[WhatsApp +1555 Mon 2026-01-05 16:26:34 PST] message text

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

예제

[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] hello

[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] hello

[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] follow-up

System prompt: current date and time

The system prompt includes a Current Date & Time section with the time zone only (no clock or time format) so prompt caching stays stable:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Time zone: America/Chicago

System event lines (local by default)

Queued system events inserted into agent context are prefixed with a timestamp using the same envelopeTimezone selection as message envelopes (default: host-local).

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

System: [2026-01-12 12:19:17 PST] Model switched.

Configure user timezone + format

주요 항목:

• userTimezone sets the user-local timezone for prompt context (and for envelopeTimezone: "user").
• timeFormat controls 12h/24h display in prompt-facing times. auto follows OS preferences.

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}

Time format detection (auto)

When timeFormat: "auto", OpenClaw inspects the OS preference (macOS and Windows) and falls back to locale formatting. The detected value is cached per process to avoid repeated system calls.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Tool payloads + connectors (raw provider time + normalized fields)

Channel tools return provider-native timestamps and add normalized fields for consistency:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• timestampMs: epoch milliseconds (UTC)
• timestampUtc: ISO 8601 UTC string
• Discord: UTC ISO timestamps
• Slack: epoch-like strings from the API
• Telegram/WhatsApp: provider-specific numeric/ISO timestamps

Related docs

주요 항목:

• System Prompt
• Timezones
• Messages

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/date-time
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

[WhatsApp +1555 Mon 2026-01-05 16:26:34 PST] message text

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

[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] hello

[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] hello

[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] follow-up

Time zone: America/Chicago

관련 링크

• 공식 원문: date-time
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.