WhatsApp

​

इंस्टॉल करें (मांग पर)

• ऑनबोर्डिंग (openclaw onboard) और openclaw channels add --channel whatsapp पहली बार इसे चुनने पर WhatsApp Plugin इंस्टॉल करने का संकेत देते हैं।
• openclaw channels login --channel whatsapp भी Plugin अभी मौजूद न होने पर इंस्टॉल प्रवाह पेश करता है।
• Dev चैनल + git checkout: स्थानीय Plugin पथ पर डिफ़ॉल्ट करता है।
• Stable/Beta: पहले ClawHub से आधिकारिक @openclaw/whatsapp Plugin इंस्टॉल करता है, और fallback के रूप में npm का उपयोग करता है।
• WhatsApp रनटाइम core OpenClaw npm पैकेज के बाहर वितरित किया जाता है ताकि WhatsApp-विशिष्ट रनटाइम निर्भरताएं बाहरी Plugin के साथ रहें।

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>

​

परिनियोजन patterns

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

​

रनटाइम model

• Gateway WhatsApp socket और reconnect loop का स्वामी होता है।
• reconnect watchdog केवल inbound app-message volume नहीं, बल्कि WhatsApp Web transport activity का उपयोग करता है, इसलिए quiet linked-device session को केवल इसलिए restart नहीं किया जाता कि हाल में किसी ने message नहीं भेजा है। लंबा application-silence cap फिर भी reconnect force करता है यदि transport frames आते रहें लेकिन watchdog window के लिए कोई application messages handle न हों; हाल में active session के transient reconnect के बाद, वह application-silence check पहले recovery window के लिए normal message timeout का उपयोग करता है।
• Baileys socket timings web.whatsapp.* के अंतर्गत explicit हैं: keepAliveIntervalMs WhatsApp Web application pings नियंत्रित करता है, connectTimeoutMs opening handshake timeout नियंत्रित करता है, और defaultQueryTimeoutMs Baileys query waits के साथ OpenClaw के local outbound send/presence और inbound read-receipt operation bounds नियंत्रित करता है।
• Outbound sends को target account के लिए active WhatsApp listener चाहिए।
• Group sends text और media captions में @+<digits> और @<digits> tokens के लिए native mention metadata attach करते हैं जब token वर्तमान WhatsApp participant metadata से match करता है, जिसमें LID-backed groups शामिल हैं।
• Status और broadcast chats ignore किए जाते हैं (@status, @broadcast)।
• reconnect watchdog केवल inbound app-message volume नहीं, बल्कि WhatsApp Web transport activity का पालन करता है: quiet linked-device sessions transport frames जारी रहने तक up रहते हैं, लेकिन transport stall बाद के remote disconnect path से काफी पहले reconnect force करता है।
• Direct chats DM session rules का उपयोग करते हैं (session.dmScope; default main DMs को agent main session में collapse करता है)।
• Group sessions isolated हैं (agent:<agentId>:whatsapp:group:<jid>)।
• WhatsApp Channels/Newsletters अपने native @newsletter JID के साथ explicit outbound targets हो सकते हैं। Outbound newsletter sends DM session semantics के बजाय channel session metadata (agent:<agentId>:whatsapp:channel:<jid>) का उपयोग करते हैं।
• WhatsApp Web transport gateway host पर standard proxy environment variables (HTTPS_PROXY, HTTP_PROXY, NO_PROXY / lowercase variants) का सम्मान करता है। channel-specific WhatsApp proxy settings की तुलना में host-level proxy config को प्राथमिकता दें।
• जब messages.removeAckAfterReply enabled होता है, OpenClaw visible reply deliver होने के बाद WhatsApp ack reaction clear कर देता है।

​

Approval prompts

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

​

Plugin hooks और गोपनीयता

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

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

​

Access control और activation

​

Configured ACP bindings

{
  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" },
      },
    },
  ],
}

