WeChat

OpenClaw łączy się z WeChat za pośrednictwem zewnętrznego pluginu kanału Tencent @tencent-weixin/openclaw-weixin.

Status: plugin zewnętrzny, utrzymywany przez zespół Tencent Weixin. Obsługiwane są czaty bezpośrednie i multimedia. Czaty grupowe nie są deklarowane w metadanych możliwości pluginu (plugin deklaruje wyłącznie czaty bezpośrednie).

Nazewnictwo

• WeChat to nazwa widoczna dla użytkownika w tej dokumentacji.
• Weixin to nazwa używana w pakiecie Tencent oraz w identyfikatorze pluginu.
• openclaw-weixin to identyfikator kanału OpenClaw (weixin i wechat działają jako aliasy).
• @tencent-weixin/openclaw-weixin to pakiet npm.

W poleceniach CLI i ścieżkach konfiguracji używaj openclaw-weixin.

Jak to działa

Kod WeChat nie znajduje się w głównym repozytorium OpenClaw. OpenClaw udostępnia ogólny kontrakt pluginu kanału, a zewnętrzny plugin zapewnia środowisko wykonawcze specyficzne dla WeChat:

1. openclaw plugins install instaluje @tencent-weixin/openclaw-weixin.
2. Gateway wykrywa manifest pluginu i ładuje jego punkt wejścia.
3. Plugin rejestruje identyfikator kanału openclaw-weixin.
4. openclaw channels login --channel openclaw-weixin rozpoczyna logowanie za pomocą kodu QR.
5. Plugin przechowuje dane uwierzytelniające konta w katalogu stanu OpenClaw (domyślnie ~/.openclaw).
6. Po uruchomieniu Gateway plugin uruchamia monitor Weixin dla każdego skonfigurowanego konta.
7. Przychodzące wiadomości WeChat są normalizowane zgodnie z kontraktem kanału, kierowane do wybranego agenta OpenClaw, a odpowiedzi są wysyłane ścieżką wychodzącą pluginu.

Ten podział ma znaczenie: rdzeń OpenClaw pozostaje niezależny od kanałów. Za logowanie do WeChat, wywołania interfejsu API Tencent iLink, wysyłanie i pobieranie multimediów, tokeny kontekstu oraz monitorowanie kont odpowiada zewnętrzny plugin.

Instalacja

Szybka instalacja:

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

Instalacja ręczna:

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

Po instalacji uruchom ponownie Gateway:

openclaw gateway restart

Logowanie

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

openclaw channels login --channel openclaw-weixin

Zeskanuj kod QR za pomocą WeChat na telefonie i potwierdź logowanie. Po pomyślnym zeskanowaniu plugin zapisze lokalnie token konta.

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

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

Kontrola dostępu

Wiadomości bezpośrednie korzystają ze standardowego dla pluginów kanałów modelu parowania i listy dozwolonych OpenClaw.

Zatwierdzaj nowych nadawców:

openclaw pairing list openclaw-weixinopenclaw pairing approve openclaw-weixin <CODE>

Pełny opis modelu kontroli dostępu zawiera sekcja Parowanie.

Zgodność

Plugin podczas uruchamiania sprawdza wersję hosta OpenClaw.

Jeśli plugin zgłasza, że używana wersja OpenClaw jest zbyt stara, zaktualizuj OpenClaw albo zainstaluj starszą linię pluginu:

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

Proces pomocniczy

Plugin WeChat może uruchamiać procesy pomocnicze obok Gateway podczas monitorowania interfejsu API Tencent iLink. W zgłoszeniu nr 68451 ta ścieżka pomocnicza ujawniła błąd w ogólnym mechanizmie usuwania nieaktualnych procesów Gateway w OpenClaw: proces potomny mógł próbować usunąć nadrzędny proces Gateway, powodując pętle ponownego uruchamiania pod nadzorem menedżerów procesów, takich jak systemd.

Obecny mechanizm porządkowania podczas uruchamiania OpenClaw wyklucza bieżący proces i jego procesy nadrzędne, dzięki czemu proces pomocniczy kanału nie może zakończyć Gateway, który go uruchomił. Ta poprawka jest ogólna; nie stanowi ścieżki specyficznej dla WeChat w rdzeniu.

Rozwiązywanie problemów

Sprawdź instalację i stan:

openclaw plugins listopenclaw channels status --probeopenclaw --version

Jeśli kanał jest oznaczony jako zainstalowany, ale nie nawiązuje połączenia, upewnij się, że plugin jest włączony, i uruchom ponownie Gateway:

openclaw config set plugins.entries.openclaw-weixin.enabled trueopenclaw gateway restart

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

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

Jeśli podczas uruchamiania pojawia się komunikat, że zainstalowany pakiet pluginu requires compiled runtime output for TypeScript entry, pakiet npm opublikowano bez skompilowanych plików środowiska wykonawczego JavaScript wymaganych przez OpenClaw. Zaktualizuj lub ponownie zainstaluj plugin po opublikowaniu poprawionego pakietu przez jego wydawcę albo tymczasowo wyłącz lub odinstaluj plugin.

Tymczasowe wyłączenie:

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

Powiązana dokumentacja

• Omówienie kanałów: Kanały czatu
• Parowanie: Parowanie
• Kierowanie kanałów: Kierowanie kanałów
• Architektura pluginów: Architektura pluginów
• SDK pluginów kanałów: SDK pluginów kanałów
• Pakiet zewnętrzny: @tencent-weixin/openclaw-weixin