@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 (
openclawCLI kullanılabilir) - Oturum açma QR kodunu taramak için mobil cihazda bir Zalo hesabı
Onboard ile kurulum (önerilir)
Manuel kurulum
Kanalı onboard işlemi tamamlanmış bir Gateway’e eklemek için:1. Plugin’i kurun
2. Yapılandırmada Plugin’i etkinleştirin
3. QR kodu oluşturun ve oturum açın
4. Gateway’i yeniden başlatın
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:- İ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.
- 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.
- 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.10veya ü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