Skip to main content

डिबगिंग

यह पृष्ठ स्ट्रीमिंग आउटपुट के लिए डिबगिंग सहायक टूल्स को कवर करता है, विशेषकर तब जब कोई प्रदाता सामान्य टेक्स्ट में तर्क को मिला देता है।

रनटाइम डिबग ओवरराइड्स

Use /debug in chat to set runtime-only config overrides (memory, not disk). /debug is disabled by default; enable with commands.debug: true. This is handy when you need to toggle obscure settings without editing openclaw.json. उदाहरण:
/debug reset सभी ओवरराइड्स साफ़ करता है और ऑन-डिस्क कॉन्फ़िग पर लौटता है।

Gateway वॉच मोड

तेज़ दोहराव के लिए, Gateway को फ़ाइल वॉचर के तहत चलाएँ:
यह इसके बराबर मैप होता है:
gateway:watch के बाद कोई भी Gateway CLI फ़्लैग जोड़ें और वे हर रीस्टार्ट पर पास-थ्रू हो जाएँगे।

डेव प्रोफ़ाइल + डेव Gateway (—dev)

Use the dev profile to isolate state and spin up a safe, disposable setup for debugging. There are two --dev flags:
  • ग्लोबल --dev (प्रोफ़ाइल): स्थिति को ~/.openclaw-dev के अंतर्गत अलग करता है और Gateway पोर्ट को डिफ़ॉल्ट रूप से 19001 पर सेट करता है (व्युत्पन्न पोर्ट्स उसी के साथ शिफ्ट होते हैं)।
  • gateway --dev: Gateway को डिफ़ॉल्ट कॉन्फ़िग + वर्कस्पेस स्वतः बनाने के लिए बताता है जब वे अनुपस्थित हों (और BOOTSTRAP.md को स्किप करता है)।
अनुशंसित फ़्लो (डेव प्रोफ़ाइल + डेव बूटस्ट्रैप):
यदि आपके पास अभी ग्लोबल इंस्टॉल नहीं है, तो CLI को pnpm openclaw ... के माध्यम से चलाएँ। यह क्या करता है:
  1. प्रोफ़ाइल आइसोलेशन (ग्लोबल --dev)
    • OPENCLAW_PROFILE=dev
    • OPENCLAW_STATE_DIR=~/.openclaw-dev
    • OPENCLAW_CONFIG_PATH=~/.openclaw-dev/openclaw.json
    • OPENCLAW_GATEWAY_PORT=19001 (ब्राउज़र/कैनवास उसी अनुसार शिफ्ट होते हैं)
  2. डेव बूटस्ट्रैप (gateway --dev)
    • अनुपस्थित होने पर न्यूनतम कॉन्फ़िग लिखता है (gateway.mode=local, loopback पर bind)।
    • agent.workspace को डेव वर्कस्पेस पर सेट करता है।
    • agent.skipBootstrap=true सेट करता है (BOO TSTRAP.md नहीं)।
    • वर्कस्पेस फ़ाइलों को, यदि अनुपस्थित हों, सीड करता है: AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md
    • डिफ़ॉल्ट पहचान: C3‑PO (प्रोटोकॉल ड्रॉइड)।
    • डेव मोड में चैनल प्रदाताओं को स्किप करता है (OPENCLAW_SKIP_CHANNELS=1)।
रीसेट फ़्लो (ताज़ा शुरुआत):
Note: --dev is a global profile flag and gets eaten by some runners. If you need to spell it out, use the env var form:
--reset कॉन्फ़िग, क्रेडेंशियल्स, सत्रों और डेव वर्कस्पेस को साफ़ करता है (उपयोग करते हुए trash, rm नहीं), फिर डिफ़ॉल्ट डेव सेटअप को पुनः बनाता है। सुझाव: यदि कोई नॉन‑डेव Gateway पहले से चल रहा हो (launchd/systemd), तो पहले उसे रोकें:

रॉ स्ट्रीम लॉगिंग (OpenClaw)

OpenClaw can log the raw assistant stream before any filtering/formatting. This is the best way to see whether reasoning is arriving as plain text deltas (or as separate thinking blocks). CLI के माध्यम से सक्षम करें:
वैकल्पिक पाथ ओवरराइड:
समतुल्य env vars:
डिफ़ॉल्ट फ़ाइल: ~/.openclaw/logs/raw-stream.jsonl

रॉ चंक लॉगिंग (pi-mono)

ब्लॉक्स में पार्स होने से पहले कच्चे OpenAI‑compat चंक्स कैप्चर करने के लिए, pi-mono एक अलग लॉगर एक्सपोज़ करता है:
वैकल्पिक पाथ:
डिफ़ॉल्ट फ़ाइल: ~/.pi-mono/logs/raw-openai-completions.jsonl
टिप्पणी: यह केवल उन प्रक्रियाओं द्वारा उत्सर्जित होता है जो pi-mono के openai-completions प्रदाता का उपयोग करती हैं।

सुरक्षा नोट्स

  • रॉ स्ट्रीम लॉग्स में पूर्ण प्रॉम्प्ट्स, टूल आउटपुट और उपयोगकर्ता डेटा शामिल हो सकता है।
  • लॉग्स को स्थानीय रखें और डिबगिंग के बाद उन्हें हटा दें।
  • यदि आप लॉग्स साझा करते हैं, तो पहले सीक्रेट्स और PII को स्क्रब करें।