Skip to main content
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:
Manuel kurulum:
Kurulumdan sonra Gateway’i yeniden başlatın:

​
Oturum açma

QR ile oturum açma işlemini Gateway’in çalıştığı makinede yürütün:
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:

​
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:
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:

​
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:
Kanal kurulu görünmesine rağmen bağlanmıyorsa pluginin etkin olduğunu doğrulayın ve yeniden başlatın:
WeChat etkinleştirildikten sonra Gateway art arda yeniden başlatılıyorsa hem OpenClaw’u hem de plugini güncelleyin:
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:

​
İlgili belgeler