메인 콘텐츠로 건너뛰기

​
날짜 및 시간

OpenClaw는 기본적으로 전송 타임스탬프에는 호스트 로컬 시간을 사용하고, 사용자 시간대는 시스템 프롬프트에서만 사용합니다. 도구가 본래 의미 체계를 유지하도록 provider 타임스탬프는 보존됩니다(현재 시간은 session_status를 통해 사용할 수 있습니다).

​
메시지 엔벌로프(기본값: 로컬)

수신 메시지는 타임스탬프와 함께 래핑됩니다(분 단위 정밀도): 
[Provider ... 2026-01-05 16:26 PST] message text
이 엔벌로프 타임스탬프는 provider 시간대와 관계없이 기본적으로 호스트 로컬 시간입니다. 이 동작은 재정의할 수 있습니다: 
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
  • envelopeTimezone: "utc"는 UTC를 사용합니다.
  • envelopeTimezone: "local"은 호스트 시간대를 사용합니다.
  • envelopeTimezone: "user"는 agents.defaults.userTimezone을 사용합니다(호스트 시간대로 대체됨).
  • 고정 시간대에는 명시적인 IANA 시간대(예: "America/Chicago")를 사용하세요.
  • envelopeTimestamp: "off"는 엔벌로프 헤더에서 절대 타임스탬프를 제거합니다.
  • envelopeElapsed: "off"는 경과 시간 접미사(+2m 형식)를 제거합니다.

​
예시

로컬(기본값): 
[WhatsApp +1555 2026-01-18 00:19 PST] hello
사용자 시간대: 
[WhatsApp +1555 2026-01-18 00:19 CST] hello
경과 시간 활성화: 
[WhatsApp +1555 +30s 2026-01-18T05:19Z] follow-up

​
시스템 프롬프트: 현재 날짜 및 시간

사용자 시간대를 알고 있으면 시스템 프롬프트에는 프롬프트 캐싱을 안정적으로 유지하기 위해 시간대만 포함하는(시계/시간 형식 없음) 전용 Current Date & Time 섹션이 포함됩니다: 
Time zone: America/Chicago
에이전트가 현재 시간이 필요하면 session_status 도구를 사용하세요. 상태 카드에는 타임스탬프 줄이 포함됩니다.

​
시스템 이벤트 줄(기본값: 로컬)

에이전트 컨텍스트에 삽입되는 대기열 시스템 이벤트는 메시지 엔벌로프와 동일한 시간대 선택을 사용하여 타임스탬프가 앞에 붙습니다(기본값: 호스트 로컬). 
System: [2026-01-12 12:19:17 PST] Model switched.

​
사용자 시간대 + 형식 구성

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}
  • userTimezone은 프롬프트 컨텍스트용 사용자 로컬 시간대를 설정합니다.
  • timeFormat은 프롬프트에서의 12시간/24시간 표시를 제어합니다. auto는 OS 기본 설정을 따릅니다.

​
시간 형식 감지(auto)

timeFormat: "auto"일 때 OpenClaw는 OS 기본 설정(macOS/Windows)을 검사하고 locale 형식으로 대체합니다. 감지된 값은 반복적인 시스템 호출을 피하기 위해 프로세스별로 캐시됩니다.

​
도구 페이로드 + 커넥터(원시 provider 시간 + 정규화된 필드)

채널 도구는 provider 고유 타임스탬프를 반환하고 일관성을 위해 정규화된 필드를 추가합니다:
  • timestampMs: epoch 밀리초(UTC)
  • timestampUtc: ISO 8601 UTC 문자열
손실되는 정보가 없도록 원시 provider 필드는 보존됩니다.
  • Slack: API의 epoch 유사 문자열
  • Discord: UTC ISO 타임스탬프
  • Telegram/WhatsApp: provider별 숫자/ISO 타임스탬프
로컬 시간이 필요하면 알려진 시간대를 사용해 다운스트림에서 변환하세요.

​
관련 문서