CLI commands

लॉग्स

openclaw logs

RPC के माध्यम से Gateway फ़ाइल लॉग को टेल करें। रिमोट मोड में काम करता है।

विकल्प

  • --limit <n>: लौटाई जाने वाली लॉग पंक्तियों की अधिकतम संख्या (डिफ़ॉल्ट 200)
  • --max-bytes <n>: लॉग फ़ाइल से पढ़े जाने वाले बाइट्स की अधिकतम संख्या (डिफ़ॉल्ट 250000)
  • --follow: लॉग स्ट्रीम का अनुसरण करें
  • --interval <ms>: अनुसरण करते समय पोलिंग अंतराल (डिफ़ॉल्ट 1000)
  • --json: पंक्ति-सीमांकित JSON इवेंट उत्सर्जित करें
  • --plain: शैलीबद्ध फ़ॉर्मैटिंग के बिना सादा टेक्स्ट आउटपुट
  • --no-color: ANSI रंग अक्षम करें
  • --local-time: टाइमस्टैम्प आपके स्थानीय समय क्षेत्र में रेंडर करें (डिफ़ॉल्ट)
  • --utc: टाइमस्टैम्प UTC में रेंडर करें

साझा Gateway RPC विकल्प

  • --url <url>: Gateway WebSocket URL
  • --token <token>: Gateway टोकन
  • --timeout <ms>: मिलीसेकंड में टाइमआउट (डिफ़ॉल्ट 30000)
  • --expect-final: Gateway कॉल एजेंट-समर्थित होने पर अंतिम प्रतिक्रिया की प्रतीक्षा करें

--url पास करने से स्वतः लागू किए गए कॉन्फ़िगरेशन क्रेडेंशियल छोड़ दिए जाते हैं; यदि लक्षित Gateway को प्रमाणीकरण की आवश्यकता है, तो --token स्पष्ट रूप से शामिल करें।

उदाहरण

bash
openclaw logsopenclaw logs --followopenclaw --dev logs --followopenclaw --profile work logs --followopenclaw logs --follow --interval 2000openclaw logs --limit 500 --max-bytes 500000openclaw logs --jsonopenclaw logs --plainopenclaw logs --no-coloropenclaw logs --utcopenclaw logs --follow --local-timeopenclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

चयनित रूट प्रोफ़ाइल Gateway की रोलिंग फ़ाइल से मेल खाती है: डिफ़ॉल्ट प्रोफ़ाइल openclaw-YYYY-MM-DD.log का उपयोग करती है, जबकि नामित प्रोफ़ाइल openclaw-<profile>-YYYY-MM-DD.log का उपयोग करती हैं (उदाहरण के लिए, openclaw-dev-YYYY-MM-DD.log)।

फ़ॉलबैक और पुनर्प्राप्ति व्यवहार

  • यदि अंतर्निहित स्थानीय लूपबैक Gateway पेयरिंग माँगता है, कनेक्ट करते समय बंद हो जाता है, या logs.tail के उत्तर देने से पहले टाइमआउट हो जाता है, तो openclaw logs स्वचालित रूप से कॉन्फ़िगर की गई Gateway फ़ाइल लॉग पर फ़ॉलबैक करता है। स्पष्ट --url लक्ष्य कभी इस फ़ॉलबैक का उपयोग नहीं करते।
  • अंतर्निहित स्थानीय Gateway RPC विफलता के बाद --follow उस कॉन्फ़िगर की गई फ़ाइल पर फ़ॉलबैक नहीं करता—साथ-साथ मौजूद पुरानी फ़ाइल लाइव टेल के बारे में भ्रमित कर सकती है। Linux पर, उपलब्ध होने पर यह इसके बजाय PID के आधार पर सक्रिय उपयोगकर्ता-systemd Gateway जर्नल का उपयोग करता है (चयनित स्रोत प्रिंट करता है); अन्यथा यह लाइव Gateway से दोबारा जुड़ने का प्रयास जारी रखता है।
  • --follow के दौरान, अस्थायी डिस्कनेक्शन (WebSocket बंद होना, टाइमआउट, कनेक्शन टूटना) एक्सपोनेंशियल बैकऑफ़ के साथ स्वचालित पुनः कनेक्शन शुरू करते हैं: अधिकतम 8 पुनः प्रयास, प्रयासों के बीच अधिकतम 30s। प्रत्येक पुनः प्रयास पर stderr में चेतावनी प्रिंट होती है, और पोल सफल होने पर एक बार [logs] gateway reconnected सूचना प्रिंट होती है। --json मोड में दोनों stderr पर {"type":"notice"} रिकॉर्ड के रूप में उत्सर्जित होते हैं। अप्राप्य त्रुटियाँ (प्रमाणीकरण विफलता, खराब कॉन्फ़िगरेशन) अब भी तुरंत बाहर निकलती हैं।
  • --follow --json मोड में, लॉग-स्रोत परिवर्तन {"type":"meta"} रिकॉर्ड के रूप में उत्सर्जित होते हैं। प्रत्येक sourceKind के लिए कर्सर ट्रैक करें: कोई स्ट्रीम Gateway फ़ाइल आउटपुट (sourceKind: "file") से स्थानीय जर्नल फ़ॉलबैक (sourceKind: "journal", localFallback: true, service.pid/service.unit के साथ) पर जा सकती है और पुनर्प्राप्ति के बाद वापस Gateway फ़ाइल आउटपुट पर आ सकती है। पूरे सत्र के लिए एक स्थिर स्रोत या कर्सर न मानें, और पुनर्प्राप्ति के दौरान Gateway फ़ाइल कर्सर फिर से चलाए जाने पर ओवरलैप होती पंक्तियों को स्वीकार करें।

संबंधित

Was this useful?
On this page

On this page