Zalo ClawBot

OpenClaw terhubung ke Zalo ClawBot melalui plugin eksternal @zalo-platforms/openclaw-zaloclawbot yang tercantum dalam katalog. Proses masuk menggunakan kode QR Zalo Mini App; id plugin dalam konfigurasi adalah openclaw-zaloclawbot.

Kompatibilitas

Prasyarat

• Node.js >= 22
• OpenClaw telah terpasang (CLI openclaw tersedia)
• Akun Zalo pada perangkat seluler untuk memindai kode QR masuk

Instalasi dengan onboard (disarankan)

openclaw onboard

Pilih Zalo ClawBot dari menu kanal. Wizard memasang plugin dari katalog resmi (dengan integritas yang diverifikasi), menampilkan QR masuk di terminal, dan menyelesaikan penyiapan kanal setelah Anda memindainya dengan aplikasi Zalo.

Instalasi manual

Untuk menambahkan kanal ke Gateway yang telah melalui proses onboard:

1. Pasang plugin

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

Gunakan versi tersemat yang tepat agar OpenClaw memverifikasi paket terhadap hash integritas katalog selama instalasi.

2. Aktifkan plugin dalam konfigurasi

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

3. Buat kode QR dan masuk

openclaw channels login --channel openclaw-zaloclawbot

Pindai kode QR yang ditampilkan di terminal dengan aplikasi seluler Zalo, setujui Ketentuan Penggunaan di dalam Zalo Mini App, lalu otorisasi sesi tersebut.

4. Mulai ulang Gateway

openclaw gateway restart

Cara kerjanya

Tidak seperti kanal Zalo standar, yang mengharuskan Anda mendaftarkan Zalo Official Account (OA) sendiri dan mengonfigurasi kredensial pengembang statis, Zalo ClawBot adalah asisten pribadi yang terikat pada pemilik di infrastruktur resmi bersama:

1. Onboarding: kode QR mengarah ke Zalo Mini App yang mengikat bot privat yang baru disediakan di bawah OA resmi bersama secara langsung ke ID pengguna Zalo Anda.
2. Privasi terikat pemilik: bot hanya berkomunikasi dengan pemiliknya. Pesan dari pengguna lain dibuang pada tingkat platform.
3. Jalur API resmi: plugin menggunakan API Zalo Bot Platform, bukan otomatisasi browser atau sesi web.

Mekanisme internal

Plugin berkomunikasi dengan Zalo melalui loop long-polling persisten (getUpdates). Webhook dinonaktifkan secara default untuk Gateway lokal yang dijalankan dari desktop/terminal. Pesan diproses di sisi klien dan dipetakan ke runtime agen lokal Anda.

Plugin mengelola kredensial bot di dalam direktori status OpenClaw. Perlakukan direktori tersebut sebagai data sensitif dan lindungi dengan kebijakan kontrol akses serta pencadangan yang sama seperti status OpenClaw lainnya.

Runtime plugin ini sepenuhnya berada dalam paket eksternal @zalo-platforms/openclaw-zaloclawbot; detail perilaku di bawah ini selain instalasi/konfigurasi dilaporkan oleh pengelola plugin dan tidak diverifikasi terhadap kode sumber inti OpenClaw.

Pemecahan masalah

• Batas waktu masuk melalui QR: token masuk (zbsk) kedaluwarsa setelah 5 menit demi keamanan. Jika kode QR kedaluwarsa sebelum Anda memindainya, jalankan kembali perintah masuk untuk membuat kode baru.
• Gateway gagal dimuat: pastikan versi host OpenClaw Anda adalah 2026.4.10 atau yang lebih baru. Versi lama tidak mendukung ledger instalasi plugin npm eksternal yang diperlukan oleh ID ini.

Terkait

• Ikhtisar Kanal - semua kanal yang didukung
• Zalo - kanal Zalo Bot Creator / Marketplace bawaan
• Pemasangan - autentikasi DM dan alur pemasangan
• Plugin - memasang dan mengelola plugin