​

WhatsApp (web channel)

​

Tezkor sozlash

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

openclaw channels login --channel whatsapp

Muayyan akkaunt uchun:

4. {
  channels: { whatsapp: { configWrites: false } },
}

openclaw gateway

openclaw pairing list whatsapp
openclaw pairing approve whatsapp <CODE>

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

​

Joylashtirish andozalari

- OpenClaw uchun alohida WhatsApp identifikatori
- DM allowlistlari va marshrutlash chegaralari aniqroq
- o‘zingiz bilan chatda chalkashlik ehtimoli pastroq

Minimal siyosat namunasi:

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

- `dmPolicy: "allowlist"`
- `allowFrom` ichiga shaxsiy raqamingiz kiritiladi
- `selfChatMode: true`

Ish jarayonida self-chat himoyasi bog‘langan self raqam va `allowFrom` asosida ishlaydi.

O‘rnatilgan chat-kanal reyestrida alohida Twilio WhatsApp xabar almashish kanali mavjud emas.

​

Inbound flow (DM + group)

• WhatsApp events come from messages.upsert (Baileys).
• Inbox listeners are detached on shutdown to avoid accumulating event handlers in tests/restarts.
• Status/broadcast chats are ignored.
• Direct chats use E.164; groups use group JID.
• DM policy: channels.whatsapp.dmPolicy controls direct chat access (default: pairing).

​

Personal-number mode (fallback)

- `pairing` (standart)
- `allowlist`
- `open` (`allowFrom` ichida `"*"` bo‘lishi kerak)
- `disabled`

`allowFrom` E.164 formatidagi raqamlarni qabul qiladi (ichki tarzda normallashtiriladi).

Ko‘p akkauntli override: `channels.whatsapp.accounts.<id>.dmPolicy` (va `allowFrom`) shu akkaunt uchun kanal darajasidagi standart sozlamalardan ustun turadi.

Runtime xulq-atvor tafsilotlari:

- pairinglar kanal allow-store’da saqlanadi va sozlangan `allowFrom` bilan birlashtiriladi
- agar allowlist sozlanmagan bo‘lsa, bog‘langan self raqam standart tarzda ruxsat etiladi
- chiquvchi `fromMe` DM’lar hech qachon avtomatik pairing qilinmaydi

1. **Guruh a’zoligi allowlisti** (`channels.whatsapp.groups`)
   - agar `groups` ko‘rsatilmagan bo‘lsa, barcha guruhlar mos hisoblanadi
   - agar `groups` mavjud bo‘lsa, u guruh allowlisti sifatida ishlaydi (`"*"` ruxsat etiladi)

2. **Guruh yuboruvchi siyosati** (`channels.whatsapp.groupPolicy` + `groupAllowFrom`)
   - `open`: yuboruvchi allowlisti chetlab o‘tiladi
   - `allowlist`: yuboruvchi `groupAllowFrom` (yoki `*`) bilan mos kelishi kerak
   - `disabled`: guruhdan keluvchi barcha kiruvchi xabarlarni bloklaydi

Yuboruvchi allowlisti fallback:

- agar `groupAllowFrom` o‘rnatilmagan bo‘lsa, mavjud bo‘lganda runtime `allowFrom` ga qaytadi

Eslatma: agar umuman `channels.whatsapp` bloki mavjud bo‘lmasa, runtime’dagi guruh siyosati fallback amalda `open` bo‘ladi.

Mention aniqlash quyidagilarni o‘z ichiga oladi:

- bot identifikatorining aniq WhatsApp mentionlari
- sozlangan mention regex andozalari (`agents.list[].groupChat.mentionPatterns`, fallback `messages.groupChat.mentionPatterns`)
- botga javob berishni implicit aniqlash (reply yuboruvchisi bot identifikatoriga mos keladi)

Sessiya darajasidagi faollashtirish buyrug‘i:

- `/activation mention`
- `/activation always`

`activation` sessiya holatini yangilaydi (global konfiguratsiyani emas). Bu owner tomonidan cheklangan.

​

Shaxsiy raqam va self-chat xulq-atvori

