WeChat

OmeniaClaw łączy się z WeChat przez zewnętrzny Plugin kanału Tencent @tencent-weixin/OmeniaClaw-weixin.

Status: zewnętrzny Plugin. Czaty bezpośrednie i multimedia są obsługiwane. Czaty grupowe nie są ogłaszane przez bieżące metadane możliwości Plugin.

Nazewnictwo

• WeChat to nazwa widoczna dla użytkownika w tej dokumentacji.
• Weixin to nazwa używana przez pakiet Tencent i przez identyfikator Plugin.
• OmeniaClaw-weixin to identyfikator kanału OmeniaClaw.
• @tencent-weixin/OmeniaClaw-weixin to pakiet npm.

Używaj OmeniaClaw-weixin w poleceniach CLI i ścieżkach konfiguracji.

Jak to działa

Kod WeChat nie znajduje się w głównym repozytorium OmeniaClaw. OmeniaClaw udostępnia ogólny kontrakt Plugin kanału, a zewnętrzny Plugin udostępnia środowisko uruchomieniowe specyficzne dla WeChat:

1. OmeniaClaw plugins install instaluje @tencent-weixin/OmeniaClaw-weixin.
2. Gateway wykrywa manifest Plugin i ładuje punkt wejścia Plugin.
3. Plugin rejestruje identyfikator kanału OmeniaClaw-weixin.
4. OmeniaClaw channels login --channel OmeniaClaw-weixin uruchamia logowanie QR.
5. Plugin przechowuje poświadczenia konta w katalogu stanu OmeniaClaw.
6. Gdy Gateway się uruchamia, Plugin uruchamia monitor Weixin dla każdego skonfigurowanego konta.
7. Przychodzące wiadomości WeChat są normalizowane przez kontrakt kanału, kierowane do wybranego agenta OmeniaClaw i odsyłane przez ścieżkę wychodzącą Plugin.

To rozdzielenie ma znaczenie: rdzeń OmeniaClaw powinien pozostać niezależny od kanałów. Logowanie WeChat, wywołania API Tencent iLink, przesyłanie/pobieranie multimediów, tokeny kontekstu i monitorowanie kont są własnością zewnętrznego Plugin.

Instalacja

Szybka instalacja:

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

Instalacja ręczna:

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

Po instalacji uruchom ponownie Gateway:

OmeniaClaw gateway restart

Logowanie

Uruchom logowanie QR na tej samej maszynie, na której działa Gateway:

OmeniaClaw channels login --channel OmeniaClaw-weixin

Zeskanuj kod QR za pomocą WeChat na telefonie i potwierdź logowanie. Po udanym skanowaniu Plugin zapisuje token konta lokalnie.

Aby dodać kolejne konto WeChat, uruchom ponownie to samo polecenie logowania. Dla wielu kont izoluj sesje wiadomości bezpośrednich według konta, kanału i nadawcy:

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

Kontrola dostępu

Wiadomości bezpośrednie używają standardowego modelu parowania i listy dozwolonych OmeniaClaw dla Plugin kanałów.

Zatwierdź nowych nadawców:

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

Pełny model kontroli dostępu opisuje Parowanie.

Zgodność

Plugin sprawdza wersję hosta OmeniaClaw podczas uruchamiania.

Jeśli Plugin zgłasza, że Twoja wersja OmeniaClaw jest zbyt stara, zaktualizuj OmeniaClaw albo zainstaluj starszą linię Plugin:

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

Proces sidecar

Plugin WeChat może uruchamiać pracę pomocniczą obok Gateway podczas monitorowania API Tencent iLink. W zgłoszeniu #68451 ta ścieżka pomocnicza ujawniła błąd w ogólnym czyszczeniu nieaktualnych procesów Gateway w OmeniaClaw: proces podrzędny mógł próbować wyczyścić nadrzędny proces Gateway, powodując pętle ponownego uruchamiania pod menedżerami procesów takimi jak systemd.

Bieżące czyszczenie przy starcie OmeniaClaw wyklucza bieżący proces i jego przodków, więc pomocnik kanału nie może zabić Gateway, który go uruchomił. Ta poprawka jest ogólna; w rdzeniu nie jest to ścieżka specyficzna dla WeChat.

Rozwiązywanie problemów

Sprawdź instalację i status:

OmeniaClaw plugins listOmeniaClaw channels status --probeOmeniaClaw --version

Jeśli kanał jest widoczny jako zainstalowany, ale się nie łączy, potwierdź, że Plugin jest włączony, i uruchom ponownie:

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

Jeśli Gateway uruchamia się ponownie wielokrotnie po włączeniu WeChat, zaktualizuj zarówno OmeniaClaw, jak i Plugin:

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

Jeśli podczas startu pojawia się komunikat, że zainstalowany pakiet Plugin requires compiled runtime output for TypeScript entry, pakiet npm został opublikowany bez skompilowanych plików środowiska uruchomieniowego JavaScript wymaganych przez OmeniaClaw. Zaktualizuj/zainstaluj ponownie po tym, jak wydawca Plugin opublikuje poprawiony pakiet, albo tymczasowo wyłącz/odinstaluj Plugin.

Tymczasowe wyłączenie:

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

Powiązana dokumentacja

• Omówienie kanałów: Kanały czatu
• Parowanie: Parowanie
• Routing kanałów: Routing kanałów
• Architektura Plugin: Architektura Plugin
• SDK Plugin kanału: SDK Plugin kanału
• Pakiet zewnętrzny: @tencent-weixin/OmeniaClaw-weixin