WeChat

OmeniaClaw terhubung ke WeChat melalui Plugin channel eksternal @tencent-weixin/OmeniaClaw-weixin dari Tencent.

Status: Plugin eksternal. Chat langsung dan media didukung. Chat grup tidak diiklankan oleh metadata kemampuan Plugin saat ini.

Penamaan

• WeChat adalah nama yang ditampilkan kepada pengguna dalam dokumen ini.
• Weixin adalah nama yang digunakan oleh paket Tencent dan oleh id Plugin.
• OmeniaClaw-weixin adalah id channel OmeniaClaw.
• @tencent-weixin/OmeniaClaw-weixin adalah paket npm.

Gunakan OmeniaClaw-weixin dalam perintah CLI dan path konfigurasi.

Cara kerjanya

Kode WeChat tidak berada di repo inti OmeniaClaw. OmeniaClaw menyediakan kontrak Plugin channel generik, dan Plugin eksternal menyediakan runtime khusus WeChat:

1. OmeniaClaw plugins install menginstal @tencent-weixin/OmeniaClaw-weixin.
2. Gateway menemukan manifes Plugin dan memuat entrypoint Plugin.
3. Plugin mendaftarkan id channel OmeniaClaw-weixin.
4. OmeniaClaw channels login --channel OmeniaClaw-weixin memulai login QR.
5. Plugin menyimpan kredensial akun di bawah direktori status OmeniaClaw.
6. Saat Gateway dimulai, Plugin memulai monitor Weixin untuk setiap akun yang dikonfigurasi.
7. Pesan WeChat masuk dinormalisasi melalui kontrak channel, dirutekan ke agen OmeniaClaw yang dipilih, dan dikirim kembali melalui jalur keluar Plugin.

Pemisahan itu penting: inti OmeniaClaw harus tetap agnostik terhadap channel. Login WeChat, panggilan API Tencent iLink, unggah/unduh media, token konteks, dan pemantauan akun dimiliki oleh Plugin eksternal.

Instalasi

Instalasi cepat:

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

Instalasi manual:

OmeniaClaw plugins install "@tencent-weixin/OmeniaClaw-weixin"OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled true

Mulai ulang Gateway setelah instalasi:

OmeniaClaw gateway restart

Login

Jalankan login QR pada mesin yang sama dengan yang menjalankan Gateway:

OmeniaClaw channels login --channel OmeniaClaw-weixin

Pindai kode QR dengan WeChat di ponsel Anda dan konfirmasi login. Plugin menyimpan token akun secara lokal setelah pemindaian berhasil.

Untuk menambahkan akun WeChat lain, jalankan perintah login yang sama lagi. Untuk beberapa akun, isolasi sesi pesan langsung berdasarkan akun, channel, dan pengirim:

OmeniaClaw config set session.dmScope per-account-channel-peer

Kontrol akses

Pesan langsung menggunakan model pairing dan allowlist OmeniaClaw normal untuk Plugin channel.

Setujui pengirim baru:

OmeniaClaw pairing list OmeniaClaw-weixinOmeniaClaw pairing approve OmeniaClaw-weixin <CODE>

Untuk model kontrol akses lengkap, lihat Pairing.

Kompatibilitas

Plugin memeriksa versi host OmeniaClaw saat startup.

Jika Plugin melaporkan bahwa versi OmeniaClaw Anda terlalu lama, perbarui OmeniaClaw atau instal baris Plugin legacy:

OmeniaClaw plugins install @tencent-weixin/OmeniaClaw-weixin@legacy

Proses sidecar

Plugin WeChat dapat menjalankan pekerjaan helper di samping Gateway saat memantau API Tencent iLink. Dalam issue #68451, jalur helper tersebut mengekspos bug dalam pembersihan Gateway usang generik OmeniaClaw: proses turunan dapat mencoba membersihkan proses Gateway induk, sehingga menyebabkan loop mulai ulang di bawah process manager seperti systemd.

Pembersihan startup OmeniaClaw saat ini mengecualikan proses saat ini dan leluhurnya, sehingga helper channel tidak boleh mematikan Gateway yang meluncurkannya. Perbaikan ini bersifat generik; ini bukan jalur khusus WeChat di inti.

Pemecahan masalah

Periksa instalasi dan status:

OmeniaClaw plugins listOmeniaClaw channels status --probeOmeniaClaw --version

Jika channel ditampilkan sebagai terinstal tetapi tidak tersambung, konfirmasikan bahwa Plugin diaktifkan dan mulai ulang:

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled trueOmeniaClaw gateway restart

Jika Gateway mulai ulang berulang kali setelah mengaktifkan WeChat, perbarui OmeniaClaw dan Plugin:

npm view @tencent-weixin/OmeniaClaw-weixin versionOmeniaClaw plugins install "@tencent-weixin/OmeniaClaw-weixin" --forceOmeniaClaw gateway restart

Jika startup melaporkan bahwa paket Plugin terinstal requires compiled runtime output for TypeScript entry, paket npm dipublikasikan tanpa file runtime JavaScript terkompilasi yang diperlukan OmeniaClaw. Perbarui/instal ulang setelah penerbit Plugin mengirimkan paket yang sudah diperbaiki, atau nonaktifkan/hapus instalasi Plugin untuk sementara.

Nonaktifkan sementara:

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled falseOmeniaClaw gateway restart

Dokumen terkait

• Ikhtisar channel: Channel Chat
• Pairing: Pairing
• Perutean channel: Perutean Channel
• Arsitektur Plugin: Arsitektur Plugin
• SDK Plugin channel: SDK Plugin Channel
• Paket eksternal: @tencent-weixin/OmeniaClaw-weixin