날짜 및 시간

OpenClaw은 전송 타임스탬프에 호스트 현지 시간을 사용하며 시스템 프롬프트에는 시간대만 포함합니다. 도구가 공급자의 고유 의미 체계를 유지하도록 공급자 타임스탬프는 보존됩니다. 에이전트에 현재 시간이 필요하면 session_status 도구를 실행합니다.

메시지 봉투(기본값: 현지 시간)

수신 메시지는 요일과 초 단위 정밀도의 타임스탬프로 감싸집니다.

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

봉투 타임스탬프는 공급자 시간대와 관계없이 기본적으로 호스트 현지 시간입니다. agents.defaults에서 재정의할 수 있습니다.

{  agents: {    defaults: {      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA 시간대      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

envelopeTimezone: "utc"를 사용한 경과 시간:

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

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

프롬프트 캐싱을 안정적으로 유지하기 위해 시스템 프롬프트에는 시계 시각이나 시간 형식 없이 시간대만 표시하는 현재 날짜 및 시간 섹션이 포함됩니다.

Time zone: America/Chicago

설정된 경우 시간대는 agents.defaults.userTimezone이며, 그렇지 않으면 호스트 시간대입니다. 또한 시스템 프롬프트는 현재 날짜, 시간 또는 요일이 필요할 때마다 에이전트가 session_status 도구를 실행하도록 지시합니다.

시스템 이벤트 줄(기본값: 현지 시간)

에이전트 컨텍스트에 삽입되는 대기 중인 시스템 이벤트에는 메시지 봉투와 동일한 envelopeTimezone 선택을 사용한 타임스탬프 접두사가 붙습니다(기본값: 호스트 현지 시간).

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

사용자 시간대 및 형식 구성

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

• userTimezone은 프롬프트 컨텍스트의 사용자 현지 시간대를 설정합니다(envelopeTimezone: "user"에도 사용).
• timeFormat은 프롬프트에 표시되는 시간의 12시간제/24시간제 표시를 제어합니다. auto는 운영 체제 환경설정을 따릅니다.

시간 형식 감지(auto)

timeFormat: "auto"인 경우 OpenClaw은 운영 체제 환경설정(macOS 및 Windows)을 확인하고, 확인할 수 없으면 로캘 형식을 사용합니다. 감지된 값은 반복적인 시스템 호출을 방지하기 위해 프로세스별로 캐시됩니다.

도구 페이로드 및 커넥터(공급자의 원시 시간 및 정규화된 필드)

채널 도구는 공급자 고유 타임스탬프를 반환하며 일관성을 위해 정규화된 필드를 추가합니다.

• timestampMs: 에포크 밀리초(UTC)
• timestampUtc: ISO 8601 UTC 문자열

정보가 손실되지 않도록 공급자의 원시 필드는 보존됩니다.

• Discord: UTC ISO 타임스탬프
• Slack: API의 에포크 형식 문자열
• Telegram/WhatsApp: 공급자별 숫자/ISO 타임스탬프

현지 시간이 필요하면 알려진 시간대를 사용하여 후속 처리 단계에서 변환하십시오.

관련 문서

• 시스템 프롬프트
• 시간대
• 메시지