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

​
OpenClaw के साथ एक व्यक्तिगत सहायक बनाना

OpenClaw is a WhatsApp + Telegram + Discord + iMessage gateway for Pi agents. Plugins add Mattermost. This guide is the “personal assistant” setup: one dedicated WhatsApp number that behaves like your always-on agent.

​
⚠️ सुरक्षा पहले

आप एक एजेंट को ऐसी स्थिति में रख रहे हैं जहाँ वह:
  • आपकी मशीन पर कमांड चला सकता है (आपके Pi टूल सेटअप पर निर्भर)
  • आपके वर्कस्पेस में फ़ाइलें पढ़/लिख सकता है
  • WhatsApp/Telegram/Discord/Mattermost (plugin) के माध्यम से संदेश वापस भेज सकता है
संयम से शुरू करें:
  • हमेशा channels.whatsapp.allowFrom सेट करें (अपने व्यक्तिगत Mac पर कभी भी ओपन-टू-द-वर्ल्ड न चलाएँ)।
  • सहायक के लिए एक समर्पित WhatsApp नंबर उपयोग करें।
  • Heartbeats now default to every 30 minutes. Disable until you trust the setup by setting agents.defaults.heartbeat.every: "0m".

​
पूर्वापेक्षाएँ

  • OpenClaw इंस्टॉल और ऑनबोर्ड किया हुआ — यदि अभी तक नहीं किया है तो Getting Started देखें
  • सहायक के लिए एक दूसरा फ़ोन नंबर (SIM/eSIM/प्रीपेड)

​
दो-फ़ोन सेटअप (अनुशंसित)

आप यह चाहते हैं: If you link your personal WhatsApp to OpenClaw, every message to you becomes “agent input”. That’s rarely what you want.

​
5-मिनट त्वरित प्रारंभ

  1. WhatsApp Web को पेयर करें (QR दिखेगा; सहायक फ़ोन से स्कैन करें):
openclaw channels login
  1. Gateway शुरू करें (इसे चलता रहने दें):
openclaw gateway --port 18789
  1. ~/.openclaw/openclaw.json में एक न्यूनतम config रखें:
{
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}
अब allowlist किए गए फ़ोन से सहायक नंबर पर संदेश भेजें। जब ऑनबोर्डिंग समाप्त होती है, हम डैशबोर्ड अपने आप खोलते हैं और एक साफ़ (नॉन-टोकनाइज़्ड) लिंक प्रिंट करते हैं। If it prompts for auth, paste the token from gateway.auth.token into Control UI settings. To reopen later: openclaw dashboard.

​
एजेंट को एक वर्कस्पेस दें (AGENTS)

OpenClaw अपने वर्कस्पेस डायरेक्टरी से ऑपरेटिंग निर्देश और “मेमोरी” पढ़ता है। By default, OpenClaw uses ~/.openclaw/workspace as the agent workspace, and will create it (plus starter AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md) automatically on setup/first agent run. BOOTSTRAP.md is only created when the workspace is brand new (it should not come back after you delete it). MEMORY.md is optional (not auto-created); when present, it is loaded for normal sessions. Subagent sessions only inject AGENTS.md and TOOLS.md. टिप: इस फ़ोल्डर को OpenClaw की “memory” की तरह मानें और इसे एक git repo बनाएं (आदर्श रूप से निजी), ताकि आपकी AGENTS.md + मेमोरी फ़ाइलें बैकअप हो सकें। If git is installed, brand-new workspaces are auto-initialized. 
openclaw setup
पूरा वर्कस्पेस लेआउट + बैकअप गाइड: Agent workspace
मेमोरी वर्कफ़्लो: Memory वैकल्पिक: agents.defaults.workspace के साथ एक अलग वर्कस्पेस चुनें (समर्थन करता है ~)। 
{
  agent: {
    workspace: "~/.openclaw/workspace",
  },
}
यदि आप पहले से किसी repo से अपने वर्कस्पेस फ़ाइलें शिप करते हैं, तो आप बूटस्ट्रैप फ़ाइल निर्माण को पूरी तरह अक्षम कर सकते हैं: 
{
  agent: {
    skipBootstrap: true,
  },
}

​
“एक असिस्टेंट” बनाने वाला config

