Concept internals
समय क्षेत्र
OpenClaw टाइमस्टैम्प को मानकीकृत करता है ताकि मॉडल को प्रदाता-स्थानीय घड़ियों के मिश्रण के बजाय एकल संदर्भ समय दिखाई दे। तीन सतहें समय क्षेत्र दिखाती हैं, जिनमें से प्रत्येक का अपना उद्देश्य है:
तीन समय क्षेत्र सतहें
| सतह | यह क्या दिखाती है | डिफ़ॉल्ट | इसके माध्यम से कॉन्फ़िगर किया जाता है |
|---|---|---|---|
| संदेश आवरण | आने वाले चैनल संदेशों को लपेटता है: [Signal +1555 Sun 2026-01-18 00:19:42 PST] hello |
होस्ट-स्थानीय | agents.defaults.envelopeTimezone |
| टूल पेलोड | चैनल readMessages-शैली के टूल अपरिष्कृत प्रदाता समय के साथ सामान्यीकृत timestampMs / timestampUtc लौटाते हैं |
UTC फ़ील्ड हमेशा मौजूद रहते हैं | कॉन्फ़िगर करने योग्य नहीं; प्रदाता-मूल टाइमस्टैम्प सुरक्षित रखता है |
| सिस्टम प्रॉम्प्ट | केवल समय क्षेत्र वाला एक छोटा Current Date & Time ब्लॉक (कैश स्थिरता के लिए घड़ी का कोई मान नहीं) |
यदि userTimezone सेट न हो, तो होस्ट समय क्षेत्र |
agents.defaults.userTimezone |
सभी चरणों में प्रॉम्प्ट कैशिंग को स्थिर रखने के लिए सिस्टम प्रॉम्प्ट जानबूझकर लाइव घड़ी को शामिल नहीं करता। जब एजेंट को वर्तमान समय चाहिए होता है, तो वह session_status को कॉल करता है।
उपयोगकर्ता का समय क्षेत्र सेट करना
{ agents: { defaults: { userTimezone: "America/Chicago", }, },}यदि userTimezone सेट नहीं है, तो OpenClaw रनटाइम पर Intl.DateTimeFormat().resolvedOptions().timeZone के माध्यम से होस्ट का समय क्षेत्र निर्धारित करता है (कोई कॉन्फ़िगरेशन लेखन नहीं)। agents.defaults.timeFormat (auto | 12 | 24) आवरणों और डाउनस्ट्रीम सतहों में 12h/24h रेंडरिंग को नियंत्रित करता है, सिस्टम प्रॉम्प्ट अनुभाग में नहीं।
आवरण के समय क्षेत्र मान
agents.defaults.envelopeTimezone इन्हें स्वीकार करता है:
"local"(डिफ़ॉल्ट) या"host"- होस्ट मशीन का समय क्षेत्र।"utc"या"gmt"- UTC।"user"- निर्धारितagents.defaults.userTimezone(सेट न होने पर होस्ट समय क्षेत्र का उपयोग करता है)।- कोई भी स्पष्ट IANA क्षेत्र स्ट्रिंग, जैसे
"Europe/Vienna"।
कब ओवरराइड करें
- अलग-अलग क्षेत्रों के होस्ट पर स्थिर टाइमस्टैम्प के लिए, या UTC-संरेखित निदान/लॉग आउटपुट से मेल कराने के लिए
"utc"का उपयोग करें। - Gateway होस्ट चाहे किसी भी क्षेत्र में चल रहा हो, आवरणों को कॉन्फ़िगर किए गए उपयोगकर्ता समय क्षेत्र के अनुरूप रखने के लिए
"user"का उपयोग करें। - जब Gateway होस्ट एक क्षेत्र में हो, लेकिन होस्ट माइग्रेशन की परवाह किए बिना आवरण हमेशा किसी अन्य क्षेत्र का समय दिखाए, तब एक निश्चित IANA क्षेत्र का उपयोग करें।
- जब बातचीत के लिए टाइमस्टैम्प संदर्भ उपयोगी न हो, तब
envelopeTimestamp: "off"सेट करें। इससे आवरणों, प्रत्यक्ष एजेंट प्रॉम्प्ट उपसर्गों और एम्बेड किए गए मॉडल-इनपुट उपसर्गों से निरपेक्ष टाइमस्टैम्प हट जाते हैं।
व्यवहार के पूर्ण संदर्भ, प्रत्येक प्रदाता के उदाहरणों और बीते समय के स्वरूपण के लिए, दिनांक और समय देखें।
संबंधित
- दिनांक और समय - आवरण/टूल/प्रॉम्प्ट का पूर्ण व्यवहार और उदाहरण।
- Heartbeat - सक्रिय घंटे शेड्यूलिंग के लिए समय क्षेत्र का उपयोग करते हैं।
- Cron जॉब्स - Cron एक्सप्रेशन शेड्यूलिंग के लिए समय क्षेत्र का उपयोग करते हैं।
