OpenClawDocs
Bu sayfada

Bu sayfada

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Bölgesel platformlar

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:

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

Manuel kurulum:

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

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

bash
openclaw gateway restart

Oturum açma

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

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

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

bash
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 serisi OpenClaw sürümü npm etiketi
2.x >=2026.5.12 (güncel 2.4.6; ilk 2.x sürümleri >=2026.3.22 kabul ediyordu) latest
1.x >=2026.1.0 <2026.3.22 legacy

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

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

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

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

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

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

İlgili belgeler

Was this useful?