> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} npx -y @tencent-weixin/openclaw-weixin-cli install ``` Instalacja ręczna: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw plugins install "@tencent-weixin/openclaw-weixin" openclaw config set plugins.entries.openclaw-weixin.enabled true ``` Po instalacji uruchom ponownie Gateway: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw gateway restart ``` ## Logowanie Uruchom logowanie QR na tej samej maszynie, na której działa Gateway: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw pairing list openclaw-weixin openclaw pairing approve openclaw-weixin ``` Pełny model kontroli dostępu opisuje [Parowanie](/pl/channels/pairing). ## 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw config set plugins.entries.openclaw-weixin.enabled false openclaw gateway restart ``` ## Powiązana dokumentacja * Omówienie kanałów: [Kanały czatu](/pl/channels) * Parowanie: [Parowanie](/pl/channels/pairing) * Routing kanałów: [Routing kanałów](/pl/channels/channel-routing) * Architektura Plugin: [Architektura Plugin](/pl/plugins/architecture) * SDK Plugin kanału: [SDK Plugin kanału](/pl/plugins/sdk-channel-plugins) * Pakiet zewnętrzny: [@tencent-weixin/openclaw-weixin](https://www.npmjs.com/package/@tencent-weixin/openclaw-weixin)