​

WhatsApp (Web channel)

​

Встановлення (за потреби)

• Під час onboarding (openclaw onboard) і openclaw channels add --channel whatsapp з’являється запит на встановлення плагіна WhatsApp, коли ви вперше вибираєте цей канал.
• openclaw channels login --channel whatsapp також пропонує процес встановлення, якщо плагін ще не встановлено.
• Dev channel + git checkout: типово використовується локальний шлях до плагіна.
• Stable/Beta: типово використовується npm-пакет @openclaw/whatsapp.

openclaw plugins install @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 gateway

openclaw pairing list whatsapp
openclaw pairing approve whatsapp <CODE>

​

Сценарії розгортання

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

​

Модель runtime

• Gateway керує сокетом WhatsApp і циклом повторного підключення.
• Вихідні надсилання потребують активного listener WhatsApp для цільового облікового запису.
• Чати status і broadcast ігноруються (@status, @broadcast).
• Прямі чати використовують правила DM-сесій (session.dmScope; типове значення main зводить DM до основної сесії агента).
• Групові сесії ізольовані (agent:<agentId>:whatsapp:group:<jid>).

​

Контроль доступу та активація

​

Поведінка особистого номера та чату із самим собою

• пропускати read receipts для ходів self-chat
• ігнорувати поведінку auto-trigger за mention-JID, яка інакше пінгувала б вас самих
• якщо messages.responsePrefix не задано, відповіді self-chat типово використовують [{identity.name}] або [openclaw]

​

Нормалізація повідомлень і контекст

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

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

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

​

Доставка, розбиття на частини та медіа

​

Рівень реакцій

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

​

Реакції-підтвердження

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

• надсилаються одразу після прийняття вхідного повідомлення (до відповіді)
• збої логуються, але не блокують звичайну доставку відповіді
• у груповому режимі mentions реакція ставиться для ходів, активованих згадкою; групова активація always оминає цю перевірку
• WhatsApp використовує channels.whatsapp.ackReaction (застаріле messages.ackReaction тут не використовується)

​

Кілька облікових записів і облікові дані

​

Інструменти, дії та записи конфігурації

• Підтримка інструментів агента включає дію реакції WhatsApp (react).
• Обмеження дій:
  • channels.whatsapp.actions.reactions
  • channels.whatsapp.actions.polls
• Записи конфігурації, ініційовані з каналу, типово ввімкнені (вимкнення через channels.whatsapp.configWrites=false).

​

Усунення проблем

openclaw channels login --channel whatsapp
openclaw channels status

openclaw doctor
openclaw logs --follow

​

Вказівники на довідник конфігурації

• Configuration reference - 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.*
• поведінка сесії: session.dmScope, historyLimit, dmHistoryLimit, dms.<id>.historyLimit

​

Пов’язане

• Підключення
• Групи
• Безпека
• Маршрутизація каналів
• Маршрутизація кількох агентів
• Усунення проблем