WhatsApp

​

इंस्टॉल करें

openclaw plugins install clawhub:@openclaw/whatsapp

​

त्वरित सेटअप

{
  channels: {
    whatsapp: {
      dmPolicy: "pairing",
      allowFrom: ["+15551234567"],
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

openclaw channels login --channel whatsapp

openclaw channels login --channel whatsapp --account work

openclaw channels add --channel whatsapp --account work --auth-dir /path/to/wa-auth
openclaw channels login --channel whatsapp --account work

openclaw gateway

openclaw pairing list whatsapp
openclaw pairing approve whatsapp <CODE>

​

डिप्लॉयमेंट पैटर्न

{
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"],
    },
  },
}

​

रनटाइम मॉडल

• Gateway WhatsApp सॉकेट और पुनः कनेक्ट लूप का स्वामी है।
• एक वॉचडॉग दो संकेतों को स्वतंत्र रूप से ट्रैक करता है: मूल WhatsApp Web ट्रांसपोर्ट गतिविधि और एप्लिकेशन-संदेश गतिविधि। हाल में कोई संदेश न आने मात्र से किसी शांत लेकिन कनेक्टेड सत्र को पुनः शुरू नहीं किया जाता; यह केवल तभी बलपूर्वक पुनः कनेक्ट करता है, जब ट्रांसपोर्ट फ़्रेम एक निश्चित आंतरिक अवधि (उपयोगकर्ता द्वारा कॉन्फ़िगर करने योग्य नहीं) तक आना बंद कर दें या एप्लिकेशन संदेश सामान्य संदेश टाइमआउट के 4x से अधिक समय तक न आएँ। हाल में सक्रिय रहे सत्र के पुनः कनेक्ट होने के तुरंत बाद, पहली अवधि 4x अवधि के बजाय छोटे सामान्य संदेश टाइमआउट का उपयोग करती है। उस पुनः कनेक्ट के दौरान Baileys द्वारा पहले ही डिलीवर किए गए ऑफ़लाइन संदेशों का OpenClaw स्वतः उत्तर दे सकता है, जिसकी सीमा आने वाले संदेश-ID की डीडुप्लिकेशन अवधि से निर्धारित होती है; आरंभिक स्टार्टअप छोटे पुराने-इतिहास सुरक्षा उपाय को बनाए रखता है।
• आउटबाउंड प्रेषण के लिए लक्ष्य खाते का सक्रिय WhatsApp लिसनर आवश्यक है; अन्यथा प्रेषण तुरंत विफल हो जाता है।
• जब टोकन वर्तमान प्रतिभागी मेटाडेटा से मेल खाता है, तब समूह प्रेषण @+<digits> और @<digits> टोकन (टेक्स्ट और मीडिया कैप्शन में) के लिए नेटिव उल्लेख मेटाडेटा जोड़ते हैं; इसमें LID-समर्थित समूह भी शामिल हैं।
• स्टेटस और ब्रॉडकास्ट चैट (@status, @broadcast) अनदेखी की जाती हैं।
• प्रत्यक्ष चैट DM सत्र नियमों का उपयोग करती हैं (session.dmScope; डिफ़ॉल्ट main DM को एजेंट के मुख्य सत्र में समेट देता है)। समूह सत्र प्रत्येक JID के अनुसार अलग रखे जाते हैं (agent:<agentId>:whatsapp:group:<jid>)।
• WhatsApp चैनल/न्यूज़लेटर अपने नेटिव @newsletter JID के माध्यम से स्पष्ट आउटबाउंड लक्ष्य हो सकते हैं, जो DM अर्थविज्ञान के बजाय चैनल सत्र मेटाडेटा (agent:<agentId>:whatsapp:channel:<jid>) का उपयोग करते हैं।
• WhatsApp Web ट्रांसपोर्ट Gateway होस्ट पर मानक प्रॉक्सी एनवायरनमेंट वेरिएबल (HTTPS_PROXY, HTTP_PROXY, NO_PROXY, लोअरकेस रूपांतर) का पालन करता है। प्रति-चैनल सेटिंग के बजाय होस्ट-स्तरीय प्रॉक्सी कॉन्फ़िगरेशन को प्राथमिकता दें।

​

MeowCaller से वर्तमान अनुरोधकर्ता को कॉल करें (प्रायोगिक)

{
  "channels": {
    "whatsapp": {
      "actions": {
        "calls": true
      }
    }
  }
}

git clone --branch feat/send-only-notify https://github.com/steipete/meowcaller.git
cd meowcaller
git checkout 752050471fc2bf7a8cdfbf7dbd3cd4e865d85d3f
mkdir -p "$HOME/.local/bin"
go build -o "$HOME/.local/bin/meowcaller" ./cmd/meowcaller

state_dir="$HOME/.openclaw/credentials/whatsapp-calls/default"
mkdir -p "$state_dir"
chmod 700 "$state_dir"
meowcaller pair --store "$state_dir/wa-voip.db"

​

स्वीकृति प्रॉम्प्ट

{
  approvals: {
    exec: {
      enabled: true,
      mode: "session",
    },
    plugin: {
      enabled: true,
      mode: "targets",
      targets: [{ channel: "whatsapp", to: "+15551234567" }],
    },
  },
}

​

प्रश्न प्रतिक्रियाएँ

​

Plugin हुक और गोपनीयता

{
  channels: {
    whatsapp: {
      pluginHooks: {
        messageReceived: true,
      },
    },
  },
}

​

पहुँच नियंत्रण और सक्रियण

​

कॉन्फ़िगर किए गए ACP बाइंडिंग

{
  bindings: [
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "whatsapp",
        accountId: "work",
        peer: { kind: "direct", id: "+15555550123" },
      },
    },
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "whatsapp",
        accountId: "work",
        peer: { kind: "group", id: "120363424282127706@g.us" },
      },
    },
  ],
}

