Langsung ke konten utama

​
WeChat

OpenClaw terhubung ke WeChat melalui Plugin channel eksternal milik Tencent, @tencent-weixin/openclaw-weixin. Status: Plugin eksternal. Chat langsung dan media didukung. Chat grup tidak diiklankan oleh metadata kapabilitas Plugin saat ini.

​
Penamaan

  • WeChat adalah nama yang digunakan untuk pengguna dalam dokumentasi ini.
  • Weixin adalah nama yang digunakan oleh paket Tencent dan oleh id Plugin.
  • openclaw-weixin adalah id channel OpenClaw.
  • @tencent-weixin/openclaw-weixin adalah paket npm.
Gunakan openclaw-weixin dalam perintah CLI dan path konfigurasi.

​
Cara kerjanya

Kode WeChat tidak berada di repo inti OpenClaw. OpenClaw menyediakan kontrak Plugin channel generik, dan Plugin eksternal menyediakan runtime khusus WeChat:
  1. openclaw plugins install memasang @tencent-weixin/openclaw-weixin.
  2. Gateway menemukan manifes Plugin dan memuat entrypoint Plugin.
  3. Plugin mendaftarkan id channel openclaw-weixin.
  4. openclaw channels login --channel openclaw-weixin memulai login QR.
  5. Plugin menyimpan kredensial akun di bawah direktori state OpenClaw.
  6. Saat Gateway dimulai, Plugin memulai monitor Weixin untuk setiap akun yang dikonfigurasi.
  7. Pesan WeChat masuk dinormalisasi melalui kontrak channel, dirutekan ke agent OpenClaw yang dipilih, lalu dikirim kembali melalui jalur keluar Plugin.
Pemisahan itu penting: inti OpenClaw harus tetap channel-agnostik. Login WeChat, panggilan API Tencent iLink, unggah/unduh media, token konteks, dan pemantauan akun dimiliki oleh Plugin eksternal.

​
Pemasangan

Pemasangan cepat: 
npx -y @tencent-weixin/openclaw-weixin-cli install
Pemasangan manual: 
openclaw plugins install "@tencent-weixin/openclaw-weixin"
openclaw config set plugins.entries.openclaw-weixin.enabled true
Mulai ulang Gateway setelah pemasangan: 
openclaw gateway restart

​
Login

Jalankan login QR di mesin yang sama yang menjalankan Gateway: 
openclaw channels login --channel openclaw-weixin
Pindai kode QR dengan WeChat di ponsel Anda dan konfirmasikan login. Plugin menyimpan token akun secara lokal setelah pemindaian berhasil. Untuk menambahkan akun WeChat lain, jalankan lagi perintah login yang sama. Untuk banyak akun, isolasikan sesi pesan langsung berdasarkan akun, channel, dan pengirim: 
openclaw config set session.dmScope per-account-channel-peer

​
Kontrol akses

Pesan langsung menggunakan model pairing dan allowlist OpenClaw normal untuk Plugin channel. Setujui pengirim baru: 
openclaw pairing list openclaw-weixin
openclaw pairing approve openclaw-weixin <CODE>
Untuk model kontrol akses lengkap, lihat Pairing.

​
Kompatibilitas

Plugin memeriksa versi host OpenClaw saat startup.
Baris PluginVersi OpenClawTag npm
2.x>=2026.3.22latest
1.x>=2026.1.0 <2026.3.22legacy
Jika Plugin melaporkan bahwa versi OpenClaw Anda terlalu lama, perbarui OpenClaw atau pasang baris Plugin legacy: 
openclaw plugins install @tencent-weixin/openclaw-weixin@legacy

​
Proses sidecar

Plugin WeChat dapat menjalankan pekerjaan pembantu di samping Gateway saat memantau API Tencent iLink. Pada issue #68451, jalur pembantu itu memunculkan bug dalam pembersihan Gateway usang generik OpenClaw: proses anak dapat mencoba membersihkan proses Gateway induk, sehingga menyebabkan loop restart di bawah pengelola proses seperti systemd. Pembersihan startup OpenClaw saat ini mengecualikan proses saat ini dan leluhurnya, jadi pembantu channel tidak boleh mematikan Gateway yang meluncurkannya. Perbaikan ini bersifat generik; ini bukan jalur khusus WeChat di inti.

​
Pemecahan masalah

Periksa pemasangan dan status: 
openclaw plugins list
openclaw channels status --probe
openclaw --version
Jika channel ditampilkan sebagai terpasang tetapi tidak terhubung, pastikan Plugin diaktifkan lalu mulai ulang: 
openclaw config set plugins.entries.openclaw-weixin.enabled true
openclaw gateway restart
Jika Gateway berulang kali dimulai ulang setelah mengaktifkan WeChat, perbarui OpenClaw dan Plugin: 
npm view @tencent-weixin/openclaw-weixin version
openclaw plugins install "@tencent-weixin/openclaw-weixin" --force
openclaw gateway restart
Nonaktifkan sementara: 
openclaw config set plugins.entries.openclaw-weixin.enabled false
openclaw gateway restart

​
Dokumentasi terkait