---
read_when:
    - बग रिपोर्ट या सहायता अनुरोध तैयार करना
    - Gateway क्रैश, पुनः आरंभ, मेमोरी दबाव या अत्यधिक बड़े पेलोड की डीबगिंग
    - कौन-सा डायग्नोस्टिक्स डेटा रिकॉर्ड या संशोधित किया जाता है, इसकी समीक्षा करना
summary: बग रिपोर्ट के लिए साझा किए जा सकने वाले Gateway डायग्नोस्टिक्स बंडल बनाएँ
title: डायग्नोस्टिक्स निर्यात
x-i18n:
    generated_at: "2026-07-27T19:40:23Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 97a805fed8d51de2e63e5c6a12ce03e91701d69654882cca7795c9f3553b1c55
    source_path: gateway/diagnostics.md
    workflow: 16
---

OpenClaw बग रिपोर्टों के लिए एक स्थानीय डायग्नोस्टिक्स `.zip` बना सकता है: सैनिटाइज़ किया गया Gateway
स्टेटस, हेल्थ, लॉग, कॉन्फ़िगरेशन संरचना और हाल की पेलोड-रहित स्थिरता घटनाएँ।

समीक्षा किए जाने तक डायग्नोस्टिक्स बंडलों को सीक्रेट की तरह संभालें। पेलोड और क्रेडेंशियल
डिज़ाइन के अनुसार संपादित कर दिए जाते हैं, लेकिन बंडल फिर भी स्थानीय Gateway लॉग और
होस्ट-स्तरीय रनटाइम स्थिति का सारांश देता है।

## त्वरित शुरुआत

```bash
openclaw gateway diagnostics export
```

लिखी गई zip का पथ प्रिंट करता है। आउटपुट पथ चुनें:

```bash
openclaw gateway diagnostics export --output openclaw-diagnostics.zip
```

ऑटोमेशन के लिए:

```bash
openclaw gateway diagnostics export --json
```

## चैट कमांड

स्थानीय Gateway एक्सपोर्ट को कॉपी-पेस्ट किए जा सकने वाले एक सपोर्ट रिपोर्ट के रूप में अनुरोध करने के लिए
ओनर किसी भी वार्तालाप में `/diagnostics [note]` चला सकते हैं:

1. `/diagnostics` भेजें, वैकल्पिक रूप से एक संक्षिप्त नोट के साथ (`/diagnostics bad tool choice`)।
2. OpenClaw एक प्रस्तावना भेजता है और एक स्पष्ट exec अनुमोदन माँगता है, जो
   `openclaw gateway diagnostics export --json` चलाता है। डायग्नोस्टिक्स को
   सभी को अनुमति देने वाले नियम के माध्यम से अनुमोदित न करें।
3. अनुमोदन के बाद, OpenClaw स्थानीय बंडल पथ, मेनिफ़ेस्ट
   सारांश, गोपनीयता नोट्स और संबंधित सेशन आईडी के साथ उत्तर देता है।

ग्रुप चैट में, कोई ओनर फिर भी `/diagnostics` चला सकता है, लेकिन OpenClaw एक्सपोर्ट
परिणाम, अनुमोदन प्रॉम्प्ट और Codex सेशन/थ्रेड विवरण
ओनर को निजी तौर पर भेजता है। ग्रुप को केवल एक संक्षिप्त सूचना दिखाई देती है कि डायग्नोस्टिक्स
निजी तौर पर भेजे गए हैं। यदि ओनर तक पहुँचने का कोई निजी मार्ग मौजूद नहीं है, तो कमांड सुरक्षित रूप से विफल होता है और
ओनर से इसे DM से चलाने के लिए कहता है।

जब सक्रिय सेशन नेटिव OpenAI Codex हार्नेस का उपयोग करता है, तो वही exec
अनुमोदन उन Codex थ्रेड के लिए OpenAI फ़ीडबैक अपलोड को भी कवर करता है जिनके बारे में OpenClaw
जानता है। वह अपलोड स्थानीय Gateway zip से अलग है और केवल
Codex हार्नेस सेशन के लिए होता है। अनुमोदन प्रॉम्प्ट बताता है कि अनुमोदन करने से
Codex सेशन या थ्रेड आईडी सूचीबद्ध किए बिना Codex फ़ीडबैक भी भेजा जाता है। अनुमोदन के
बाद, उत्तर उन थ्रेड के चैनल, OpenClaw सेशन आईडी, Codex थ्रेड आईडी और
स्थानीय रिज़्यूम कमांड सूचीबद्ध करता है जिन्हें OpenAI को भेजा गया था। अनुमोदन अस्वीकार करने या
अनदेखा करने पर एक्सपोर्ट, Codex फ़ीडबैक अपलोड और
Codex आईडी सूची छोड़ दी जाती है।

