English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Regional platforms

WeChat

OpenClaw łączy się z WeChat przez zewnętrzny Plugin kanału Tencent @tencent-weixin/openclaw-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.
  • openclaw-weixin to identyfikator kanału OpenClaw.
  • @tencent-weixin/openclaw-weixin to pakiet npm.

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

Jak to działa

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

  1. openclaw plugins install instaluje @tencent-weixin/openclaw-weixin.
  2. Gateway wykrywa manifest Plugin i ładuje punkt wejścia Plugin.
  3. Plugin rejestruje identyfikator kanału openclaw-weixin.
  4. openclaw channels login --channel openclaw-weixin uruchamia logowanie QR.
  5. Plugin przechowuje poświadczenia konta w katalogu stanu OpenClaw.
  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 OpenClaw i odsyłane przez ścieżkę wychodzącą Plugin.

To rozdzielenie ma znaczenie: rdzeń OpenClaw 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/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 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 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:

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

Kontrola dostępu

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

Zatwierdź nowych nadawców:

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

Pełny model kontroli dostępu opisuje Parowanie.

Zgodność

Plugin sprawdza wersję hosta OpenClaw podczas uruchamiania.

Linia Plugin Wersja OpenClaw tag npm
2.x >=2026.3.22 latest
1.x >=2026.1.0 <2026.3.22 legacy

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

openclaw plugins install @tencent-weixin/openclaw-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 OpenClaw: 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 OpenClaw 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:

openclaw plugins list
openclaw channels status --probe
openclaw --version

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

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

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

npm view @tencent-weixin/openclaw-weixin version
openclaw plugins install "@tencent-weixin/openclaw-weixin" --force
openclaw 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 OpenClaw. Zaktualizuj/zainstaluj ponownie po tym, jak wydawca Plugin opublikuje poprawiony pakiet, albo tymczasowo wyłącz/odinstaluj Plugin.

Tymczasowe wyłączenie:

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

Powiązana dokumentacja