OpenClaw डिफ़ॉल्ट रूप से एक अच्छा असिस्टेंट सेटअप देता है, लेकिन आमतौर पर आप यह ट्यून करना चाहेंगे:
  • SOUL.md में persona/निर्देश
  • थिंकिंग डिफ़ॉल्ट्स (यदि वांछित)
  • हार्टबीट्स (जब भरोसा हो जाए)
उदाहरण: 
{
  logging: { level: "info" },
  agent: {
    model: "anthropic/claude-opus-4-6",
    workspace: "~/.openclaw/workspace",
    thinkingDefault: "high",
    timeoutSeconds: 1800,
    // Start with 0; enable later.
    heartbeat: { every: "0m" },
  },
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  routing: {
    groupChat: {
      mentionPatterns: ["@openclaw", "openclaw"],
    },
  },
  session: {
    scope: "per-sender",
    resetTriggers: ["/new", "/reset"],
    reset: {
      mode: "daily",
      atHour: 4,
      idleMinutes: 10080,
    },
  },
}

​
सत्र और मेमोरी

  • सत्र फ़ाइलें: ~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl
  • सत्र मेटाडेटा (टोकन उपयोग, अंतिम रूट, आदि): ~/.openclaw/agents/<agentId>/sessions/sessions.json (legacy: ~/.openclaw/sessions/sessions.json)
  • /new or /reset starts a fresh session for that chat (configurable via resetTriggers). यदि इसे अकेले भेजा जाए, तो एजेंट रीसेट की पुष्टि करने के लिए एक छोटा सा hello जवाब देता है।
  • /compact [instructions] सत्र संदर्भ को संक्षिप्त करता है और शेष संदर्भ बजट की रिपोर्ट करता है।

​
हार्टबीट्स (प्रोएक्टिव मोड)

By default, OpenClaw runs a heartbeat every 30 minutes with the prompt: Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. यदि किसी चीज़ पर ध्यान देने की आवश्यकता नहीं है, तो HEARTBEAT_OK का जवाब दें। अक्षम करने के लिए agents.defaults.heartbeat.every: "0m" सेट करें।
  • यदि HEARTBEAT.md मौजूद है लेकिन प्रभावी रूप से खाली है (केवल खाली पंक्तियाँ और markdown हेडर्स जैसे # Heading), तो API कॉल बचाने के लिए OpenClaw हार्टबीट रन छोड़ देता है।
  • यदि फ़ाइल गायब है, तो हार्टबीट फिर भी चलता है और मॉडल तय करता है कि क्या करना है।
  • यदि एजेंट HEARTBEAT_OK के साथ उत्तर देता है (वैकल्पिक रूप से छोटा padding; देखें agents.defaults.heartbeat.ackMaxChars), तो OpenClaw उस हार्टबीट के लिए आउटबाउंड डिलीवरी को दबा देता है।
  • हार्टबीट्स पूर्ण एजेंट टर्न चलाते हैं — कम अंतराल अधिक टोकन खर्च करते हैं।
{
  agent: {
    heartbeat: { every: "30m" },
  },
}

​
मीडिया इन और आउट

इनबाउंड अटैचमेंट्स (छवियाँ/ऑडियो/डॉक्स) टेम्पलेट्स के माध्यम से आपके कमांड तक पहुँचाए जा सकते हैं:
  • {{MediaPath}} (local temp फ़ाइल पथ)
  • {{MediaUrl}} (pseudo-URL)
  • {{Transcript}} (यदि ऑडियो ट्रांसक्रिप्शन सक्षम है)
Outbound attachments from the agent: include MEDIA:<path-or-url> on its own line (no spaces). उदाहरण: 
Here’s the screenshot.
MEDIA:https://example.com/screenshot.png
OpenClaw इन्हें निकालता है और टेक्स्ट के साथ मीडिया के रूप में भेजता है।

​
संचालन चेकलिस्ट

openclaw status          # local status (creds, sessions, queued events)
openclaw status --all    # full diagnosis (read-only, pasteable)
openclaw status --deep   # adds gateway health probes (Telegram + Discord)
openclaw health --json   # gateway health snapshot (WS)
लॉग्स /tmp/openclaw/ के अंतर्गत रहते हैं (डिफ़ॉल्ट: openclaw-YYYY-MM-DD.log)।

​
अगले कदम