Zalo ClawBot

OpenClaw terhubung ke Zalo ClawBot melalui Plugin eksternal @zalo-platforms/openclaw-zaloclawbot yang tercantum di katalog. Login menggunakan kode QR Zalo Mini App.

Kompatibilitas

Prasyarat

• Node.js >= 22
• OpenClaw harus sudah terinstal (CLI openclaw tersedia).
• Akun Zalo di perangkat seluler untuk memindai kode QR login.

Instal dengan onboard (direkomendasikan)

Jalankan wizard orientasi OpenClaw dan pilih Zalo ClawBot dari menu channel:

openclaw onboard

Wizard memasang Plugin dari katalog resmi (dengan integritas terverifikasi), menampilkan QR login langsung di terminal, dan menyelesaikan channel setelah Anda memindainya dengan aplikasi Zalo. Tidak diperlukan perintah tambahan.

Instalasi Manual

Untuk menambahkan channel ke Gateway yang sudah menjalani orientasi, ikuti langkah-langkah berikut:

1. Instal Plugin

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

Gunakan versi tersemat persis seperti yang ditampilkan di atas (sesuai dengan entri katalog resmi), agar OpenClaw memverifikasi paket terhadap hash integritas katalog selama instalasi.

2. Aktifkan Plugin di config

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

3. Buat kode QR dan login

openclaw channels login --channel openclaw-zaloclawbot

Pindai kode QR yang ditampilkan di terminal menggunakan aplikasi seluler Zalo, terima Ketentuan Penggunaan di dalam Zalo Mini App, dan otorisasi sesi.

4. Mulai ulang Gateway

openclaw gateway restart

Cara Kerjanya

Berbeda dengan channel developer Zalo standar yang mengharuskan Anda mendaftarkan Zalo Official Account (OA) sendiri dan menempelkan kredensial developer statis, Zalo ClawBot beroperasi sebagai asisten pribadi yang terikat pemilik menggunakan infrastruktur resmi bersama:

1. Orientasi Aman: Kode QR mengarah ke Zalo Mini App aman yang mengikat bot privat yang baru disediakan di bawah OA resmi bersama langsung ke Zalo User ID Anda.
2. Privasi Terikat Pemilik: Secara desain, bot dibatasi untuk berkomunikasi hanya dengan pemiliknya. Pesan dari pengguna lain dibuang di tingkat platform, sehingga koneksi tetap privat dan aman.
3. Jalur API Resmi: Plugin menggunakan API Zalo Bot Platform, bukan otomatisasi browser atau sesi web.

Di Balik Layar

Plugin Zalo ClawBot berkomunikasi dengan API Zalo melalui loop pesan long-polling persisten. Untuk mempertahankan runtime yang bersih dan ringan:

• Koneksi long-poll menggunakan endpoint getUpdates.
• Webhook dinonaktifkan secara default untuk eksekusi Gateway desktop/terminal lokal.
• Pesan diproses di sisi klien dan dipetakan langsung ke runtime agen lokal Anda.

Plugin eksternal mengelola kredensial bot di bawah direktori state OpenClaw. Perlakukan direktori tersebut sebagai sensitif dan sertakan dalam kebijakan kontrol akses dan cadangan yang sama seperti state OpenClaw lainnya.

Pemecahan Masalah

• Waktu Login QR Habis: Token login (zbsk) kedaluwarsa setelah 5 menit karena alasan keamanan. Jika kode QR kedaluwarsa sebelum Anda memindainya, cukup jalankan ulang perintah login untuk membuat yang baru.
• Gateway Gagal Dimuat: Pastikan versi host OpenClaw Anda adalah 2026.4.10 atau lebih tinggi. Versi yang lebih lama tidak mendukung ledger instalasi Plugin npm eksternal.