• सीधे चैट +15555550123 जैसे E.164 नंबरों से मेल खाते हैं।
• समूह 120363424282127706@g.us जैसे WhatsApp समूह JID से मेल खाते हैं।
• OpenClaw द्वारा कॉन्फ़िगर किया गया ACP सत्र मौजूद है यह सुनिश्चित करने से पहले समूह allowlist, प्रेषक नीति, और mention या activation gating चलते हैं।
• मेल खाई हुई कॉन्फ़िगर की गई ACP binding route की स्वामी होती है। WhatsApp broadcast समूह उस turn को सामान्य WhatsApp sessions में fan out नहीं करते।

​

निजी-नंबर और self-chat व्यवहार

• self-chat turns के लिए read receipts छोड़ें
• mention-JID auto-trigger व्यवहार को अनदेखा करें, जो अन्यथा आपको ही ping करता
• यदि messages.responsePrefix unset है, तो self-chat replies डिफ़ॉल्ट रूप से [{identity.name}] या [openclaw] होते हैं

​

संदेश normalization और context

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

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

{
  channels: {
    whatsapp: {
      accounts: {
        work: {
          sendReadReceipts: false,
        },
      },
    },
  },
}

​

Delivery, chunking, और media

​

Reply quoting

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

​

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

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

​

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

{
  channels: {
    whatsapp: {
      ackReaction: {
        emoji: "👀",
        direct: true,
        group: "mentions", // always | mentions | never
      },
    },
  },
}

• इनबाउंड स्वीकार होने के तुरंत बाद भेजा जाता है (उत्तर से पहले)
• यदि ackReaction बिना emoji के मौजूद है, तो WhatsApp रूट किए गए एजेंट की पहचान emoji का उपयोग करता है, और उपलब्ध न होने पर ”👀” पर लौटता है; कोई स्वीकृति प्रतिक्रिया न भेजने के लिए ackReaction छोड़ दें या emoji: "" सेट करें
• विफलताएँ लॉग की जाती हैं, लेकिन सामान्य उत्तर डिलीवरी को ब्लॉक नहीं करतीं
• समूह मोड mentions, उल्लेख से ट्रिगर हुए टर्न पर प्रतिक्रिया देता है; समूह सक्रियण always इस जाँच के लिए bypass की तरह काम करता है
• WhatsApp channels.whatsapp.ackReaction का उपयोग करता है (legacy messages.ackReaction यहाँ उपयोग नहीं होता)

​

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

{
  messages: {
    statusReactions: {
      enabled: true,
      emojis: {
        deploy: "🛫",
        build: "🏗️",
        concierge: "💁",
      },
    },
  },
}

• channels.whatsapp.ackReaction अब भी नियंत्रित करता है कि स्थिति प्रतिक्रियाएँ सीधे संदेशों और समूहों के लिए पात्र हैं या नहीं।
• कतारबद्ध स्थिति प्रतिक्रिया, सादी स्वीकृति प्रतिक्रियाओं वाले उसी प्रभावी स्वीकृति emoji का उपयोग करती है।
• WhatsApp में प्रति संदेश एक bot प्रतिक्रिया स्लॉट होता है, इसलिए जीवनचक्र अपडेट वर्तमान प्रतिक्रिया को उसी स्थान पर बदल देते हैं।
• messages.removeAckAfterReply: true कॉन्फ़िगर किए गए पूर्ण/त्रुटि होल्ड के बाद अंतिम स्थिति प्रतिक्रिया साफ़ करता है।
• टूल emoji श्रेणियों में tool, coding, web, deploy, build, और concierge शामिल हैं।

​

बहु-खाता और क्रेडेंशियल

​

टूल, कार्रवाइयाँ, और config writes

• एजेंट टूल समर्थन में WhatsApp reaction action (react) शामिल है।
• Action gates:
  • channels.whatsapp.actions.reactions
  • channels.whatsapp.actions.polls
• Channel-initiated config writes डिफ़ॉल्ट रूप से सक्षम हैं (channels.whatsapp.configWrites=false के माध्यम से अक्षम करें)।

​

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

openclaw channels login --channel whatsapp
openclaw channels status

{
  web: {
    whatsapp: {
      keepAliveIntervalMs: 15000,
      connectTimeoutMs: 60000,
      defaultQueryTimeoutMs: 60000,
    },
  },
}

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>

​

System prompts

