मुख्य सामग्री पर जाएं

​
विन्यास

OpenClaw ~/.openclaw/openclaw.json से एक वैकल्पिक विन्यास पढ़ता है। यदि फ़ाइल मौजूद नहीं है, तो OpenClaw सुरक्षित डिफ़ॉल्ट्स का उपयोग करता है। कॉन्फ़िग जोड़ने के सामान्य कारण:
  • चैनल कनेक्ट करना और यह नियंत्रित करना कि कौन बॉट को संदेश भेज सकता है
  • मॉडल, टूल्स, सैंडबॉक्सिंग, या ऑटोमेशन (cron, hooks) सेट करना
  • सेशंस, मीडिया, नेटवर्किंग, या UI को ट्यून करना
उपलब्ध सभी फ़ील्ड्स के लिए पूर्ण संदर्भ देखें।
विन्यास में नए हैं? इंटरैक्टिव सेटअप के लिए openclaw onboard से शुरू करें, या पूर्ण कॉपी‑पेस्ट कॉन्फ़िग्स के लिए Configuration Examples गाइड देखें।

​
न्यूनतम विन्यास

// ~/.openclaw/openclaw.json
{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

​
कॉन्फ़िग संपादन

openclaw onboard       # पूरा सेटअप विज़ार्ड
openclaw configure     # कॉन्फ़िग विज़ार्ड

​
सख्त सत्यापन

OpenClaw केवल वही कॉन्फ़िगरेशन स्वीकार करता है जो स्कीमा से पूरी तरह मेल खाते हों। अज्ञात keys, गलत प्रकार, या अमान्य मान होने पर Gateway स्टार्ट होने से मना कर देता है। रूट-लेवल पर एकमात्र अपवाद $schema (string) है, ताकि एडिटर्स JSON Schema मेटाडेटा संलग्न कर सकें।
जब सत्यापन विफल होता है:
  • Gateway बूट नहीं होता
  • केवल डायग्नोस्टिक कमांड्स काम करते हैं (openclaw doctor, openclaw logs, openclaw health, openclaw status)
  • सटीक समस्याएँ देखने के लिए openclaw doctor चलाएँ
  • मरम्मत लागू करने के लिए openclaw doctor --fix (या --yes) चलाएँ

​
सामान्य कार्य

प्रत्येक चैनल का अपना कॉन्फ़िग सेक्शन channels.<provider> के अंतर्गत होता है। सेटअप स्टेप्स के लिए संबंधित चैनल पेज देखें:सभी चैनल एक समान DM पॉलिसी पैटर्न साझा करते हैं:
{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc",
      dmPolicy: "pairing",   // pairing | allowlist | open | disabled
      allowFrom: ["tg:123"], // only for allowlist/open
    },
  },
}
प्राइमरी मॉडल और वैकल्पिक फॉलबैक्स सेट करें:
{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-sonnet-4-5",
        fallbacks: ["openai/gpt-5.2"],
      },
      models: {
        "anthropic/claude-sonnet-4-5": { alias: "Sonnet" },
        "openai/gpt-5.2": { alias: "GPT" },
      },
    },
  },
}
  • agents.defaults.models मॉडल कैटलॉग परिभाषित करता है और /model के लिए allowlist के रूप में कार्य करता है।
  • मॉडल रेफ़ provider/model प्रारूप का उपयोग करते हैं (उदा. anthropic/claude-opus-4-6)।
  • चैट में मॉडल बदलने के लिए Models CLI और ऑथ रोटेशन/फॉलबैक व्यवहार के लिए Model Failover देखें।
  • कस्टम/सेल्फ-होस्टेड प्रोवाइडर्स के लिए संदर्भ में Custom providers देखें।
DM एक्सेस प्रति चैनल dmPolicy के माध्यम से नियंत्रित होता है:
  • "pairing" (डिफ़ॉल्ट): अज्ञात प्रेषकों को अनुमोदन के लिए एक-बार का पेयरिंग कोड मिलता है
  • "allowlist": केवल allowFrom (या पेयर्ड allow स्टोर) में मौजूद प्रेषक
  • "open": सभी इनबाउंड DMs की अनुमति (आवश्यक: allowFrom: ["*"])
  • "disabled": सभी DMs को अनदेखा करें
ग्रुप्स के लिए groupPolicy + groupAllowFrom या चैनल-विशिष्ट allowlists का उपयोग करें।विस्तृत जानकारी के लिए पूर्ण संदर्भ देखें।

​
Config hot reload

Gateway ~/.openclaw/openclaw.json को मॉनिटर करता है और अधिकतर सेटिंग्स के लिए बिना मैनुअल रीस्टार्ट के बदलाव लागू करता है।

​
Reload modes

ModeBehavior
hybrid (default)सुरक्षित बदलाव तुरंत लागू करता है; क्रिटिकल बदलाव पर स्वतः रीस्टार्ट।
hotकेवल सुरक्षित बदलाव लागू करता है; रीस्टार्ट की आवश्यकता होने पर चेतावनी देता है।
restartकिसी भी कॉन्फ़िग बदलाव पर Gateway रीस्टार्ट करता है।
offफ़ाइल मॉनिटरिंग अक्षम; बदलाव अगली मैनुअल रीस्टार्ट पर लागू होंगे।
{
  gateway: {
    reload: { mode: "hybrid", debounceMs: 300 },
  },
}
gateway.reload और gateway.remote में बदलाव रीस्टार्ट ट्रिगर नहीं करते।

​
पूर्ण संदर्भ

फ़ील्ड-दर-फ़ील्ड पूर्ण विवरण के लिए देखें Configuration Reference।
संबंधित: Configuration Examples · Configuration Reference · Doctor