WeChat

OpenClaw, Tencent'in harici @tencent-weixin/openclaw-weixin kanal Plugin'i üzerinden 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 bildirir).

Adlandırma

• WeChat, bu belgelerde kullanıcıya gösterilen addır.
• Weixin, Tencent paketinde ve Plugin kimliğinde 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 yer almaz. OpenClaw genel kanal Plugin sözleşmesini, harici Plugin ise WeChat'e özgü çalışma zamanını sağlar:

1. openclaw plugins install, @tencent-weixin/openclaw-weixin paketini yükler.
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 kodla oturum açma işlemini başlatır.
5. Plugin, hesap kimlik bilgilerini OpenClaw durum dizininde (varsayılan olarak ~/.openclaw) saklar.
6. Gateway başladığında Plugin, yapılandırılmış her hesap için Weixin izleyicisini başlatır.
7. Gelen WeChat mesajları kanal sözleşmesi üzerinden normalleştirilir, seçilen OpenClaw aracısına yönlendirilir ve Plugin'in giden ileti 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 belirteçleri ve hesap izleme harici Plugin'in sorumluluğundadır.

Yükleme

Hızlı yükleme:

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

Elle yükleme:

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

Yüklemeden sonra Gateway'i yeniden başlatın:

openclaw gateway restart

Oturum açma

QR kodla oturum açma işlemini Gateway'in çalıştığı makinede başlatın:

openclaw channels login --channel openclaw-weixin

Telefonunuzdaki WeChat ile QR kodu tarayın ve oturum açma işlemini onaylayın. Başarılı bir taramanın ardından Plugin, hesap belirtecini 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ı hesap, kanal ve gönderene göre yalıtın:

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

Erişim denetimi

Doğrudan mesajlar, kanal Plugin'leri için standart OpenClaw eşleştirme ve izin 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 sistemdeki 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 yükleyin:

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

Yardımcı süreç

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

OpenClaw'un mevcut başlangıç temizliği, geçerli 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

Yüklemeyi ve durumu denetleyin:

openclaw plugins listopenclaw channels status --probeopenclaw --version

Kanal yüklü görünmesine rağmen bağlanmıyorsa Plugin'in 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 sürekli yeniden başlıyorsa hem OpenClaw'u hem de Plugin'i güncelleyin:

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

Başlangıç sırasında yüklü Plugin paketinin requires compiled runtime output for TypeScript entry gerektirdiği bildirilirse 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 yükleyin veya Plugin'i 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 Plugin SDK'sı: Kanal Plugin SDK'sı
• Harici paket: @tencent-weixin/openclaw-weixin