WeChat

OpenClaw, Tencent'ın harici @tencent-weixin/openclaw-weixin kanal plugini aracılığıyla WeChat'e bağlanır.

Durum: Tencent Weixin ekibi tarafından sürdürülen harici plugin. Doğrudan sohbetler ve medya desteklenir. Grup sohbetleri, plugin yetenek meta verilerinde belirtilmez (yalnızca doğrudan sohbetleri beyan eder).

Adlandırma

• WeChat, bu belgelerde kullanıcıya gösterilen addır.
• Weixin, Tencent'ın paketi ve plugin kimliği tarafından kullanılan addır.
• openclaw-weixin, OpenClaw kanal kimliğidir (weixin ve wechat takma ad olarak çalışır).
• @tencent-weixin/openclaw-weixin, npm paketidir.

CLI komutlarında ve yapılandırma yollarında openclaw-weixin kullanın.

Nasıl çalışır?

WeChat kodu, OpenClaw çekirdek deposunda bulunmaz. OpenClaw genel kanal plugini sözleşmesini, harici plugin ise WeChat'e özgü çalışma zamanını sağlar:

1. openclaw plugins install, @tencent-weixin/openclaw-weixin paketini kurar.
2. Gateway, plugin manifestini keşfeder ve plugin giriş noktasını yükler.
3. Plugin, openclaw-weixin kanal kimliğini kaydeder.
4. openclaw channels login --channel openclaw-weixin, QR ile oturum açmayı başlatır.
5. Plugin, hesap kimlik bilgilerini OpenClaw durum dizininde (varsayılan olarak ~/.openclaw) saklar.
6. Gateway başlatıldığında plugin, yapılandırılmış her hesap için Weixin izleyicisini başlatır.
7. Gelen WeChat mesajları kanal sözleşmesi aracılığıyla normalleştirilir, seçilen OpenClaw aracısına yönlendirilir ve pluginin giden yolu üzerinden geri gönderilir.

Bu ayrım önemlidir: OpenClaw çekirdeği kanaldan bağımsız kalır. WeChat oturum açma işlemi, Tencent iLink API çağrıları, medya yükleme/indirme, bağlam tokenları ve hesap izleme harici plugin tarafından yönetilir.

Kurulum

Hızlı kurulum:

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

Manuel kurulum:

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

Kurulumdan sonra Gateway'i yeniden başlatın:

openclaw gateway restart

Oturum açma

QR ile oturum açma işlemini Gateway'in çalıştığı makinede yürütün:

openclaw channels login --channel openclaw-weixin

Telefonunuzdaki WeChat ile QR kodunu tarayın ve oturum açmayı onaylayın. Plugin, tarama başarıyla tamamlandıktan sonra hesap tokenını yerel olarak kaydeder.

Başka bir WeChat hesabı eklemek için aynı oturum açma komutunu yeniden çalıştırın. Birden fazla hesap için doğrudan mesaj oturumlarını hesaba, kanala ve gönderene göre yalıtın:

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

Erişim denetimi

Doğrudan mesajlar, kanal pluginleri için normal OpenClaw eşleştirme ve izin verilenler listesi modelini kullanır.

Yeni gönderenleri onaylayın:

openclaw pairing list openclaw-weixinopenclaw pairing approve openclaw-weixin <CODE>

Erişim denetimi modelinin tamamı için Eşleştirme bölümüne bakın.

Uyumluluk

Plugin, başlangıçta ana OpenClaw sürümünü denetler.

Plugin, OpenClaw sürümünüzün çok eski olduğunu bildirirse OpenClaw'u güncelleyin veya eski plugin serisini kurun:

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

Yardımcı süreç

WeChat plugini, Tencent iLink API'sini izlerken Gateway'in yanında yardımcı işler çalıştırabilir. #68451 numaralı sorunda bu yardımcı yol, OpenClaw'un genel eski Gateway temizleme işlemindeki bir hatayı ortaya çıkardı: bir alt süreç, üst Gateway sürecini temizlemeye çalışarak systemd gibi süreç yöneticileri altında yeniden başlatma döngülerine neden olabiliyordu.

Güncel OpenClaw başlangıç temizleme işlemi, mevcut süreci ve onun üst süreçlerini hariç tutar; böylece bir kanal yardımcısı, kendisini başlatan Gateway'i sonlandıramaz. Bu düzeltme geneldir; çekirdekte WeChat'e özgü bir yol değildir.

Sorun giderme

Kurulumu ve durumu denetleyin:

openclaw plugins listopenclaw channels status --probeopenclaw --version

Kanal kurulu görünmesine rağmen bağlanmıyorsa pluginin etkin olduğunu doğrulayın ve yeniden başlatın:

openclaw config set plugins.entries.openclaw-weixin.enabled trueopenclaw gateway restart

WeChat etkinleştirildikten sonra Gateway art arda yeniden başlatılıyorsa hem OpenClaw'u hem de plugini güncelleyin:

npm view @tencent-weixin/openclaw-weixin versionopenclaw plugins install "@tencent-weixin/openclaw-weixin" --forceopenclaw gateway restart

Başlangıç işlemi, kurulu plugin paketinin requires compiled runtime output for TypeScript entry olduğunu bildirirse npm paketi, OpenClaw'un ihtiyaç duyduğu derlenmiş JavaScript çalışma zamanı dosyaları olmadan yayımlanmıştır. Plugin yayıncısı düzeltilmiş bir paket yayımladıktan sonra güncelleyin/yeniden kurun veya plugini geçici olarak devre dışı bırakın/kaldırın.

Geçici olarak devre dışı bırakma:

openclaw config set plugins.entries.openclaw-weixin.enabled falseopenclaw gateway restart

İlgili belgeler

• Kanallara genel bakış: Sohbet Kanalları
• Eşleştirme: Eşleştirme
• Kanal yönlendirme: Kanal Yönlendirme
• Plugin mimarisi: Plugin Mimarisi
• Kanal plugini SDK'sı: Kanal Plugini SDK'sı
• Harici paket: @tencent-weixin/openclaw-weixin