​

WhatsApp (Web kanalı)

​

Kurulum (gerektiğinde)

• Onboarding (openclaw onboard) ve openclaw channels add --channel whatsapp, ilk kez seçtiğinizde WhatsApp eklentisini yüklemeyi önerir.
• openclaw channels login --channel whatsapp de, eklenti henüz mevcut değilse kurulum akışını sunar.
• Geliştirme kanalı + git checkout: varsayılan olarak yerel eklenti yolunu kullanır.
• Stable/Beta: varsayılan olarak npm paketi @openclaw/whatsapp kullanılır.

openclaw plugins install @openclaw/whatsapp

​

Hızlı kurulum

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

​

Dağıtım kalıpları

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

​

Çalışma zamanı modeli

• Gateway, WhatsApp soketinin ve yeniden bağlanma döngüsünün sahibidir.
• Giden gönderimler, hedef hesap için etkin bir WhatsApp dinleyicisi gerektirir.
• Durum ve yayın sohbetleri yok sayılır (@status, @broadcast).
• Doğrudan sohbetler DM oturum kurallarını kullanır (session.dmScope; varsayılan main, DM’leri ajanın ana oturumunda birleştirir).
• Grup oturumları yalıtılmıştır (agent:<agentId>:whatsapp:group:<jid>).
• WhatsApp Web taşıması, gateway ana makinesinde standart proxy ortam değişkenlerine uyar (HTTPS_PROXY, HTTP_PROXY, NO_PROXY / küçük harfli varyantlar). Kanala özel WhatsApp proxy ayarları yerine ana makine düzeyinde proxy yapılandırmasını tercih edin.

​

Erişim denetimi ve etkinleştirme

​

Kişisel numara ve kendi kendine sohbet davranışı

• kendi kendine sohbet dönüşlerinde okundu bilgilerini atla
• aksi halde kendinize ping atacak olan mention-JID otomatik tetikleme davranışını yok say
• messages.responsePrefix ayarlanmamışsa, kendi kendine sohbet yanıtları varsayılan olarak [{identity.name}] veya [openclaw] olur

​

Mesaj normalizasyonu ve bağlam

[<sender> kullanıcısına yanıt veriliyor id:<stanzaId>]
<alıntılanan gövde veya medya yer tutucusu>
[/Yanıt veriliyor]

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

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

​

Teslimat, parçalara ayırma ve medya

​

Tepki düzeyi

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

​

Alındı tepkileri

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

• gelen kabul edildikten hemen sonra gönderilir (yanıt öncesi)
• hatalar günlüğe kaydedilir ancak normal yanıt teslimatını engellemez
• grup modu mentions, bahsetmeyle tetiklenen dönüşlerde tepki verir; grup etkinleştirme always bu denetim için baypas görevi görür
• WhatsApp channels.whatsapp.ackReaction kullanır (eski messages.ackReaction burada kullanılmaz)

​

Çoklu hesap ve kimlik bilgileri

​

Araçlar, eylemler ve yapılandırma yazımları

• Ajan araç desteği WhatsApp tepki eylemini (react) içerir.
• Eylem geçitleri:
  • channels.whatsapp.actions.reactions
  • channels.whatsapp.actions.polls
• Kanal tarafından başlatılan yapılandırma yazımları varsayılan olarak etkindir (channels.whatsapp.configWrites=false ile devre dışı bırakın).

​

Sorun giderme

openclaw channels login --channel whatsapp
openclaw channels status

openclaw doctor
openclaw logs --follow

​

Yapılandırma başvuru işaretçileri

• Yapılandırma başvurusu - WhatsApp

• erişim: dmPolicy, allowFrom, groupPolicy, groupAllowFrom, groups
• teslimat: textChunkLimit, chunkMode, mediaMaxMb, sendReadReceipts, ackReaction, reactionLevel
• çoklu hesap: accounts.<id>.enabled, accounts.<id>.authDir, hesap düzeyi geçersiz kılmalar
• operasyonlar: configWrites, debounceMs, web.enabled, web.heartbeatSeconds, web.reconnect.*
• oturum davranışı: session.dmScope, historyLimit, dmHistoryLimit, dms.<id>.historyLimit

​

İlgili

• Eşleştirme
• Gruplar
• Güvenlik
• Kanal yönlendirme
• Çok ajanlı yönlendirme
• Sorun giderme