WhatsApp

स्थिति: WhatsApp Web (Baileys) के माध्यम से production-ready। Gateway linked session(s) का स्वामी है।

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

• Onboarding (openclaw onboard) और openclaw channels add --channel whatsapp पहली बार इसे चुनने पर WhatsApp Plugin इंस्टॉल करने का prompt देते हैं।
• openclaw channels login --channel whatsapp भी तब install flow प्रदान करता है जब Plugin अभी मौजूद नहीं होता।
• Dev channel + git checkout: local Plugin path पर डिफ़ॉल्ट होता है।
• Stable/Beta: पहले ClawHub से आधिकारिक @openclaw/whatsapp Plugin इंस्टॉल करता है, fallback के रूप में npm के साथ।
• WhatsApp runtime core OpenClaw npm package के बाहर वितरित किया जाता है ताकि WhatsApp-specific runtime dependencies external Plugin के साथ रहें।

Manual install उपलब्ध रहता है:

openclaw plugins install clawhub:@openclaw/whatsapp

bare npm package (@openclaw/whatsapp) का उपयोग केवल तब करें जब आपको registry fallback चाहिए। exact version को केवल तब pin करें जब आपको reproducible install चाहिए।

त्वरित setup

{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-authopenclaw channels login --channel whatsapp --account work

openclaw gateway

openclaw pairing list whatsappopenclaw pairing approve whatsapp <CODE>

वर्तमान requester को MeowCaller से call करें (experimental)

WhatsApp Plugin WhatsApp-originated agent turns में whatsapp_call expose कर सकता है। tool वर्तमान authorized requester को WhatsApp voice call करने के लिए MeowCaller का उपयोग करता है और उनके answer करने के बाद OpenClaw TTS message चलाता है। tool destination number स्वीकार नहीं करता, इसलिए prompt call को third party पर redirect नहीं कर सकता। यह experimental capability default रूप से disabled है।

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

git clone --branch feat/send-only-notify https://github.com/steipete/meowcaller.gitcd meowcallergit checkout 752050471fc2bf7a8cdfbf7dbd3cd4e865d85d3fmkdir -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"

वर्तमान सीमाएं:

• केवल one-to-one outbound audio calls
• arbitrary destination numbers नहीं
• chat connection के साथ shared auth नहीं
• personal-number/self-chat mode से self-calls नहीं
• synthesized audio 60 seconds तक सीमित है
• MeowCaller के answer/playback/hangup completion से आगे handset-side audibility receipt नहीं
• OpenClaw companion process को bounded 115–175 second window के बाद stop करता है, जिसमें MeowCaller की connection, answer, playback, और shutdown phases शामिल हैं

Deployment patterns

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

Runtime model

• Gateway WhatsApp socket और reconnect loop का स्वामी है।
• reconnect watchdog WhatsApp Web transport activity का उपयोग करता है, केवल inbound app-message volume का नहीं, इसलिए quiet linked-device session को केवल इसलिए restart नहीं किया जाता क्योंकि हाल में किसी ने message नहीं भेजा। longer application-silence cap फिर भी reconnect force करता है यदि transport frames आते रहते हैं लेकिन watchdog window के लिए कोई application messages handle नहीं होते; recently active session के transient reconnect के बाद, वह application-silence check first recovery window के लिए normal message timeout का उपयोग करता है।
• Baileys socket timings web.whatsapp.* के अंतर्गत explicit हैं: keepAliveIntervalMs WhatsApp Web application pings control करता है, connectTimeoutMs opening handshake timeout control करता है, और defaultQueryTimeoutMs Baileys query waits plus OpenClaw के local outbound send/presence और inbound read-receipt operation bounds control करता है।
• Outbound sends के लिए target account के लिए active WhatsApp listener आवश्यक है।
• Group sends text और media captions में @+<digits> और @<digits> tokens के लिए native mention metadata attach करते हैं जब token current WhatsApp participant metadata से match करता है, जिसमें LID-backed groups शामिल हैं।
• Status और broadcast chats ignore किए जाते हैं (@status, @broadcast)।
• reconnect watchdog WhatsApp Web transport activity का पालन करता है, केवल inbound app-message volume का नहीं: 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

WhatsApp exec और Plugin approval prompts को 👍 / 👎 reactions के साथ render कर सकता है। Delivery top-level approval forwarding config से controlled है:

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

approvals.exec और approvals.plugin independent हैं। WhatsApp को channel के रूप में enable करना केवल transport link करता है; यह approval prompts नहीं भेजता जब तक matching approval family enabled न हो और WhatsApp को route न करे। Session mode native emoji approvals केवल उन approvals के लिए deliver करता है जो WhatsApp से originate होते हैं। Target mode explicit WhatsApp targets के लिए shared forwarding pipeline का उपयोग करता है और अलग approver-DM fanout create नहीं करता।

WhatsApp approval reactions के लिए allowFrom या "*" से explicit WhatsApp approvers आवश्यक हैं। defaultTo ordinary default message targets control करता है; यह approval approver नहीं है। Manual /approve commands approval resolution से पहले अब भी normal WhatsApp sender authorization path से गुजरते हैं।

Plugin hooks और privacy

WhatsApp इनबाउंड संदेशों में निजी संदेश सामग्री, फोन नंबर, समूह पहचानकर्ता, प्रेषक नाम, और सत्र सहसंबंध फ़ील्ड हो सकते हैं। इस कारण, WhatsApp इनबाउंड message_received hook payloads को plugins पर प्रसारित नहीं करता जब तक आप स्पष्ट रूप से opt in न करें:

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

आप opt-in को एक खाते तक सीमित कर सकते हैं:

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

इसे केवल उन plugins के लिए सक्षम करें जिन पर आप इनबाउंड WhatsApp संदेश सामग्री और पहचानकर्ता प्राप्त करने के लिए भरोसा करते हैं।

एक्सेस नियंत्रण और सक्रियण

कॉन्फ़िगर किए गए ACP bindings

WhatsApp top-level bindings[] entries के साथ persistent 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" },      },    },  ],}

• Direct chats +15555550123 जैसे E.164 numbers से match करती हैं।
• Groups 120363424282127706@g.us जैसे WhatsApp group JIDs से match करते हैं।
• Group allowlists, sender policy, और mention या activation gating OpenClaw द्वारा configured ACP session मौजूद है यह सुनिश्चित करने से पहले चलते हैं।
• Matched configured ACP binding route का owner होता है। WhatsApp broadcast groups उस turn को ordinary WhatsApp sessions तक fan out नहीं करते।

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

जब linked self number allowFrom में भी मौजूद होता है, तो WhatsApp self-chat safeguards activate होते हैं:

• self-chat turns के लिए read receipts skip करें
• mention-JID auto-trigger behavior ignore करें जो अन्यथा आपको स्वयं 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

WhatsApp native reply quoting का समर्थन करता है, जहाँ outbound replies inbound message को visibly quote करते हैं। इसे channels.whatsapp.replyToMode से नियंत्रित करें।

Default "off" है। Per-account overrides channels.whatsapp.accounts.<id>.replyToMode का उपयोग करते हैं।

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

Reaction level

channels.whatsapp.reactionLevel नियंत्रित करता है कि agent WhatsApp पर emoji reactions कितनी व्यापकता से उपयोग करता है:

Default: "minimal"।

Per-account overrides channels.whatsapp.accounts.<id>.reactionLevel का उपयोग करते हैं।

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

Acknowledgment reactions

WhatsApp channels.whatsapp.ackReaction के माध्यम से inbound receipt पर immediate ack reactions का समर्थन करता है। Ack reactions reactionLevel द्वारा gated हैं — जब reactionLevel "off" होता है, तो वे suppress किए जाते हैं।

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

व्यवहार नोट्स:

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

Lifecycle स्थिति प्रतिक्रियाएं

WhatsApp को एक turn के दौरान स्थिर receipt इमोजी छोड़ने के बजाय ack प्रतिक्रिया बदलने देने के लिए messages.statusReactions.enabled: true सेट करें। सक्षम होने पर, OpenClaw queued, thinking, tool activity, compaction, done, और error जैसी lifecycle स्थितियों के लिए उसी inbound message reaction slot का उपयोग करता है।

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

व्यवहार नोट्स:

• channels.whatsapp.ackReaction अभी भी नियंत्रित करता है कि status reactions direct messages और groups के लिए पात्र हैं या नहीं।
• queued status reaction वही प्रभावी ack emoji इस्तेमाल करती है जो plain ack reactions करती हैं।
• WhatsApp में प्रति message एक bot reaction slot होता है, इसलिए lifecycle updates मौजूदा reaction को उसी जगह बदल देते हैं।
• messages.removeAckAfterReply: true configured done/error hold के बाद final status reaction साफ कर देता है।
• Tool emoji categories में tool, coding, web, deploy, build, और concierge शामिल हैं।

Multi-account और credentials

Tools, actions, और config writes

• Agent tool support में WhatsApp reaction action (react) शामिल है।
• Action gates:
  • channels.whatsapp.actions.reactions
  • channels.whatsapp.actions.polls
• Channel-initiated config writes default रूप से enabled हैं (channels.whatsapp.configWrites=false के माध्यम से disable करें)।

Troubleshooting

openclaw channels login --channel whatsappopenclaw channels status

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

openclaw channels status --probeopenclaw doctoropenclaw logs --followopenclaw gateway status

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

System prompts

WhatsApp groups और direct maps के माध्यम से groups और direct chats के लिए Telegram-style system prompts support करता है।

Group messages के लिए resolution hierarchy:

प्रभावी groups map पहले निर्धारित होता है: अगर account अपना groups define करता है, तो वह root groups map को पूरी तरह replace करता है (कोई deep merge नहीं)। Prompt lookup फिर resulting single map पर चलता है:

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

Direct messages के लिए resolution hierarchy:

प्रभावी direct map पहले निर्धारित होता है: अगर account अपना direct define करता है, तो वह root direct map को पूरी तरह replace करता है (कोई deep merge नहीं)। Prompt lookup फिर resulting single map पर चलता है:

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

Telegram multi-account behavior से अंतर: Telegram में, multi-account setup में सभी accounts के लिए root groups को जानबूझकर suppress किया जाता है — यहां तक कि उन accounts के लिए भी जो अपना groups define नहीं करते — ताकि bot उन groups के group messages प्राप्त न करे जिनका वह सदस्य नहीं है। WhatsApp यह guard लागू नहीं करता: root groups और root direct हमेशा उन accounts द्वारा inherited होते हैं जो account-level override define नहीं करते, चाहे कितने भी accounts configured हों। Multi-account WhatsApp setup में, अगर आप per-account group या direct prompts चाहते हैं, तो root-level defaults पर निर्भर रहने के बजाय हर account के तहत full map explicitly define करें।

महत्वपूर्ण व्यवहार:

• channels.whatsapp.groups per-group config map और chat-level group allowlist, दोनों है। root या account scope में, groups["*"] का मतलब उस scope के लिए "all groups are admitted" है।
• 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 को बढ़ाता है जो group handling तक पहुंच सकते हैं, लेकिन यह अपने आप उन groups में हर sender को authorize नहीं करता। Sender access अब भी channels.whatsapp.groupPolicy और channels.whatsapp.groupAllowFrom द्वारा अलग से controlled है।
• channels.whatsapp.direct का DMs के लिए वही side effect नहीं है। direct["*"] केवल तब default direct-chat config प्रदान करता है जब DM पहले ही dmPolicy plus allowFrom या pairing-store rules द्वारा admitted हो चुका हो।

उदाहरण:

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

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

प्राथमिक संदर्भ:

• कॉन्फ़िगरेशन संदर्भ - WhatsApp

उच्च-संकेत WhatsApp फ़ील्ड:

• पहुंच: dmPolicy, allowFrom, groupPolicy, groupAllowFrom, groups
• डिलीवरी: textChunkLimit, chunkMode, mediaMaxMb, sendReadReceipts, ackReaction, reactionLevel
• बहु-खाता: accounts.<id>.enabled, accounts.<id>.authDir, खाता-स्तरीय ओवरराइड
• संचालन: configWrites, debounceMs, web.enabled, web.heartbeatSeconds, web.reconnect.*, web.whatsapp.*
• सत्र व्यवहार: session.dmScope, historyLimit, dmHistoryLimit, dms.<id>.historyLimit
• प्रॉम्प्ट: groups.<id>.systemPrompt, groups["*"].systemPrompt, direct.<id>.systemPrompt, direct["*"].systemPrompt

संबंधित

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