Technical reference
तारीख और समय
OpenClaw डिफ़ॉल्ट रूप से ट्रांसपोर्ट टाइमस्टैम्प के लिए होस्ट-स्थानीय समय और सिस्टम प्रॉम्प्ट में केवल उपयोगकर्ता समय क्षेत्र का उपयोग करता है।
प्रदाता टाइमस्टैम्प सुरक्षित रखे जाते हैं ताकि टूल अपने मूल अर्थ बनाए रखें (वर्तमान समय session_status के माध्यम से उपलब्ध है)।
संदेश एनवलप (डिफ़ॉल्ट रूप से स्थानीय)
इनबाउंड संदेशों को टाइमस्टैम्प (सेकंड सटीकता) के साथ रैप किया जाता है:
[Provider ... 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" }, },}envelopeTimezone: "utc"UTC का उपयोग करता है।envelopeTimezone: "local"होस्ट समय क्षेत्र का उपयोग करता है।envelopeTimezone: "user"agents.defaults.userTimezoneका उपयोग करता है (होस्ट समय क्षेत्र पर वापस जाता है)।- स्थिर क्षेत्र के लिए स्पष्ट IANA समय क्षेत्र (जैसे,
"America/Chicago") का उपयोग करें। envelopeTimestamp: "off"एनवलप हेडर, सीधे एजेंट प्रॉम्प्ट प्रीफ़िक्स, और एम्बेडेड मॉडल-इनपुट प्रीफ़िक्स से पूर्ण टाइमस्टैम्प हटाता है।envelopeElapsed: "off"बीता हुआ समय प्रत्यय (+2mशैली) हटाता है।
उदाहरण
स्थानीय (डिफ़ॉल्ट):
[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जब एजेंट को वर्तमान समय की आवश्यकता हो, तो session_status टूल का उपयोग करें; स्थिति
कार्ड में एक टाइमस्टैम्प पंक्ति शामिल होती है।
सिस्टम इवेंट पंक्तियां (डिफ़ॉल्ट रूप से स्थानीय)
एजेंट संदर्भ में डाले गए कतारबद्ध सिस्टम इवेंट को संदेश एनवलप जैसी उसी समय क्षेत्र चयन के साथ टाइमस्टैम्प प्रीफ़िक्स दिया जाता है (डिफ़ॉल्ट: होस्ट-स्थानीय)।
System: [2026-01-12 12:19:17 PST] Model switched.उपयोगकर्ता समय क्षेत्र + फ़ॉर्मैट कॉन्फ़िगर करें
{ agents: { defaults: { userTimezone: "America/Chicago", timeFormat: "auto", // auto | 12 | 24 }, },}userTimezoneप्रॉम्प्ट संदर्भ के लिए उपयोगकर्ता-स्थानीय समय क्षेत्र सेट करता है।timeFormatप्रॉम्प्ट में 12h/24h प्रदर्शन नियंत्रित करता है।autoOS प्राथमिकताओं का पालन करता है।
समय फ़ॉर्मैट पहचान (ऑटो)
जब timeFormat: "auto" होता है, OpenClaw OS प्राथमिकता (macOS/Windows)
की जांच करता है और लोकैल फ़ॉर्मैटिंग पर वापस जाता है। बार-बार सिस्टम कॉल से बचने के लिए पहचाना गया मान प्रति प्रक्रिया कैश किया जाता है।
टूल पेलोड + कनेक्टर (कच्चा प्रदाता समय + सामान्यीकृत फ़ील्ड)
चैनल टूल प्रदाता-मूल टाइमस्टैम्प लौटाते हैं और संगति के लिए सामान्यीकृत फ़ील्ड जोड़ते हैं:
timestampMs: एपॉक मिलीसेकंड (UTC)timestampUtc: ISO 8601 UTC स्ट्रिंग
कच्चे प्रदाता फ़ील्ड सुरक्षित रखे जाते हैं ताकि कुछ भी खो न जाए।
- Slack: API से एपॉक-जैसी स्ट्रिंग
- Discord: UTC ISO टाइमस्टैम्प
- Telegram/WhatsApp: प्रदाता-विशिष्ट संख्यात्मक/ISO टाइमस्टैम्प
यदि आपको स्थानीय समय चाहिए, तो ज्ञात समय क्षेत्र का उपयोग करके इसे डाउनस्ट्रीम में कन्वर्ट करें।