​

WhatsApp (Web-канал)

​

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

• Онбординг (openclaw onboard) і openclaw channels add --channel whatsapp пропонують установити плагін WhatsApp, коли ви вперше вибираєте його.
• openclaw channels login --channel whatsapp також пропонує процес встановлення, якщо плагін ще не присутній.
• Канал розробки + 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"],
    },
  },
}

​

Модель виконання

• Gateway керує сокетом WhatsApp і циклом перепідключення.
• Надсилання назовні вимагає активного слухача WhatsApp для цільового облікового запису.
• Чати статусів і розсилок ігноруються (@status, @broadcast).
• Прямі чати використовують правила сесій DM (session.dmScope; значення за замовчуванням main зводить DM до основної сесії агента).
• Групові сесії ізольовані (agent:<agentId>:whatsapp:group:<jid>).
• Транспорт WhatsApp Web дотримується стандартних змінних середовища проксі на хості gateway (HTTPS_PROXY, HTTP_PROXY, NO_PROXY / варіанти в нижньому регістрі). Надавайте перевагу конфігурації проксі на рівні хоста, а не специфічним налаштуванням проксі WhatsApp для каналу.

​

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

​

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

• пропускати підтвердження прочитання для ходів у чаті із самим собою
• ігнорувати поведінку автозапуску за JID-згадкою, яка інакше пінгувала б вас самих
• якщо messages.responsePrefix не задано, відповіді в чаті із самим собою за замовчуванням мають формат [{identity.name}] або [openclaw]

​

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

[Відповідь на <sender> id:<stanzaId>]
<quoted body or media placeholder>
[/Відповідь]

{
  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

​

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

• Довідник конфігурації - 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

​

Пов’язане

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