विन्यास

OpenClaw ~/.openclaw/openclaw.json से एक वैकल्पिक विन्यास पढ़ता है। यदि फ़ाइल मौजूद नहीं है, तो OpenClaw सुरक्षित डिफ़ॉल्ट्स का उपयोग करता है। कॉन्फ़िग जोड़ने के सामान्य कारण:

चैनल कनेक्ट करना और यह नियंत्रित करना कि कौन बॉट को संदेश भेज सकता है
मॉडल, टूल्स, सैंडबॉक्सिंग, या ऑटोमेशन (cron, hooks) सेट करना
सेशंस, मीडिया, नेटवर्किंग, या UI को ट्यून करना

उपलब्ध सभी फ़ील्ड्स के लिए पूर्ण संदर्भ देखें।

विन्यास में नए हैं? इंटरैक्टिव सेटअप के लिए openclaw onboard से शुरू करें, या पूर्ण कॉपी‑पेस्ट कॉन्फ़िग्स के लिए Configuration Examples गाइड देखें।

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

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

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

इंटरैक्टिव विज़ार्ड
CLI (वन-लाइनर्स)
Control UI
सीधा संपादन

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

openclaw config get agents.defaults.workspace
openclaw config set agents.defaults.heartbeat.every "2h"
openclaw config unset tools.web.search.apiKey

~/.openclaw/openclaw.json को सीधे संपादित करें। Gateway फ़ाइल को मॉनिटर करता है और बदलाव अपने आप लागू करता है (देखें hot reload)।

सख्त सत्यापन

OpenClaw केवल वही कॉन्फ़िगरेशन स्वीकार करता है जो स्कीमा से पूरी तरह मेल खाते हों। अज्ञात keys, गलत प्रकार, या अमान्य मान होने पर Gateway स्टार्ट होने से मना कर देता है। रूट-लेवल पर एकमात्र अपवाद $schema (string) है, ताकि एडिटर्स JSON Schema मेटाडेटा संलग्न कर सकें।

जब सत्यापन विफल होता है:

Gateway बूट नहीं होता
केवल डायग्नोस्टिक कमांड्स काम करते हैं (openclaw doctor, openclaw logs, openclaw health, openclaw status)
सटीक समस्याएँ देखने के लिए openclaw doctor चलाएँ
मरम्मत लागू करने के लिए openclaw doctor --fix (या --yes) चलाएँ

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

एक चैनल सेट करें (WhatsApp, Telegram, Discord, आदि)

प्रत्येक चैनल का अपना कॉन्फ़िग सेक्शन channels.<provider> के अंतर्गत होता है। सेटअप स्टेप्स के लिए संबंधित चैनल पेज देखें:

WhatsApp — channels.whatsapp
Telegram — channels.telegram
Discord — channels.discord
Slack — channels.slack
Signal — channels.signal
iMessage — channels.imessage
Google Chat — channels.googlechat
Mattermost — channels.mattermost
MS Teams — channels.msteams

सभी चैनल एक समान 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

Mode	Behavior
`hybrid` (default)	सुरक्षित बदलाव तुरंत लागू करता है; क्रिटिकल बदलाव पर स्वतः रीस्टार्ट।
`hot`	केवल सुरक्षित बदलाव लागू करता है; रीस्टार्ट की आवश्यकता होने पर चेतावनी देता है।
`restart`	किसी भी कॉन्फ़िग बदलाव पर Gateway रीस्टार्ट करता है।
`off`	फ़ाइल मॉनिटरिंग अक्षम; बदलाव अगली मैनुअल रीस्टार्ट पर लागू होंगे।

{
  gateway: {
    reload: { mode: "hybrid", debounceMs: 300 },
  },
}

gateway.reload और gateway.remote में बदलाव रीस्टार्ट ट्रिगर नहीं करते।

पूर्ण संदर्भ

फ़ील्ड-दर-फ़ील्ड पूर्ण विवरण के लिए देखें Configuration Reference।

संबंधित: Configuration Examples · Configuration Reference · Doctor

गेटवे

रिमोट एक्सेस

वेब इंटरफेस

विन्यास

विन्यास

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

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

सख्त सत्यापन

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

Config hot reload

Reload modes

पूर्ण संदर्भ

​विन्यास

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

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

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

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

​Config hot reload

​Reload modes

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

विन्यास

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

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

सख्त सत्यापन

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

Config hot reload

Reload modes

पूर्ण संदर्भ