WeChat

OmeniaClaw, WeChat'e Tencent'in harici @tencent-weixin/OmeniaClaw-weixin kanal Plugin'i üzerinden bağlanır.

Durum: harici Plugin. Doğrudan sohbetler ve medya desteklenir. Grup sohbetleri mevcut Plugin yetenek meta verileri tarafından duyurulmaz.

Adlandırma

• WeChat, bu belgelerde kullanıcıya gösterilen addır.
• Weixin, Tencent paketinin ve Plugin kimliğinin kullandığı addır.
• OmeniaClaw-weixin, OmeniaClaw kanal kimliğidir.
• @tencent-weixin/OmeniaClaw-weixin, npm paketidir.

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

Nasıl çalışır

WeChat kodu OmeniaClaw çekirdek deposunda yer almaz. OmeniaClaw genel kanal Plugin sözleşmesini sağlar, harici Plugin ise WeChat'e özgü çalışma zamanını sağlar:

1. OmeniaClaw plugins install, @tencent-weixin/OmeniaClaw-weixin paketini kurar.
2. Gateway, Plugin manifestini keşfeder ve Plugin giriş noktasını yükler.
3. Plugin, OmeniaClaw-weixin kanal kimliğini kaydeder.
4. OmeniaClaw channels login --channel OmeniaClaw-weixin, QR ile oturum açmayı başlatır.
5. Plugin, hesap kimlik bilgilerini OmeniaClaw durum dizini altında depolar.
6. Gateway başladığında Plugin, yapılandırılmış her hesap için Weixin izleyicisini başlatır.
7. Gelen WeChat iletileri kanal sözleşmesi üzerinden normalleştirilir, seçilen OmeniaClaw aracısına yönlendirilir ve Plugin'in giden yolu üzerinden geri gönderilir.

Bu ayrım önemlidir: OmeniaClaw çekirdeği kanaldan bağımsız kalmalıdır. WeChat oturum açma, Tencent iLink API çağrıları, medya yükleme/indirme, bağlam belirteçleri ve hesap izleme harici Plugin'in sorumluluğundadır.

Kurulum

Hızlı kurulum:

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

Elle kurulum:

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

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

OmeniaClaw gateway restart

Oturum açma

QR ile oturum açmayı Gateway'in çalıştığı aynı makinede çalıştırın:

OmeniaClaw channels login --channel OmeniaClaw-weixin

QR kodunu telefonunuzdaki WeChat ile tarayın ve oturum açmayı onaylayın. Başarılı bir taramadan sonra 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 çok hesap için doğrudan ileti oturumlarını hesaba, kanala ve gönderene göre yalıtın:

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

Erişim denetimi

Doğrudan iletiler, kanal Plugin'leri için normal OmeniaClaw eşleştirme ve izin listesi modelini kullanır.

Yeni gönderenleri onaylayın:

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

Tam erişim denetimi modeli için bkz. Eşleştirme.

Uyumluluk

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

Plugin, OmeniaClaw sürümünüzün çok eski olduğunu bildirirse OmeniaClaw'u güncelleyin veya eski Plugin hattını kurun:

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

Yan süreç

WeChat Plugin'i, Tencent iLink API'yi izlerken yardımcı işi Gateway'in yanında çalıştırabilir. #68451 numaralı sorunda bu yardımcı yol, OmeniaClaw'un genel eski Gateway temizliğinde bir hatayı ortaya çı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.

Geçerli OmeniaClaw başlangıç temizliği mevcut süreci ve onun üst süreçlerini hariç tutar; bu nedenle bir kanal yardımcısı, kendisini başlatan Gateway'i sonlandırmamalıdır. Bu düzeltme geneldir; çekirdekte WeChat'e özgü bir yol değildir.

Sorun giderme

Kurulumu ve durumu denetleyin:

OmeniaClaw plugins listOmeniaClaw channels status --probeOmeniaClaw --version

Kanal kurulu görünüyor ancak bağlanmıyorsa Plugin'in etkin olduğunu doğrulayın ve yeniden başlatın:

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

WeChat etkinleştirildikten sonra Gateway tekrar tekrar yeniden başlıyorsa hem OmeniaClaw'u hem de Plugin'i güncelleyin:

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

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

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

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

İlgili belgeler

• Kanal 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/OmeniaClaw-weixin