​

व्यक्तिगत नंबर और स्वयं-चैट व्यवहार

​

संदेश सामान्यीकरण और संदर्भ

[Replying to <sender> id:<stanzaId>]
<quoted body or media placeholder>
[/Replying]

{ channels: { whatsapp: { sendReadReceipts: false } } }

​

डिलीवरी, खंडन और मीडिया

​

उत्तर उद्धरण

{ channels: { whatsapp: { replyToMode: "first" } } }

​

प्रतिक्रिया स्तर

{ channels: { whatsapp: { reactionLevel: "ack" } } }

​

पावती प्रतिक्रियाएँ

{
  channels: {
    whatsapp: {
      ackReaction: {
        emoji: "👀",
        direct: true,
        group: "mentions", // हमेशा | उल्लेख | कभी नहीं
      },
    },
  },
}

​

जीवनचक्र स्थिति प्रतिक्रियाएँ

{
  messages: {
    statusReactions: {
      enabled: true,
    },
  },
}

​

बहु-अकाउंट और क्रेडेंशियल्स

​

टूल, कार्रवाइयाँ और कॉन्फ़िगरेशन लेखन

• एजेंट टूल समर्थन में WhatsApp प्रतिक्रिया कार्रवाई (react) शामिल है।
• कार्रवाई गेट: channels.whatsapp.actions.reactions, channels.whatsapp.actions.polls (मौजूदा कार्रवाइयों का डिफ़ॉल्ट true है), channels.whatsapp.actions.calls (डिफ़ॉल्ट false, ऊपर MeowCaller देखें)।
• चैनल द्वारा आरंभ किए गए कॉन्फ़िगरेशन लेखन डिफ़ॉल्ट रूप से सक्षम हैं; channels.whatsapp.configWrites: false के माध्यम से अक्षम करें।

​

समस्या निवारण

openclaw channels login --channel whatsapp
openclaw channels status

openclaw channels status --probe
openclaw doctor
openclaw logs --follow
openclaw gateway status

cp -a ~/.openclaw/credentials/whatsapp/<accountId> \
  ~/.openclaw/credentials/whatsapp/<accountId>.bak
openclaw channels logout --channel whatsapp --account <accountId>
openclaw channels login --channel whatsapp --account <accountId>

​

सिस्टम प्रॉम्प्ट

1. समूह-विशिष्ट प्रॉम्प्ट (groups["<groupId>"].systemPrompt): इसका उपयोग तब किया जाता है जब समूह प्रविष्टि मौजूद हो और उसकी systemPrompt कुंजी परिभाषित हो। रिक्त स्ट्रिंग ("") वाइल्डकार्ड को दबाती है और कोई प्रॉम्प्ट लागू नहीं करती।
2. समूह वाइल्डकार्ड प्रॉम्प्ट (groups["*"].systemPrompt): इसका उपयोग तब किया जाता है जब विशिष्ट समूह प्रविष्टि अनुपस्थित हो, या वह systemPrompt कुंजी के बिना मौजूद हो।

