Cara Menggunakan OpenClaw dengan WeChat Gratis

Singkatnya:

Hubungkan OpenClaw ke WeChat dengan menginstal plugin @tencent-weixin/openclaw-weixin, pindai kode QR untuk otorisasi akun, dan mulai ulang gateway. Seluruh proses selesai kurang dari 5 menit. Plugin ini gratis, open source, dan mendukung banyak akun WeChat sekaligus.

Coba Apidog hari ini

---

Pendahuluan

Menjalankan asisten AI di WeChat sering dianggap rumit karena biasanya membutuhkan langganan API mahal, penyiapan server, atau akun perusahaan. OpenClaw mengatasi masalah tersebut.

Plugin @tencent-weixin/openclaw-weixin memungkinkan Anda menghubungkan akun WeChat pribadi ke gateway AI OpenClaw dalam hitungan menit, tanpa akun perusahaan dan biaya bulanan. Cukup scan kode QR, langsung bisa digunakan.

Panduan ini membahas langkah demi langkah: instalasi plugin, menambah multi-akun, isolasi konteks percakapan, hingga troubleshooting. Di akhir, WeChat Anda akan memiliki asisten AI yang siap pakai.

💡 Catatan: Jika bot WeChat Anda perlu menggunakan API eksternal (cuaca, pembayaran, CRM), gunakan alat pengujian API seperti Apidog untuk merancang, menguji, dan mendokumentasikan API sebelum menghubungkan ke bot.

---

Prasyarat

Sebelum mulai, siapkan:

• OpenClaw terinstal (>=2026.3.22 untuk plugin v2.0.x)
• CLI openclaw tersedia di terminal
• Akun WeChat pribadi (tidak perlu akun perusahaan)
• Node.js terinstal (untuk instalasi sekali klik)

Cek versi OpenClaw Anda:

openclaw --version

Jika versi terlalu lama, update dulu. Plugin v2.0.x butuh OpenClaw >=2026.3.22.

---

Kompatibilitas Plugin

Versi Plugin	Versi OpenClaw	Status
2.0.x	>=2026.3.22	Aktif
1.0.x	>=2026.1.0 <2026.3.22	Pemeliharaan

Plugin akan memeriksa versi host saat startup. Jika versi OpenClaw tidak cocok, plugin tidak akan dimuat.

---

Langkah 1: Instal Plugin

Opsi A: Instal Sekali Klik (Direkomendasikan)

npx -y @tencent-weixin/openclaw-weixin-cli install

Semua proses (instalasi, konfigurasi, penyiapan) berjalan otomatis.

Opsi B: Instal Manual

Jika opsi otomatis gagal, gunakan manual:

1. Instal plugin:

openclaw plugins install "@tencent-weixin/openclaw-weixin"

2. Aktifkan plugin:

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

---

Langkah 2: Pindai Kode QR untuk Otorisasi WeChat

Login akun WeChat Anda:

openclaw channels login --channel openclaw-weixin

Kode QR akan muncul di terminal. Buka aplikasi WeChat, gunakan fitur scan, dan konfirmasi otorisasi.

Kredensial login disimpan lokal otomatis. Tidak perlu scan ulang kecuali Anda logout.

---

Langkah 3: Mulai Ulang Gateway

Setelah login, restart gateway untuk mengaktifkan plugin:

openclaw gateway restart

Akun WeChat sekarang terhubung ke OpenClaw. Semua pesan masuk akan diproses oleh agent AI.

---

Langkah 4: Tambahkan Banyak Akun WeChat (Opsional)

Untuk multi-akun, ulangi perintah login:

openclaw channels login --channel openclaw-weixin

Setiap scan QR = akun baru. Semua akun berjalan paralel dan terpisah.

---

Langkah 5: Isolasi Konteks Percakapan (Opsional)

Secara default, semua channel berbagi memori AI yang sama. Untuk setiap akun WeChat memiliki konteks AI sendiri:

openclaw config set agents.mode per-channel-per-peer

Setiap kombinasi "akun WeChat + kontak" punya memori AI terpisah.

---

Cara Kerja Plugin Secara Internal

Header Otentikasi

Semua permintaan API memakai header berikut:

Header	Nilai
Content-Type	application/json
AuthorizationType	ilink_bot_token
Authorization	Bearer <token>
X-WECHAT-UIN	Uint32 acak (base64 encoded)

---

Endpoint API Inti

Plugin menggunakan 5 endpoint HTTP JSON:

