​

Zalo Personal (resmi olmayan)

Uyarı: Bu resmi olmayan bir entegrasyondur ve hesabın askıya alınmasına/banlanmasına yol açabilir. Riski size aittir.

​

Paketlenmiş eklenti

• CLI ile kurun: openclaw plugins install @openclaw/zalouser
• Ya da kaynak kod checkout’undan: openclaw plugins install ./path/to/local/zalouser-plugin
• Ayrıntılar: Plugins

​

Hızlı kurulum (başlangıç seviyesi)

1. Zalo Personal eklentisinin kullanılabilir olduğundan emin olun.
   • Mevcut paketlenmiş OpenClaw sürümleri bunu zaten içerir.
   • Eski/özel kurulumlar bunu yukarıdaki komutlarla elle ekleyebilir.
2. Giriş yapın (QR, Gateway makinesinde):
   • openclaw channels login --channel zalouser
   • QR kodunu Zalo mobil uygulamasıyla tarayın.
3. Kanalı etkinleştirin:

{
  channels: {
    zalouser: {
      enabled: true,
      dmPolicy: "pairing",
    },
  },
}

4. Gateway’i yeniden başlatın (veya kurulumu tamamlayın).
5. DM erişimi varsayılan olarak eşleme kullanır; ilk temasta eşleme kodunu onaylayın.

​

Nedir

• Tamamen işlem içinde zca-js aracılığıyla çalışır.
• Gelen mesajları almak için yerel olay dinleyicilerini kullanır.
• Yanıtları doğrudan JS API üzerinden gönderir (metin/medya/bağlantı).
• Zalo Bot API’nin mevcut olmadığı “kişisel hesap” kullanım senaryoları için tasarlanmıştır.

​

Adlandırma

​

Kimlikleri bulma (dizin)

openclaw directory self --channel zalouser
openclaw directory peers list --channel zalouser --query "name"
openclaw directory groups list --channel zalouser --query "work"

​

Sınırlar

• Giden metin yaklaşık 2000 karaktere bölünür (Zalo istemci sınırları).
• Streaming varsayılan olarak engellenir.

​

Erişim denetimi (DM’ler)

• openclaw pairing list zalouser
• openclaw pairing approve zalouser <code>

​

Grup erişimi (isteğe bağlı)

• Varsayılan: channels.zalouser.groupPolicy = "open" (gruplara izin verilir). Ayarlanmamışsa varsayılanı geçersiz kılmak için channels.defaults.groupPolicy kullanın.
• Bir izin listesiyle kısıtlamak için:
  • channels.zalouser.groupPolicy = "allowlist"
  • channels.zalouser.groups (anahtarlar kararlı grup kimlikleri olmalıdır; mümkün olduğunda adlar başlangıçta kimliklere çözümlenir)
  • channels.zalouser.groupAllowFrom (izin verilen gruplarda hangi gönderenlerin botu tetikleyebileceğini denetler)
• Tüm grupları engellemek için: channels.zalouser.groupPolicy = "disabled".
• Yapılandırma sihirbazı grup izin listelerini sorabilir.
• Başlangıçta OpenClaw, izin listelerindeki grup/kullanıcı adlarını kimliklere çözümler ve eşlemeyi günlüğe yazar.
• Grup izin listesi eşleştirmesi varsayılan olarak yalnızca kimlik üzerinden yapılır. Çözümlenmemiş adlar, channels.zalouser.dangerouslyAllowNameMatching: true etkin değilse yetkilendirme için yok sayılır.
• channels.zalouser.dangerouslyAllowNameMatching: true, değişebilir grup adı eşleştirmesini yeniden etkinleştiren son çare uyumluluk modudur.
• groupAllowFrom ayarlanmamışsa, çalışma zamanı grup gönderen denetimleri için allowFrom değerine geri döner.
• Gönderen denetimleri hem normal grup mesajları hem de kontrol komutları için geçerlidir (örneğin /new, /reset).

{
  channels: {
    zalouser: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["1471383327500481391"],
      groups: {
        "123456789": { allow: true },
        "Work Chat": { allow: true },
      },
    },
  },
}

​

Grup bahsetme geçidi

• channels.zalouser.groups.<group>.requireMention, grup yanıtlarının bahsetme gerektirip gerektirmediğini denetler.
• Çözümleme sırası: tam grup kimliği/adı -> normalize edilmiş grup slug’ı -> * -> varsayılan (true).
• Bu hem izin listesine alınmış gruplar hem de açık grup modu için geçerlidir.
• Yetkili kontrol komutları (örneğin /new) bahsetme geçidini atlayabilir.
• Bir grup mesajı, bahsetme gerektiği için atlandığında OpenClaw bunu bekleyen grup geçmişi olarak saklar ve bir sonraki işlenen grup mesajına ekler.
• Grup geçmişi sınırı varsayılan olarak messages.groupChat.historyLimit değeridir (geri dönüş: 50). Hesap başına geçersiz kılmak için channels.zalouser.historyLimit kullanabilirsiniz.

{
  channels: {
    zalouser: {
      groupPolicy: "allowlist",
      groups: {
        "*": { allow: true, requireMention: true },
        "Work Chat": { allow: true, requireMention: false },
      },
    },
  },
}

​

Çoklu hesap

{
  channels: {
    zalouser: {
      enabled: true,
      defaultAccount: "default",
      accounts: {
        work: { enabled: true, profile: "work" },
      },
    },
  },
}

​

Yazıyor, tepkiler ve teslim alındı bildirimleri

• OpenClaw, bir yanıt göndermeden önce bir yazıyor olayı gönderir (best-effort).
• Kanal eylemlerinde zalouser için react mesaj tepki eylemi desteklenir.
  • Bir mesajdan belirli bir tepki emojisini kaldırmak için remove: true kullanın.
  • Tepki semantiği: Reactions
• Olay meta verisi içeren gelen mesajlarda OpenClaw, teslim edildi + görüldü bildirimleri gönderir (best-effort).

​

Sorun giderme

• openclaw channels status --probe
• Yeniden giriş yapın: openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser

• allowFrom/groupAllowFrom/groups içinde sayısal kimlikler veya tam arkadaş/grup adları kullanın.

• Eski harici zca süreci varsayımlarını kaldırın.
• Kanal artık harici CLI ikili dosyaları olmadan tamamen OpenClaw içinde çalışır.

​

İlgili

• Channels Overview — desteklenen tüm kanallar
• Pairing — DM kimlik doğrulaması ve eşleme akışı
• Groups — grup sohbeti davranışı ve bahsetme geçidi
• Channel Routing — mesajlar için oturum yönlendirmesi
• Security — erişim modeli ve sağlamlaştırma