• channels.whatsapp.groups प्रति-समूह कॉन्फ़िगरेशन मैप और चैट-स्तरीय समूह अनुमति-सूची, दोनों है। रूट या खाता स्कोप में, groups["*"] का अर्थ उस स्कोप के लिए “सभी समूह स्वीकार किए जाते हैं” है।
• वाइल्डकार्ड systemPrompt केवल तभी जोड़ें, जब आप पहले से उस स्कोप में सभी समूह स्वीकार करना चाहते हों। केवल समूह आईडी के निश्चित समूह को पात्र रखने के लिए, groups["*"] का उपयोग करने के बजाय प्रत्येक स्पष्ट रूप से अनुमति-सूचीबद्ध प्रविष्टि पर प्रॉम्प्ट दोहराएँ।
• समूह स्वीकृति और प्रेषक प्राधिकरण अलग-अलग जाँच हैं। groups["*"] उन समूहों का दायरा बढ़ाता है जो समूह प्रबंधन तक पहुँचते हैं; यह उन समूहों के प्रत्येक प्रेषक को अधिकृत नहीं करता — वह अब भी groupPolicy/groupAllowFrom द्वारा नियंत्रित होता है।
• channels.whatsapp.direct का DM के लिए कोई समकक्ष दुष्प्रभाव नहीं है: direct["*"] केवल तभी डिफ़ॉल्ट कॉन्फ़िगरेशन देता है, जब DM को dmPolicy के साथ allowFrom या पेयरिंग-स्टोर नियमों द्वारा पहले ही स्वीकार किया जा चुका हो।

{
  channels: {
    whatsapp: {
      groups: {
        // केवल तभी उपयोग करें जब रूट स्कोप में सभी समूह स्वीकार किए जाने चाहिए।
        // उन सभी खातों पर लागू होता है जो अपना groups मैप परिभाषित नहीं करते।
        "*": { systemPrompt: "सभी समूहों के लिए डिफ़ॉल्ट प्रॉम्प्ट।" },
      },
      direct: {
        // उन सभी खातों पर लागू होता है जो अपना direct मैप परिभाषित नहीं करते।
        "*": { systemPrompt: "सभी सीधे चैट के लिए डिफ़ॉल्ट प्रॉम्प्ट।" },
      },
      accounts: {
        work: {
          groups: {
            // यह खाता अपना groups मैप परिभाषित करता है, इसलिए रूट groups पूरी तरह
            // बदल जाते हैं। वाइल्डकार्ड बनाए रखने के लिए, यहाँ भी "*" स्पष्ट रूप से परिभाषित करें।
            "120363406415684625@g.us": {
              requireMention: false,
              systemPrompt: "परियोजना प्रबंधन पर ध्यान केंद्रित करें।",
            },
            // केवल तभी उपयोग करें जब इस खाते में सभी समूह स्वीकार किए जाने चाहिए।
            "*": { systemPrompt: "कार्य समूहों के लिए डिफ़ॉल्ट प्रॉम्प्ट।" },
          },
          direct: {
            // यह खाता अपना direct मैप परिभाषित करता है, इसलिए रूट direct प्रविष्टियाँ
            // पूरी तरह बदल जाती हैं। वाइल्डकार्ड बनाए रखने के लिए, यहाँ भी "*" स्पष्ट रूप से परिभाषित करें।
            "+15551234567": { systemPrompt: "किसी विशिष्ट कार्य-संबंधी सीधे चैट के लिए प्रॉम्प्ट।" },
            "*": { systemPrompt: "कार्य-संबंधी सीधे चैट के लिए डिफ़ॉल्ट प्रॉम्प्ट।" },
          },
        },
      },
    },
  },
}

​

कॉन्फ़िगरेशन संदर्भ संकेतक

​

संबंधित

• पेयरिंग
• समूह
• सुरक्षा
• चैनल रूटिंग
• बहु-एजेंट रूटिंग
• समस्या निवारण