WhatsApp

​

Kurulum

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

​

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.
• Bir gözetleyici iki sinyali bağımsız olarak izler: ham WhatsApp Web aktarım etkinliği ve uygulama mesajı etkinliği. Sessiz ancak bağlı bir oturum, yalnızca yakın zamanda mesaj gelmediği için yeniden başlatılmaz; yalnızca aktarım çerçeveleri sabit bir dahili süre boyunca (kullanıcı tarafından yapılandırılamaz) gelmeyi durdurduğunda veya uygulama mesajları normal mesaj zaman aşımının 4 katını aşacak kadar sessiz kaldığında yeniden bağlanmayı zorlar. Yakın zamanda etkin olan bir oturum yeniden bağlandıktan hemen sonra bu ilk süre, 4 katlık süre yerine daha kısa olan normal mesaj zaman aşımını kullanır. OpenClaw, Baileys’in bu yeniden bağlanmanın erken aşamasında ilettiği çevrimdışı mesajlara, gelen mesaj kimliği yinelenenleri ayıklama ömrüyle sınırlı olarak otomatik yanıt verebilir; ilk başlatma kısa eski geçmiş korumasını sürdürür.
• Giden gönderimler, hedef hesap için etkin bir WhatsApp dinleyicisi gerektirir; aksi takdirde gönderimler hızla başarısız olur.
• Grup gönderimleri, belirteç mevcut katılımcı meta verileriyle eşleştiğinde @+<digits> ve @<digits> belirteçleri için (metin ve medya açıklamalarında) LID destekli gruplar dahil olmak üzere yerel bahsetme meta verilerini ekler.
• Durum ve yayın sohbetleri (@status, @broadcast) yok sayılır.
• Doğrudan sohbetler DM oturum kurallarını kullanır (session.dmScope; varsayılan main, DM’leri aracının ana oturumunda birleştirir). Grup oturumları her JID için yalıtılır (agent:<agentId>:whatsapp:group:<jid>).
• WhatsApp Kanalları/Bültenleri, DM semantiği yerine kanal oturumu meta verilerini (agent:<agentId>:whatsapp:channel:<jid>) kullanarak yerel @newsletter JID’leri aracılığıyla açık giden hedefler olabilir.
• WhatsApp Web aktarımı, Gateway ana makinesindeki standart proxy ortam değişkenlerine (HTTPS_PROXY, HTTP_PROXY, NO_PROXY, küçük harfli çeşitleri) uyar. Kanal başına ayarlar yerine ana makine düzeyinde proxy yapılandırmasını tercih edin.

​

Mevcut istekte bulunanı MeowCaller ile arayın (deneysel)

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

​

Onay istemleri

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

​

Soru tepkileri

​

Plugin kancaları ve gizlilik

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

​

Erişim denetimi ve etkinleştirme

​

Yapılandırılmış ACP bağlamaları

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

​

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

​

Mesaj normalleştirme ve bağlam

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

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

​

Teslimat, parçalara ayırma ve medya

​

Yanıt alıntılama

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

​

Tepki düzeyi

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

​

Alındı onayı tepkileri

{
  channels: {
    whatsapp: {
      ackReaction: {
        emoji: "👀",
        direct: true,
        group: "mentions", // her zaman | bahsetmeler | hiçbir zaman
      },
    },
  },
}

​

Yaşam döngüsü durumu tepkileri

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

​

Çoklu hesap ve kimlik bilgileri

​

Araçlar, eylemler ve yapılandırma yazma işlemleri

• Agent araç desteği, WhatsApp tepki eylemini (react) içerir.
• Eylem geçitleri: channels.whatsapp.actions.reactions, channels.whatsapp.actions.polls (mevcut eylemlerin varsayılanı true), channels.whatsapp.actions.calls (varsayılan false, yukarıdaki MeowCaller bölümüne bakın).
• Kanal tarafından başlatılan yapılandırma yazma işlemleri varsayılan olarak etkindir; channels.whatsapp.configWrites: false aracılığıyla devre dışı bırakın.

​

Sorun giderme

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>

​

Sistem istemleri

1. Gruba özgü istem (groups["<groupId>"].systemPrompt): grup girdisi mevcut ve systemPrompt anahtarı tanımlı olduğunda kullanılır. Boş bir dize ("") joker karakteri bastırır ve hiçbir istem uygulamaz.
2. Grup joker karakteri istemi (groups["*"].systemPrompt): belirli grup girdisi mevcut olmadığında veya systemPrompt anahtarı olmadan mevcut olduğunda kullanılır.

• channels.whatsapp.groups hem grup başına yapılandırma eşlemesi hem de sohbet düzeyindeki grup izin listesidir. Kök veya hesap kapsamında groups["*"], söz konusu kapsam için “tüm gruplar kabul edilir” anlamına gelir.
• Yalnızca söz konusu kapsamın tüm grupları kabul etmesini zaten istiyorsanız bir systemPrompt joker karakteri ekleyin. Yalnızca sabit bir grup kimliği kümesini uygun tutmak için groups["*"] kullanmak yerine istemi açıkça izin verilen her girdide tekrarlayın.
• Grup kabulü ve gönderen yetkilendirmesi ayrı denetimlerdir. groups["*"], hangi grupların grup işlemeye ulaşacağını genişletir; bu gruplardaki her gönderene yetki vermez — bu işlem groupPolicy/groupAllowFrom tarafından denetlenmeye devam eder.
• channels.whatsapp.direct, DM’ler için eşdeğer bir yan etkiye sahip değildir: direct["*"], yalnızca bir DM dmPolicy ile birlikte allowFrom veya eşleştirme deposu kuralları tarafından zaten kabul edildikten sonra varsayılan bir yapılandırma sağlar.

{
  channels: {
    whatsapp: {
      groups: {
        // Yalnızca tüm grupların kök kapsamında kabul edilmesi gerekiyorsa kullanın.
        // Kendi groups eşlemesini tanımlamayan tüm hesaplara uygulanır.
        "*": { systemPrompt: "Tüm gruplar için varsayılan istem." },
      },
      direct: {
        // Kendi direct eşlemesini tanımlamayan tüm hesaplara uygulanır.
        "*": { systemPrompt: "Tüm doğrudan sohbetler için varsayılan istem." },
      },
      accounts: {
        work: {
          groups: {
            // Bu hesap kendi groups eşlemesini tanımlar, dolayısıyla kök groups eşlemesi tamamen
            // değiştirilir. Joker karakteri korumak için "*" değerini burada da açıkça tanımlayın.
            "120363406415684625@g.us": {
              requireMention: false,
              systemPrompt: "Proje yönetimine odaklan.",
            },
            // Yalnızca bu hesapta tüm grupların kabul edilmesi gerekiyorsa kullanın.
            "*": { systemPrompt: "İş grupları için varsayılan istem." },
          },
          direct: {
            // Bu hesap kendi direct eşlemesini tanımlar, dolayısıyla kök direct girdileri
            // tamamen değiştirilir. Joker karakteri korumak için "*" değerini burada da açıkça tanımlayın.
            "+15551234567": { systemPrompt: "Belirli bir doğrudan iş sohbeti için istem." },
            "*": { systemPrompt: "Doğrudan iş sohbetleri için varsayılan istem." },
          },
        },
      },
    },
  },
}

​

Yapılandırma başvurusu bağlantıları

​

İlgili

• Eşleştirme
• Gruplar
• Güvenlik
• Kanal yönlendirme
• Çoklu agent yönlendirme
• Sorun giderme