​

Zalo Pribadi (tidak resmi)

Peringatan: Ini adalah integrasi tidak resmi dan dapat menyebabkan penangguhan/pemblokiran akun. Gunakan dengan risiko Anda sendiri.

​

Plugin bawaan

• Instal melalui CLI: openclaw plugins install @openclaw/zalouser
• Atau dari checkout source: openclaw plugins install ./path/to/local/zalouser-plugin
• Detail: Plugins

​

Penyiapan cepat (pemula)

1. Pastikan plugin Zalo Personal tersedia.
   • Rilis OpenClaw terkemas saat ini sudah menyertakannya.
   • Instalasi lama/kustom dapat menambahkannya secara manual dengan perintah di atas.
2. Login (QR, di mesin Gateway):
   • openclaw channels login --channel zalouser
   • Pindai kode QR dengan aplikasi seluler Zalo.
3. Aktifkan channel:

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

4. Mulai ulang Gateway (atau selesaikan penyiapan).
5. Akses DM default-nya adalah pairing; setujui kode pairing saat kontak pertama.

​

Apa ini

• Berjalan sepenuhnya in-process melalui zca-js.
• Menggunakan event listener native untuk menerima pesan masuk.
• Mengirim balasan langsung melalui API JS (teks/media/tautan).
• Dirancang untuk kasus penggunaan “akun pribadi” saat API Bot Zalo tidak tersedia.

​

Penamaan

​

Menemukan ID (direktori)

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

​

Batasan

• Teks keluar dipecah menjadi sekitar 2000 karakter (batas klien Zalo).
• Streaming diblokir secara default.

​

Kontrol akses (DM)

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

​

Akses grup (opsional)

• Default: channels.zalouser.groupPolicy = "open" (grup diizinkan). Gunakan channels.defaults.groupPolicy untuk menimpa default saat tidak disetel.
• Batasi ke allowlist dengan:
  • channels.zalouser.groupPolicy = "allowlist"
  • channels.zalouser.groups (kunci sebaiknya berupa ID grup yang stabil; nama diselesaikan menjadi ID saat startup jika memungkinkan)
  • channels.zalouser.groupAllowFrom (mengontrol pengirim mana dalam grup yang diizinkan dapat memicu bot)
• Blokir semua grup: channels.zalouser.groupPolicy = "disabled".
• Wizard konfigurasi dapat meminta allowlist grup.
• Saat startup, OpenClaw menyelesaikan nama grup/pengguna dalam allowlist menjadi ID dan mencatat pemetaannya.
• Pencocokan allowlist grup secara default berbasis ID saja. Nama yang tidak terselesaikan diabaikan untuk auth kecuali channels.zalouser.dangerouslyAllowNameMatching: true diaktifkan.
• channels.zalouser.dangerouslyAllowNameMatching: true adalah mode kompatibilitas break-glass yang mengaktifkan kembali pencocokan nama grup yang dapat berubah.
• Jika groupAllowFrom tidak disetel, runtime menggunakan allowFrom sebagai fallback untuk pemeriksaan pengirim grup.
• Pemeriksaan pengirim berlaku untuk pesan grup normal maupun perintah kontrol (misalnya /new, /reset).

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

​

Pembatasan mention grup

• channels.zalouser.groups.<group>.requireMention mengontrol apakah balasan grup memerlukan mention.
• Urutan resolusi: id/nama grup persis -> slug grup ternormalisasi -> * -> default (true).
• Ini berlaku baik untuk grup yang masuk allowlist maupun mode grup terbuka.
• Mengutip pesan bot dihitung sebagai mention implisit untuk aktivasi grup.
• Perintah kontrol yang diotorisasi (misalnya /new) dapat melewati pembatasan mention.
• Saat pesan grup dilewati karena mention diperlukan, OpenClaw menyimpannya sebagai riwayat grup tertunda dan menyertakannya pada pesan grup berikutnya yang diproses.
• Batas riwayat grup secara default adalah messages.groupChat.historyLimit (fallback 50). Anda dapat menimpa per akun dengan channels.zalouser.historyLimit.

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

​

Multi-akun

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

​

Mengetik, reaksi, dan pengakuan pengiriman

• OpenClaw mengirim event mengetik sebelum mengirim balasan (best-effort).
• Aksi reaksi pesan react didukung untuk zalouser dalam aksi channel.
  • Gunakan remove: true untuk menghapus emoji reaksi tertentu dari sebuah pesan.
  • Semantik reaksi: Reactions
• Untuk pesan masuk yang menyertakan metadata event, OpenClaw mengirim pengakuan delivered + seen (best-effort).

​

Pemecahan masalah

• openclaw channels status --probe
• Login ulang: openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser

• Gunakan ID numerik di allowFrom/groupAllowFrom/groups, atau nama teman/grup yang persis.

• Hapus asumsi proses zca eksternal lama.
• Channel sekarang berjalan sepenuhnya di OpenClaw tanpa biner CLI eksternal.

​

Terkait

• Ikhtisar Channel — semua channel yang didukung
• Pairing — autentikasi DM dan alur pairing
• Grup — perilaku obrolan grup dan pembatasan mention
• Perutean Channel — perutean sesi untuk pesan
• Keamanan — model akses dan hardening