Zalo ClawBot

OpenClaw, katalogda listelenen harici @zalo-platforms/openclaw-zaloclawbot Plugin aracılığıyla Zalo ClawBot'a bağlanır. Oturum açma işlemi bir Zalo Mini App QR kodu kullanır; yapılandırmadaki Plugin kimliği openclaw-zaloclawbot şeklindedir.

Uyumluluk

Ön koşullar

• Node.js >= 22
• OpenClaw kurulu (openclaw CLI kullanılabilir)
• Oturum açma QR kodunu taramak için mobil cihazda bir Zalo hesabı

Onboard ile kurulum (önerilir)

openclaw onboard

Kanal menüsünden Zalo ClawBot seçeneğini belirleyin. Sihirbaz, Plugin'i resmî katalogdan kurar (bütünlük doğrulamasıyla), oturum açma QR kodunu terminalde görüntüler ve kodu Zalo uygulamasıyla taramanızın ardından kanal kurulumunu tamamlar.

Manuel kurulum

Kanalı onboard işlemi tamamlanmış bir Gateway'e eklemek için:

1. Plugin'i kurun

openclaw plugins install "@zalo-platforms/openclaw-zaloclawbot@0.1.4"

OpenClaw'ın kurulum sırasında paketi katalogdaki bütünlük karmasıyla doğrulayabilmesi için tam olarak sabitlenmiş bu sürümü kullanın.

2. Yapılandırmada Plugin'i etkinleştirin

openclaw config set plugins.entries.openclaw-zaloclawbot.enabled true

3. QR kodu oluşturun ve oturum açın

openclaw channels login --channel openclaw-zaloclawbot

Terminalde görüntülenen QR kodunu Zalo mobil uygulamasıyla tarayın, Zalo Mini App içindeki Kullanım Koşulları'nı kabul edin ve oturumu yetkilendirin.

4. Gateway'i yeniden başlatın

openclaw gateway restart

Nasıl çalışır?

Kendi Zalo Official Account (OA) hesabınızı kaydetmenizi ve statik geliştirici kimlik bilgilerini yapılandırmanızı gerektiren standart Zalo kanalından farklı olarak Zalo ClawBot, paylaşılan resmî altyapı üzerinde çalışan sahibine bağlı bir kişisel asistandır:

1. İlk kurulum: QR kodu, paylaşılan resmî bir OA altında yeni sağlanan özel bir botu doğrudan Zalo kullanıcı kimliğinize bağlayan bir Zalo Mini App'e yönlendirir.
2. Sahibe bağlı gizlilik: bot yalnızca sahibiyle iletişim kurar. Diğer kullanıcılardan gelen mesajlar platform düzeyinde bırakılır.
3. Resmî API yolu: Plugin, tarayıcı veya web oturumu otomasyonu yerine Zalo Bot Platform API'lerini kullanır.

Arka planda

Plugin, kalıcı bir uzun yoklama döngüsü (getUpdates) üzerinden Zalo ile iletişim kurar. Yerel masaüstü/terminal Gateway çalıştırmalarında Webhook'lar varsayılan olarak devre dışıdır. Mesajlar istemci tarafında işlenir ve yerel agent çalışma zamanınıza eşlenir.

Plugin, bot kimlik bilgilerini OpenClaw durum dizini altında yönetir. Bu dizini hassas olarak değerlendirin ve OpenClaw durumunun geri kalanıyla aynı erişim denetimi ve yedekleme politikasına tabi tutun.

Bu Plugin'in çalışma zamanı tamamen harici @zalo-platforms/openclaw-zaloclawbot paketinde bulunur; aşağıdaki kurulum/yapılandırma dışındaki davranış ayrıntıları Plugin'in bakımcıları tarafından bildirildiği şekildedir ve OpenClaw çekirdek kaynağıyla karşılaştırılarak doğrulanmamıştır.

Sorun giderme

• QR ile oturum açma zaman aşımı: oturum açma belirtecinin (zbsk) süresi güvenlik nedeniyle 5 dakika sonra dolar. QR kodunun süresi siz taramadan önce dolarsa yeni bir kod oluşturmak için oturum açma komutunu yeniden çalıştırın.
• Gateway yüklenemiyor: OpenClaw ana makine sürümünüzün 2026.4.10 veya üzeri olduğunu doğrulayın. Eski sürümler, bu kimliğin gerektirdiği harici npm Plugin'i kurulum defterini desteklemez.

İlgili

• Kanallara Genel Bakış - desteklenen tüm kanallar
• Zalo - paketle birlikte sunulan Zalo Bot Creator / Marketplace kanalı
• Eşleştirme - DM kimlik doğrulama ve eşleştirme akışı
• Plugin'ler - Plugin'leri kurma ve yönetme