Technical reference

तारीख और समय

OpenClaw डिफ़ॉल्ट रूप से ट्रांसपोर्ट टाइमस्टैम्प के लिए होस्ट-स्थानीय समय और सिस्टम प्रॉम्प्ट में केवल उपयोगकर्ता समय क्षेत्र का उपयोग करता है। प्रदाता टाइमस्टैम्प सुरक्षित रखे जाते हैं ताकि टूल अपने मूल अर्थ बनाए रखें (वर्तमान समय session_status के माध्यम से उपलब्ध है)।

संदेश एनवलप (डिफ़ॉल्ट रूप से स्थानीय)

इनबाउंड संदेशों को टाइमस्टैम्प (सेकंड सटीकता) के साथ रैप किया जाता है:

Code
[Provider ... Mon 2026-01-05 16:26:34 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: "local" होस्ट समय क्षेत्र का उपयोग करता है।
  • envelopeTimezone: "user" agents.defaults.userTimezone का उपयोग करता है (होस्ट समय क्षेत्र पर वापस जाता है)।
  • स्थिर क्षेत्र के लिए स्पष्ट IANA समय क्षेत्र (जैसे, "America/Chicago") का उपयोग करें।
  • envelopeTimestamp: "off" एनवलप हेडर, सीधे एजेंट प्रॉम्प्ट प्रीफ़िक्स, और एम्बेडेड मॉडल-इनपुट प्रीफ़िक्स से पूर्ण टाइमस्टैम्प हटाता है।
  • envelopeElapsed: "off" बीता हुआ समय प्रत्यय (+2m शैली) हटाता है।

उदाहरण

स्थानीय (डिफ़ॉल्ट):

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

उपयोगकर्ता समय क्षेत्र:

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

बीता हुआ समय सक्षम:

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

सिस्टम प्रॉम्प्ट: वर्तमान तारीख और समय

यदि उपयोगकर्ता समय क्षेत्र ज्ञात है, तो सिस्टम प्रॉम्प्ट में एक समर्पित वर्तमान तारीख और समय अनुभाग शामिल होता है, जिसमें केवल समय क्षेत्र होता है (कोई घड़ी/समय फ़ॉर्मैट नहीं) ताकि प्रॉम्प्ट कैशिंग स्थिर रहे:

Code
Time zone: America/Chicago

जब एजेंट को वर्तमान समय की आवश्यकता हो, तो session_status टूल का उपयोग करें; स्थिति कार्ड में एक टाइमस्टैम्प पंक्ति शामिल होती है।

सिस्टम इवेंट पंक्तियां (डिफ़ॉल्ट रूप से स्थानीय)

एजेंट संदर्भ में डाले गए कतारबद्ध सिस्टम इवेंट को संदेश एनवलप जैसी उसी समय क्षेत्र चयन के साथ टाइमस्टैम्प प्रीफ़िक्स दिया जाता है (डिफ़ॉल्ट: होस्ट-स्थानीय)।

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

उपयोगकर्ता समय क्षेत्र + फ़ॉर्मैट कॉन्फ़िगर करें

json5
{  agents: {    defaults: {      userTimezone: "America/Chicago",      timeFormat: "auto", // auto | 12 | 24    },  },}
  • userTimezone प्रॉम्प्ट संदर्भ के लिए उपयोगकर्ता-स्थानीय समय क्षेत्र सेट करता है।
  • timeFormat प्रॉम्प्ट में 12h/24h प्रदर्शन नियंत्रित करता है। auto OS प्राथमिकताओं का पालन करता है।

समय फ़ॉर्मैट पहचान (ऑटो)

जब timeFormat: "auto" होता है, OpenClaw OS प्राथमिकता (macOS/Windows) की जांच करता है और लोकैल फ़ॉर्मैटिंग पर वापस जाता है। बार-बार सिस्टम कॉल से बचने के लिए पहचाना गया मान प्रति प्रक्रिया कैश किया जाता है।

टूल पेलोड + कनेक्टर (कच्चा प्रदाता समय + सामान्यीकृत फ़ील्ड)

चैनल टूल प्रदाता-मूल टाइमस्टैम्प लौटाते हैं और संगति के लिए सामान्यीकृत फ़ील्ड जोड़ते हैं:

  • timestampMs: एपॉक मिलीसेकंड (UTC)
  • timestampUtc: ISO 8601 UTC स्ट्रिंग

कच्चे प्रदाता फ़ील्ड सुरक्षित रखे जाते हैं ताकि कुछ भी खो न जाए।

  • Slack: API से एपॉक-जैसी स्ट्रिंग
  • Discord: UTC ISO टाइमस्टैम्प
  • Telegram/WhatsApp: प्रदाता-विशिष्ट संख्यात्मक/ISO टाइमस्टैम्प

यदि आपको स्थानीय समय चाहिए, तो ज्ञात समय क्षेत्र का उपयोग करके इसे डाउनस्ट्रीम में कन्वर्ट करें।

संबंधित दस्तावेज़

Was this useful?
On this page

On this page