1. Group-specific system prompt (groups["<groupId>"].systemPrompt): तब उपयोग किया जाता है जब specific group entry map में मौजूद हो और उसकी systemPrompt key परिभाषित हो। यदि systemPrompt empty string ("") है, तो wildcard दबा दिया जाता है और कोई system prompt apply नहीं होता।
2. Group wildcard system prompt (groups["*"].systemPrompt): तब उपयोग किया जाता है जब specific group entry map से पूरी तरह absent हो, या वह मौजूद हो लेकिन कोई systemPrompt key define न करती हो।

1. Direct-specific system prompt (direct["<peerId>"].systemPrompt): तब उपयोग किया जाता है जब specific peer entry map में मौजूद हो और उसकी systemPrompt key परिभाषित हो। यदि systemPrompt empty string ("") है, तो wildcard दबा दिया जाता है और कोई system prompt apply नहीं होता।
2. Direct wildcard system prompt (direct["*"].systemPrompt): तब उपयोग किया जाता है जब specific peer entry map से पूरी तरह absent हो, या वह मौजूद हो लेकिन कोई systemPrompt key define न करती हो।

• channels.whatsapp.groups per-group config map और chat-level group allowlist दोनों है। root या account scope में, groups["*"] का मतलब उस scope के लिए “सभी groups admit किए जाते हैं” है।
• wildcard group systemPrompt केवल तब जोड़ें जब आप पहले से चाहते हों कि वह scope सभी groups को admit करे। यदि आप अब भी केवल group IDs के fixed set को eligible रखना चाहते हैं, तो prompt default के लिए groups["*"] का उपयोग न करें। इसके बजाय, हर explicitly allowlisted group entry पर prompt दोहराएं।
• Group admission और sender authorization अलग-अलग checks हैं। groups["*"] उन groups के set को widen करता है जो group handling तक पहुंच सकते हैं, लेकिन यह अपने आप उन groups में हर sender को authorize नहीं करता। Sender access अब भी channels.whatsapp.groupPolicy और channels.whatsapp.groupAllowFrom द्वारा अलग से नियंत्रित होता है।
• channels.whatsapp.direct का DMs के लिए वही side effect नहीं है। direct["*"] केवल तब default direct-chat config प्रदान करता है जब कोई DM पहले से dmPolicy plus allowFrom या pairing-store rules द्वारा admit हो चुका हो।

{
  channels: {
    whatsapp: {
      groups: {
        // Use only if all groups should be admitted at the root scope.
        // Applies to all accounts that do not define their own groups map.
        "*": { systemPrompt: "Default prompt for all groups." },
      },
      direct: {
        // Applies to all accounts that do not define their own direct map.
        "*": { systemPrompt: "Default prompt for all direct chats." },
      },
      accounts: {
        work: {
          groups: {
            // This account defines its own groups, so root groups are fully
            // replaced. To keep a wildcard, define "*" explicitly here too.
            "120363406415684625@g.us": {
              requireMention: false,
              systemPrompt: "Focus on project management.",
            },
            // Use only if all groups should be admitted in this account.
            "*": { systemPrompt: "Default prompt for work groups." },
          },
          direct: {
            // This account defines its own direct map, so root direct entries are
            // fully replaced. To keep a wildcard, define "*" explicitly here too.
            "+15551234567": { systemPrompt: "Prompt for a specific work direct chat." },
            "*": { systemPrompt: "Default prompt for work direct chats." },
          },
        },
      },
    },
  },
}

​

Configuration reference pointers

• Configuration reference - WhatsApp

• access: dmPolicy, allowFrom, groupPolicy, groupAllowFrom, groups
• delivery: textChunkLimit, chunkMode, mediaMaxMb, sendReadReceipts, ackReaction, reactionLevel
• multi-account: accounts.<id>.enabled, accounts.<id>.authDir, account-level overrides
• operations: configWrites, debounceMs, web.enabled, web.heartbeatSeconds, web.reconnect.*, web.whatsapp.*
• session behavior: session.dmScope, historyLimit, dmHistoryLimit, dms.<id>.historyLimit
• prompts: groups.<id>.systemPrompt, groups["*"].systemPrompt, direct.<id>.systemPrompt, direct["*"].systemPrompt

​

Related

• Pairing
• Groups
• Security
• Channel routing
• Multi-agent routing
• Troubleshooting