시간대

OpenClaw은 타임스탬프를 표준화하여 모델이 단일 참조 시간을 보도록 합니다.

메시지 엔벨로프 (기본값: 현지 시간)

수신 메시지는 다음과 같은 엔벨로프로 래핑됩니다:

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

엔벨로프의 타임스탬프는 기본적으로 호스트 현지 시간이며 분 단위 정밀도입니다.

다음 설정으로 오버라이드할 수 있습니다:

{
  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이 런타임에 호스트 시간대를 해석합니다(설정 파일 쓰기 없음).

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

시스템 프롬프트에 포함되는 항목:

  • 현지 시간과 시간대가 포함된 Current Date & Time 섹션
  • Time format: 12-hour 또는 24-hour

agents.defaults.timeFormat(auto | 12 | 24)으로 프롬프트 형식을 제어할 수 있습니다.

전체 동작과 예시는 날짜 및 시간을 참고하세요.