इससे Codex डीबगिंग लूप छोटा हो जाता है: किसी चैनल में खराब व्यवहार पर ध्यान दें,
`/diagnostics` चलाएँ, एक बार अनुमोदित करें, रिपोर्ट साझा करें, फिर यदि आप स्वयं थ्रेड की जाँच करना चाहते हैं
तो प्रिंट किया गया `codex resume <thread-id>` कमांड स्थानीय रूप से चलाएँ।
[Codex हार्नेस](/hi/plugins/codex-harness#inspect-codex-threads-locally) देखें।

## एक्सपोर्ट में क्या शामिल है

- `summary.md`: सपोर्ट के लिए मानव-पठनीय अवलोकन।
- `diagnostics.json`: कॉन्फ़िगरेशन, लॉग, स्टेटस, हेल्थ
  और स्थिरता डेटा का मशीन-पठनीय सारांश।
- `manifest.json`: एक्सपोर्ट मेटाडेटा और फ़ाइल सूची।
- सैनिटाइज़ की गई कॉन्फ़िगरेशन संरचना और गैर-गोपनीय कॉन्फ़िगरेशन विवरण।
- सैनिटाइज़ किए गए लॉग सारांश और हाल की संपादित लॉग पंक्तियाँ।
- यथासंभव सर्वोत्तम Gateway स्टेटस और हेल्थ स्नैपशॉट।
- `stability/latest.json`: उपलब्ध होने पर नवीनतम स्थायी स्थिरता बंडल।

Gateway अस्वस्थ होने पर भी एक्सपोर्ट उपयोगी रहता है: यदि स्टेटस/हेल्थ
अनुरोध विफल होते हैं, तो उपलब्ध होने पर स्थानीय लॉग, कॉन्फ़िगरेशन संरचना और नवीनतम स्थिरता बंडल
फिर भी एकत्र किए जाते हैं।

## गोपनीयता मॉडल

रखा जाता है: सबसिस्टम नाम, plugin आईडी, प्रोवाइडर आईडी, चैनल आईडी, कॉन्फ़िगर किए गए
मोड, स्टेटस कोड, अवधियाँ, बाइट संख्या, क्यू स्थिति, मेमोरी रीडिंग,
सैनिटाइज़ किया गया लॉग मेटाडेटा, संपादित परिचालन संदेश, कॉन्फ़िगरेशन संरचना और
गैर-गोपनीय फ़ीचर सेटिंग्स।

छोड़ा या संपादित किया जाता है: चैट टेक्स्ट, प्रॉम्प्ट, निर्देश, webhook बॉडी, टूल
आउटपुट, क्रेडेंशियल, API कुंजियाँ, टोकन, कुकी, सीक्रेट मान, कच्ची
अनुरोध/प्रतिक्रिया बॉडी, अकाउंट आईडी, संदेश आईडी, कच्चे सेशन आईडी,
होस्टनाम और स्थानीय उपयोगकर्ता नाम।

जब कोई लॉग संदेश उपयोगकर्ता, चैट, प्रॉम्प्ट या टूल पेलोड टेक्स्ट जैसा दिखाई देता है, तो
एक्सपोर्ट केवल यह जानकारी और उसकी बाइट संख्या रखता है कि कोई संदेश छोड़ दिया गया था।

## स्थिरता रिकॉर्डर

डायग्नोस्टिक्स सक्षम होने पर Gateway डिफ़ॉल्ट रूप से एक सीमित, पेलोड-रहित स्थिरता स्ट्रीम
रिकॉर्ड करता है। यह सामग्री नहीं, बल्कि परिचालन तथ्य कैप्चर करता है।

जब इवेंट लूप या CPU संतृप्त दिखाई देता है, तो वही Heartbeat लाइवनेस का नमूना भी लेता है,
और इवेंट-लूप विलंब, इवेंट-लूप उपयोग, CPU-कोर अनुपात,
सक्रिय/प्रतीक्षारत/क्यू किए गए सेशन की संख्या, वर्तमान स्टार्टअप/रनटाइम चरण (जब ज्ञात हो),
हाल के चरण अंतराल और सीमित कार्य लेबल के साथ `diagnostic.liveness.warning` घटनाएँ उत्सर्जित करता है।
ये Gateway में `warn`-स्तरीय लॉग पंक्तियाँ केवल तब बनती हैं जब
कार्य प्रतीक्षारत या क्यू में हो, या सक्रिय कार्य लगातार इवेंट-लूप
विलंब के साथ ओवरलैप करे; अन्यथा वे `debug` पर लॉग होती हैं। निष्क्रिय लाइवनेस नमूने फिर भी
डायग्नोस्टिक घटनाओं के रूप में रिकॉर्ड होते हैं, लेकिन स्वयं कभी चेतावनी स्तर तक नहीं बढ़ते।

स्टार्टअप चरण वॉल-क्लॉक और
CPU टाइमिंग के साथ `diagnostic.phase.completed` घटनाएँ उत्सर्जित करते हैं। रुके हुए एम्बेडेड-रन डायग्नोस्टिक्स `terminalProgressStale=true`
चिह्नित करते हैं, जब अंतिम ब्रिज प्रगति अंतिम स्थिति वाली दिखाई देती है (उदाहरण के लिए कोई कच्चा प्रतिक्रिया
आइटम या प्रतिक्रिया-पूर्णता घटना), लेकिन Gateway अब भी
एम्बेडेड रन को सक्रिय मानता है।

लाइव रिकॉर्डर की जाँच करें:

```bash
openclaw gateway stability
openclaw gateway stability --type payload.large
openclaw gateway stability --json
```

घातक निकास, शटडाउन टाइमआउट या
रीस्टार्ट स्टार्टअप विफलता के बाद नवीनतम स्थायी बंडल की जाँच करें:

```bash
openclaw gateway stability --bundle latest
```

नवीनतम स्थायी बंडल से डायग्नोस्टिक्स zip बनाएँ:

```bash
openclaw gateway stability --bundle latest --export
```

घटनाएँ मौजूद होने पर स्थायी बंडल `~/.openclaw/logs/stability/` के अंतर्गत रहते हैं।

## उपयोगी विकल्प

```bash
openclaw gateway diagnostics export \
  --output openclaw-diagnostics.zip \
  --log-lines 5000 \
  --log-bytes 1000000
```

| फ़्लैग                    | डिफ़ॉल्ट                                                                       | विवरण                                        |
| ----------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------- |
| `--output <path>`       | `$OPENCLAW_STATE_DIR/logs/support/openclaw-diagnostics-<timestamp>-<pid>.zip` | किसी विशिष्ट zip पथ (या डायरेक्टरी) में लिखें।       |
| `--log-lines <count>`   | `5000`                                                                        | शामिल की जाने वाली सैनिटाइज़ की गई लॉग पंक्तियों की अधिकतम संख्या।            |
| `--log-bytes <bytes>`   | `1000000`                                                                     | जाँच किए जाने वाले लॉग बाइट की अधिकतम संख्या।                      |
| `--url <url>`           | -                                                                             | स्टेटस/हेल्थ स्नैपशॉट के लिए Gateway WebSocket URL। |
| `--token <token>`       | -                                                                             | स्टेटस/हेल्थ स्नैपशॉट के लिए Gateway टोकन।         |
| `--password <password>` | -                                                                             | स्टेटस/हेल्थ स्नैपशॉट के लिए Gateway पासवर्ड।      |
| `--timeout <ms>`        | `3000`                                                                        | स्टेटस/हेल्थ स्नैपशॉट टाइमआउट।                    |
| `--no-stability-bundle` | बंद                                                                           | स्थायी स्थिरता बंडल लुकअप छोड़ें।            |
| `--json`                | बंद                                                                           | मशीन-पठनीय एक्सपोर्ट मेटाडेटा प्रिंट करें।            |

## डायग्नोस्टिक्स अक्षम करें

डायग्नोस्टिक्स डिफ़ॉल्ट रूप से सक्षम हैं। स्थिरता रिकॉर्डर और
डायग्नोस्टिक घटना संग्रह को अक्षम करने के लिए:

```json5
{
  diagnostics: {
    enabled: false,
  },
}
```

डायग्नोस्टिक्स अक्षम करने से बग रिपोर्ट का विवरण कम हो जाता है; यह सामान्य
Gateway लॉगिंग को प्रभावित नहीं करता।

मेमोरी दबाव घटनाएँ फ़ाइल-सिस्टम स्कैन किए या
प्री-OOM स्नैपशॉट लिखे बिना RSS, हीप, सीमा और वृद्धि से संबंधित तथ्य
(`rss_threshold`, `heap_threshold`, `rss_growth`) रिकॉर्ड करती हैं।

## संबंधित

- [हेल्थ जाँच](/hi/gateway/health)
- [Gateway CLI](/hi/cli/gateway#gateway-diagnostics-export)
- [Gateway प्रोटोकॉल](/hi/gateway/protocol#rpc-method-families)
- [लॉगिंग](/hi/logging)
- [OpenTelemetry एक्सपोर्ट](/hi/gateway/opentelemetry) - डायग्नोस्टिक्स को कलेक्टर तक स्ट्रीम करने के लिए अलग प्रवाह