WhatsApp

​

Installeren

openclaw plugins install clawhub:@openclaw/whatsapp

​

Snelle configuratie

{
  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>

​

Implementatiepatronen

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

​

Runtimemodel

• De gateway beheert de WhatsApp-socket en de herverbindingslus.
• Een watchdog volgt twee signalen onafhankelijk: ruwe WhatsApp Web-transportactiviteit en activiteit van applicatieberichten. Een stille maar verbonden sessie wordt niet opnieuw gestart alleen omdat er onlangs geen bericht is binnengekomen; een herverbinding wordt alleen afgedwongen wanneer er gedurende een vast intern venster (niet door de gebruiker configureerbaar) geen transportframes meer binnenkomen of applicatieberichten langer dan 4x de normale berichttime-out uitblijven. Direct na een herverbinding voor een onlangs actieve sessie gebruikt dat eerste venster de kortere normale berichttime-out in plaats van het 4x-venster. OpenClaw kan automatisch antwoorden op offlineberichten die Baileys vroeg tijdens die herverbinding aflevert, begrensd door de levensduur van de deduplicatie van inkomende bericht-ID’s; bij de eerste opstart blijft de korte beveiliging tegen verouderde geschiedenis actief.
• Voor uitgaande verzendingen is een actieve WhatsApp-listener voor het doelaccount vereist; anders mislukken verzendingen direct.
• Groepsverzendingen voegen systeemeigen vermeldingsmetagegevens toe voor @+<digits>- en @<digits>-tokens (in tekst en mediabijschriften) wanneer het token overeenkomt met de huidige metagegevens van deelnemers, ook voor groepen op basis van LID.
• Status- en broadcastchats (@status, @broadcast) worden genegeerd.
• Directe chats gebruiken DM-sessieregels (session.dmScope; de standaardwaarde main voegt DM’s samen in de hoofdsessie van de agent). Groepssessies worden per JID geïsoleerd (agent:<agentId>:whatsapp:group:<jid>).
• WhatsApp Channels/Newsletters kunnen expliciete uitgaande doelen zijn via hun systeemeigen @newsletter-JID, waarbij kanaalsessiemetagegevens (agent:<agentId>:whatsapp:channel:<jid>) worden gebruikt in plaats van DM-semantiek.
• Het WhatsApp Web-transport respecteert standaard proxy-omgevingsvariabelen op de gatewayhost (HTTPS_PROXY, HTTP_PROXY, NO_PROXY, varianten in kleine letters). Geef de voorkeur aan proxyconfiguratie op hostniveau boven instellingen per kanaal.

​

De huidige aanvrager bellen met MeowCaller (experimenteel)

{
  "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"

​

Goedkeuringsprompts

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

​

Reacties op vragen

​

Plugin-hooks en privacy

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

​

Toegangsbeheer en activering

​

Geconfigureerde ACP-bindingen

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

​

Gedrag voor persoonlijke nummers en chats met jezelf

​

Berichtnormalisatie en context

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

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

​

Bezorging, opdelen en media

​

Antwoorden citeren

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

​

Reactieniveau

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

​

Bevestigingsreacties

{
  channels: {
    whatsapp: {
      ackReaction: {
        emoji: "👀",
        direct: true,
        group: "mentions", // altijd | vermeldingen | nooit
      },
    },
  },
}

​

Levenscyclusstatusreacties

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

​

Meerdere accounts en aanmeldgegevens

​

Tools, acties en configuratieschrijfbewerkingen

• Ondersteuning voor agenttools omvat de WhatsApp-reactieactie (react).
• Actiepoorten: channels.whatsapp.actions.reactions, channels.whatsapp.actions.polls (bestaande acties hebben standaard true), channels.whatsapp.actions.calls (standaard false, zie MeowCaller hierboven).
• Door het kanaal geïnitieerde configuratieschrijfbewerkingen zijn standaard ingeschakeld; schakel ze uit via channels.whatsapp.configWrites: false.

​

Probleemoplossing

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>

​

Systeemprompts

1. Groepsspecifieke prompt (groups["<groupId>"].systemPrompt): wordt gebruikt wanneer de groepsvermelding bestaat en de sleutel systemPrompt ervan is gedefinieerd. Een lege tekenreeks ("") onderdrukt het jokerteken en past geen prompt toe.
2. Prompt met groepsjokerteken (groups["*"].systemPrompt): wordt gebruikt wanneer de specifieke groepsvermelding ontbreekt of bestaat zonder een sleutel systemPrompt.

• channels.whatsapp.groups is zowel een configuratiemap per groep als de toelatingslijst voor groepen op chatniveau. Op hoofd- of accountniveau betekent groups["*"] voor dat bereik “alle groepen worden toegelaten”.
• Voeg alleen een jokerteken systemPrompt toe als je al wilt dat dat bereik alle groepen toelaat. Om alleen een vaste set groeps-id’s in aanmerking te laten komen, herhaal je de prompt bij elke expliciet toegelaten vermelding in plaats van groups["*"] te gebruiken.
• Groepstoelating en afzenderautorisatie zijn afzonderlijke controles. groups["*"] breidt uit welke groepen door de groepsafhandeling worden verwerkt; het autoriseert niet elke afzender in die groepen — dat blijft geregeld door groupPolicy/groupAllowFrom.
• channels.whatsapp.direct heeft geen gelijkwaardig neveneffect voor privéberichten: direct["*"] levert alleen een standaardconfiguratie nadat een privébericht al is toegelaten door dmPolicy plus allowFrom of regels voor de koppelingsopslag.

{
  channels: {
    whatsapp: {
      groups: {
        // Alleen gebruiken als alle groepen op hoofdniveau moeten worden toegelaten.
        // Geldt voor alle accounts die geen eigen groups-map definiëren.
        "*": { systemPrompt: "Standaardprompt voor alle groepen." },
      },
      direct: {
        // Geldt voor alle accounts die geen eigen direct-map definiëren.
        "*": { systemPrompt: "Standaardprompt voor alle directe chats." },
      },
      accounts: {
        work: {
          groups: {
            // Dit account definieert zijn eigen groups, waardoor groups op hoofdniveau
            // volledig worden vervangen. Definieer "*" hier ook expliciet om een jokerteken te behouden.
            "120363406415684625@g.us": {
              requireMention: false,
              systemPrompt: "Richt je op projectmanagement.",
            },
            // Alleen gebruiken als alle groepen in dit account moeten worden toegelaten.
            "*": { systemPrompt: "Standaardprompt voor werkgroepen." },
          },
          direct: {
            // Dit account definieert zijn eigen direct-map, waardoor direct-vermeldingen op hoofdniveau
            // volledig worden vervangen. Definieer "*" hier ook expliciet om een jokerteken te behouden.
            "+15551234567": { systemPrompt: "Prompt voor een specifieke directe werkchat." },
            "*": { systemPrompt: "Standaardprompt voor directe werkchats." },
          },
        },
      },
    },
  },
}

​

Verwijzingen naar het configuratieoverzicht

​

Gerelateerd

• Koppelen
• Groepen
• Beveiliging
• Kanaalroutering
• Routering met meerdere agents
• Probleemoplossing