• self-chat xabarlari uchun o‘qilganlik kvitansiyalarini o‘tkazib yuborish
• aks holda o‘zingizni ping qilishi mumkin bo‘lgan mention-JID avtomatik trigger xulq-atvorini e’tiborsiz qoldirish
• agar messages.responsePrefix o‘rnatilmagan bo‘lsa, self-chat javoblari standart tarzda [{identity.name}] yoki [openclaw] bilan boshlanadi

​

Xabarni normallashtirish va kontekst

Agar iqtibosli javob mavjud bo‘lsa, kontekst quyidagi shaklda qo‘shiladi:

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

Mavjud bo‘lganda javob metama’lumot maydonlari ham to‘ldiriladi (`ReplyToId`, `ReplyToBody`, `ReplyToSender`, sender JID/E.164).

- `<media:image>`
- `<media:video>`
- `<media:audio>`
- `<media:document>`
- `<media:sticker>`

Joylashuv va kontakt payload’lari marshrutlashdan oldin matnli kontekstga normallashtiriladi.

- standart limit: `50`
- sozlama: `channels.whatsapp.historyLimit`
- fallback: `messages.groupChat.historyLimit`
- `0` o‘chiradi

Qo‘shish (injection) markerlari:

- `[Chat messages since your last reply - for context]`
- `[Current message - respond to this]`

Global darajada o‘chirish:

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

Har bir akkaunt uchun alohida sozlash:

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

Self-chat burilishlarida (turns) global yoqilgan bo‘lsa ham read receipt yuborilmaydi.

​

Yetkazib berish, bo‘laklash (chunking) va media

​

Tasdiqlovchi reaksiyalar

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

• kiruvchi xabar qabul qilingach darhol (javobdan oldin) yuboriladi
• xatoliklar log qilinadi, ammo odatiy javob yetkazilishini to‘xtatmaydi
• mentions guruh rejimi mention-trigger qilingan burilishlarda reaksiya bildiradi; guruh aktivatsiyasi always bo‘lsa, bu tekshiruvni chetlab o‘tadi
• WhatsApp channels.whatsapp.ackReaction dan foydalanadi (legacy messages.ackReaction bu yerda ishlatilmaydi)

​

Multi-account va credentials

Legacy auth kataloglarida `oauth.json` saqlab qolinadi, Baileys auth fayllari esa o‘chiriladi.

​

Vositalar, amallar va config yozuvlari

• Agent vositalari WhatsApp reaksiya amalini (react) qo‘llab-quvvatlaydi.
• [[audio_as_voice]] WhatsApp uchun e’tiborga olinmaydi (audio allaqachon ovozli xabar sifatida yuboriladi).
  • channels.whatsapp.actions.reactions
  • channels.whatsapp.actions.polls
• Channel tomonidan boshlangan config yozuvlari sukut bo‘yicha yoqilgan (channels.whatsapp.configWrites=false orqali o‘chiriladi).

​

Media limitlari + optimallashtirish

Yechim:

```bash
openclaw channels login --channel whatsapp
openclaw channels status
```

Yechim:

```bash
openclaw doctor
openclaw logs --follow
```

Zarur bo‘lsa, `channels login` orqali qayta ulang.

Gateway ishlayotganiga va akkaunt ulanganiga ishonch hosil qiling.

- `groupPolicy`
- `groupAllowFrom` / `allowFrom`
- `groups` allowlist yozuvlari
- mention gating (`requireMention` + mention andozalari)

​

Konfiguratsiya ma’lumotnomasi havolalari

• Configuration reference - WhatsApp

• access: dmPolicy, allowFrom, groupPolicy, groupAllowFrom, groups
• delivery: textChunkLimit, chunkMode, mediaMaxMb, sendReadReceipts, ackReaction
• multi-account: accounts.<id>.enabled, accounts.<id>.authDir, account-level overrides
• operations: configWrites, debounceMs, web.enabled, web.heartbeatSeconds, web.reconnect.*
• session xatti-harakati: session.dmScope, historyLimit, dmHistoryLimit, dms.<id>.historyLimit

​

Bog‘liq

• Pairing
• Channel routing
• Troubleshooting