Endpoint	Jalur	Tujuan
getUpdates	getupdates	Long-poll pesan baru
sendMessage	sendmessage	Kirim teks/gambar/video/file
getUploadUrl	getuploadurl	Dapatkan URL upload media CDN
getConfig	getconfig	Dapatkan konfigurasi akun
sendTyping	sendtyping	Tampilkan/sembunyikan indikator mengetik

---

Menerima Pesan (Long Polling)

Contoh permintaan & respon:

// Permintaan
{
  "get_updates_buf": ""
}

// Respon
{
  "ret": 0,
  "msgs": [...],
  "get_updates_buf": "<new_cursor>",
  "longpolling_timeout_ms": 35000
}

Gunakan nilai get_updates_buf dari respon untuk permintaan berikutnya agar hanya pesan baru yang diterima.

---

Mengirim Pesan

{
  "msg": {
    "to_user_id": "<target_user_id>",
    "context_token": "<session_context_token>",
    "item_list": [
      {
        "type": 1,
        "text_item": { "text": "Halo!" }
      }
    ]
  }
}

---

Tipe Pesan

Tipe	Nilai
TEXT	1
IMAGE	2
VOICE	3
FILE	4
VIDEO	5

---

Unggah Media (Gambar, File, Video)

Alur upload media (file dienkripsi AES-128-ECB):

1. Panggil getUploadUrl dengan metadata file (ukuran, MD5)
2. Dapatkan parameter upload CDN (signed)
3. Enkripsi file dengan AES-128-ECB
4. Upload ke CDN menggunakan signed URL
5. Referensikan file CDN pada sendMessage

---

Masalah Umum dan Solusi

Plugin Menolak Dimuat

Error: Plugin tidak termuat saat startup

Solusi: Pastikan OpenClaw versi >=2026.3.22.

openclaw --version
# Jika versi lama, update OpenClaw

---

Kode QR Kedaluwarsa

Error: Kode QR expired sebelum dipindai

Solusi: Jalankan ulang perintah login. Kode QR valid ±30 detik.

openclaw channels login --channel openclaw-weixin

---

Pesan Tidak Diterima

Error: Pesan WeChat tidak masuk ke OpenClaw

Solusi: Restart gateway setelah login.

openclaw gateway restart

---

Banyak Akun Mencampur Konteks

Error: Respon AI akun A muncul di akun B

Solusi: Aktifkan isolasi konteks per channel.

openclaw config set agents.mode per-channel-per-peer

---

Kasus Penggunaan Dunia Nyata

Asisten AI Pribadi

Sambungkan WeChat pribadi ke OpenClaw, asisten AI akan menjawab pesan saat Anda sibuk. Aktifkan isolasi konteks agar tiap kontak mendapat respon sesuai riwayat percakapan masing-masing.

Dukungan Pelanggan Bisnis Kecil

Jalankan multi-akun WeChat untuk berbagai lini bisnis, masing-masing dengan memori AI terisolasi. Tidak ada data silang antar akun.

Pengujian Pengembang

Gunakan API HTTP JSON plugin untuk membangun integrasi custom. Protokol backend plugin terdokumentasi penuh untuk modifikasi atau ekstensi.

---

Kesimpulan

Penyiapan OpenClaw + WeChat selesai kurang dari 5 menit: instal plugin, scan QR, restart gateway—siap pakai. Gratis, mendukung multi-akun, isolasi konteks, dan support media (gambar, suara, file, video).

API HTTP JSON terdokumentasi memudahkan integrasi custom.

Mulai dengan instalasi sekali klik:

npx -y @tencent-weixin/openclaw-weixin-cli install

Langkah berikutnya:

Setelah bot WeChat berjalan, biasanya Anda perlu integrasi API eksternal (payment, CRM, cuaca, dsb). Uji API Anda dengan Apidog agar bot mengirim data yang benar. Paket gratis tanpa kartu kredit.

---

FAQ

T: Apakah plugin ini bisa untuk akun WeChat pribadi?

J: Ya. Tidak butuh akun perusahaan/resmi.

T: Apakah plugin gratis?

J: Ya. @tencent-weixin/openclaw-weixin open source & gratis.

T: Bisakah menjalankan banyak akun WeChat sekaligus?

J: Bisa. Jalankan openclaw channels login --channel openclaw-weixin untuk tiap akun.

T: Bagaimana jika komputer saya restart?

J: Login tetap tersimpan. Tidak perlu scan QR ulang, cukup restart gateway via openclaw gateway restart.

T: Bisakah membuat integrasi custom?

J: Ya. Plugin expose API HTTP JSON (getUpdates, sendMessage, getUploadUrl, getConfig, sendTyping). Untuk uji integrasi API eksternal, gunakan Apidog.

---