Skip to main content
OpenClaw terhubung ke WeChat melalui plugin saluran eksternal Tencent @tencent-weixin/openclaw-weixin. Status: plugin eksternal, dipelihara oleh tim Tencent Weixin. Percakapan langsung dan media didukung. Percakapan grup tidak dinyatakan didukung oleh metadata kapabilitas plugin (plugin hanya mendeklarasikan percakapan langsung).

​
Penamaan

  • WeChat adalah nama yang ditampilkan kepada pengguna dalam dokumentasi ini.
  • Weixin adalah nama yang digunakan oleh paket Tencent dan id plugin.
  • openclaw-weixin adalah id saluran OpenClaw (weixin dan wechat berfungsi sebagai alias).
  • @tencent-weixin/openclaw-weixin adalah paket npm.
Gunakan openclaw-weixin dalam perintah CLI dan jalur konfigurasi.

​
Cara kerjanya

Kode WeChat tidak berada di repositori inti OpenClaw. OpenClaw menyediakan kontrak plugin saluran generik, sedangkan plugin eksternal menyediakan runtime khusus WeChat:
  1. openclaw plugins install menginstal @tencent-weixin/openclaw-weixin.
  2. Gateway menemukan manifes plugin dan memuat titik masuk plugin.
  3. Plugin mendaftarkan id saluran openclaw-weixin.
  4. openclaw channels login --channel openclaw-weixin memulai proses masuk dengan QR.
  5. Plugin menyimpan kredensial akun di bawah direktori status OpenClaw (~/.openclaw secara default).
  6. Saat Gateway dimulai, plugin memulai pemantau Weixin untuk setiap akun yang dikonfigurasi.
  7. Pesan WeChat yang masuk dinormalisasi melalui kontrak saluran, dirutekan ke agen OpenClaw yang dipilih, dan dikirim kembali melalui jalur keluar plugin.
Pemisahan tersebut penting: inti OpenClaw tetap tidak bergantung pada saluran tertentu. Proses masuk WeChat, panggilan API Tencent iLink, pengunggahan/pengunduhan media, token konteks, dan pemantauan akun dikelola oleh plugin eksternal.

​
Instalasi

Instalasi cepat:
Instalasi manual:
Mulai ulang Gateway setelah instalasi:

​
Masuk

Jalankan proses masuk dengan QR pada mesin yang sama dengan mesin yang menjalankan Gateway:
Pindai kode QR dengan WeChat di ponsel Anda dan konfirmasikan proses masuk. Plugin menyimpan token akun secara lokal setelah pemindaian berhasil. Untuk menambahkan akun WeChat lain, jalankan kembali perintah masuk yang sama. Untuk beberapa akun, pisahkan sesi pesan langsung berdasarkan akun, saluran, dan pengirim:

​
Kontrol akses

Pesan langsung menggunakan model pemasangan dan daftar izin OpenClaw yang lazim untuk plugin saluran. Setujui pengirim baru:
Untuk model kontrol akses selengkapnya, lihat Pemasangan.

​
Kompatibilitas

Plugin memeriksa versi OpenClaw host saat dimulai. Jika plugin melaporkan bahwa versi OpenClaw Anda terlalu lama, perbarui OpenClaw atau instal lini plugin lama:

​
Proses sidecar

Plugin WeChat dapat menjalankan proses pembantu di samping Gateway saat memantau API Tencent iLink. Dalam isu #68451, jalur pembantu tersebut mengungkap bug pada pembersihan Gateway usang generik milik OpenClaw: proses anak dapat mencoba membersihkan proses Gateway induk, sehingga menyebabkan siklus mulai ulang di bawah pengelola proses seperti systemd. Pembersihan saat OpenClaw dimulai saat ini mengecualikan proses aktif dan proses-proses leluhurnya, sehingga proses pembantu saluran tidak dapat menghentikan Gateway yang menjalankannya. Perbaikan ini bersifat generik; ini bukan jalur khusus WeChat dalam inti.

​
Pemecahan masalah

Periksa instalasi dan status:
Jika saluran ditampilkan sebagai terinstal tetapi tidak terhubung, pastikan plugin diaktifkan lalu mulai ulang:
Jika Gateway terus dimulai ulang setelah WeChat diaktifkan, perbarui OpenClaw dan plugin:
Jika saat dimulai muncul laporan bahwa paket plugin yang terinstal requires compiled runtime output for TypeScript entry, paket npm tersebut diterbitkan tanpa berkas runtime JavaScript terkompilasi yang diperlukan OpenClaw. Perbarui/instal ulang setelah penerbit plugin merilis paket yang telah diperbaiki, atau nonaktifkan/hapus instalasi plugin untuk sementara. Penonaktifan sementara:

​
Dokumentasi terkait