--- read_when: - Chcesz dodać/usunąć konta kanałów (WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (Plugin)/Signal/iMessage/Matrix) - Chcesz sprawdzić stan kanału lub śledzić dzienniki kanału summary: Dokumentacja referencyjna CLI dla `openclaw channels` (konta, status, logowanie/wylogowanie, logi) title: Kanały x-i18n: generated_at: "2026-05-11T20:25:45Z" model: gpt-5.5 provider: openai source_hash: 58a964b4db9526defab6ee47b7a99c11086e345d42c8d20f5262fc134337947f source_path: cli/channels.md workflow: 16 --- # `openclaw channels` Zarządzaj kontami kanałów czatu i ich stanem działania w Gateway. Powiązana dokumentacja: - Przewodniki po kanałach: [Kanały](/pl/channels) - Konfiguracja Gateway: [Konfiguracja](/pl/gateway/configuration) ## Typowe polecenia ```bash openclaw channels list openclaw channels list --all openclaw channels status openclaw channels capabilities openclaw channels capabilities --channel discord --target channel:123 openclaw channels capabilities --channel discord --target channel: openclaw channels resolve --channel slack "#general" "@jane" openclaw channels logs --channel all ``` `channels list` pokazuje tylko kanały czatu: domyślnie skonfigurowane konta, ze znacznikami stanu `installed`, `configured` i `enabled` dla każdego konta. Przekaż `--all`, aby pokazać także dołączone kanały, które nie mają jeszcze skonfigurowanego konta, oraz kanały z katalogu możliwe do zainstalowania, których nie ma jeszcze na dysku. Dostawcy uwierzytelniania (OAuth + klucze API) oraz migawki użycia/limitów dostawców modeli nie są już tutaj drukowane; użyj `openclaw models auth list` dla profili uwierzytelniania dostawców oraz `openclaw status` lub `openclaw models list` dla użycia. ## Stan / możliwości / rozwiązywanie / logi - `channels status`: `--channel `, `--probe`, `--timeout `, `--json` - `channels capabilities`: `--channel `, `--account ` (tylko z `--channel`), `--target `, `--timeout `, `--json` - `channels resolve`: ``, `--channel `, `--account `, `--kind `, `--json` - `channels logs`: `--channel `, `--lines `, `--json` `channels status --probe` to ścieżka na żywo: na osiągalnym Gateway uruchamia dla każdego konta kontrole `probeAccount` i opcjonalne `auditAccount`, więc dane wyjściowe mogą obejmować stan transportu oraz wyniki sondowania, takie jak `works`, `probe failed`, `audit ok` lub `audit failed`. Jeśli Gateway jest nieosiągalny, `channels status` przełącza się na podsumowania tylko z konfiguracji zamiast danych wyjściowych sondowania na żywo. Nie używaj `openclaw sessions`, Gateway `sessions.list` ani narzędzia agenta `sessions_list` jako sygnału kondycji gniazda kanału. Te powierzchnie raportują zapisane wiersze konwersacji, a nie stan działania dostawcy. Po ponownym uruchomieniu dostawcy Discord połączone, ale ciche konto może być zdrowe, mimo że żaden wiersz sesji Discord nie pojawi się do następnego przychodzącego lub wychodzącego zdarzenia konwersacji. ## Dodawanie / usuwanie kont ```bash openclaw channels add --channel telegram --token openclaw channels add --channel nostr --private-key "$NOSTR_PRIVATE_KEY" openclaw channels remove --channel telegram --delete ``` `openclaw channels add --help` pokazuje flagi dla poszczególnych kanałów (token, klucz prywatny, token aplikacji, ścieżki signal-cli itd.). `channels remove` działa tylko na zainstalowanych/skonfigurowanych pluginach kanałów. Dla kanałów z katalogu możliwych do zainstalowania najpierw użyj `channels add`. W przypadku pluginów kanałów opartych na runtime `channels remove` prosi także działający Gateway o zatrzymanie wybranego konta przed aktualizacją konfiguracji, więc wyłączenie lub usunięcie konta nie pozostawia starego nasłuchiwacza aktywnego do restartu. Typowe nieinteraktywne powierzchnie dodawania obejmują: - kanały z tokenem bota: `--token`, `--bot-token`, `--app-token`, `--token-file` - pola transportu Signal/iMessage: `--signal-number`, `--cli-path`, `--http-url`, `--http-host`, `--http-port`, `--db-path`, `--service`, `--region` - pola Google Chat: `--webhook-path`, `--webhook-url`, `--audience-type`, `--audience` - pola Matrix: `--homeserver`, `--user-id`, `--access-token`, `--password`, `--device-name`, `--initial-sync-limit` - pola Nostr: `--private-key`, `--relay-urls` - pola Tlon: `--ship`, `--url`, `--code`, `--group-channels`, `--dm-allowlist`, `--auto-discover-channels` - `--use-env` dla uwierzytelniania domyślnego konta opartego na zmiennych środowiskowych tam, gdzie jest obsługiwane Jeśli plugin kanału musi zostać zainstalowany podczas polecenia dodawania sterowanego flagami, OpenClaw używa domyślnego źródła instalacji kanału bez otwierania interaktywnego monitu instalacji pluginu. Gdy uruchomisz `openclaw channels add` bez flag, interaktywny kreator może poprosić o: - identyfikatory kont dla każdego wybranego kanału - opcjonalne nazwy wyświetlane dla tych kont - `Route these channel accounts to agents now?` Jeśli potwierdzisz powiązanie teraz, kreator zapyta, który agent powinien być właścicielem każdego skonfigurowanego konta kanału, i zapisze powiązania routingu w zakresie kont. Tymi samymi regułami routingu możesz też zarządzać później za pomocą `openclaw agents bindings`, `openclaw agents bind` i `openclaw agents unbind` (zobacz [agenci](/pl/cli/agents)). Gdy dodajesz niedomyślne konto do kanału, który nadal używa ustawień najwyższego poziomu dla pojedynczego konta, OpenClaw promuje wartości najwyższego poziomu o zakresie konta do mapy kont kanału przed zapisaniem nowego konta. Większość kanałów umieszcza te wartości w `channels..accounts.default`, ale dołączone kanały mogą zamiast tego zachować istniejące pasujące promowane konto. Matrix jest bieżącym przykładem: jeśli istnieje już jedno nazwane konto albo `defaultAccount` wskazuje na istniejące nazwane konto, promocja zachowuje to konto zamiast tworzyć nowe `accounts.default`. Zachowanie routingu pozostaje spójne: - Istniejące powiązania tylko z kanałem (bez `accountId`) nadal pasują do domyślnego konta. - `channels add` nie tworzy automatycznie ani nie przepisuje powiązań w trybie nieinteraktywnym. - Interaktywna konfiguracja może opcjonalnie dodać powiązania w zakresie konta. Jeśli konfiguracja była już w stanie mieszanym (obecne nazwane konta i nadal ustawione wartości najwyższego poziomu dla pojedynczego konta), uruchom `openclaw doctor --fix`, aby przenieść wartości w zakresie konta do promowanego konta wybranego dla tego kanału. Większość kanałów promuje do `accounts.default`; Matrix może zamiast tego zachować istniejący nazwany/domyślny cel. ## Logowanie i wylogowanie (interaktywne) ```bash openclaw channels login --channel whatsapp openclaw channels logout --channel whatsapp ``` - `channels login` obsługuje `--verbose`. - `channels login` i `logout` mogą wywnioskować kanał, gdy skonfigurowany jest tylko jeden obsługiwany cel logowania. - `channels logout` preferuje ścieżkę Gateway na żywo, gdy jest osiągalna, więc wylogowanie zatrzymuje każdy aktywny nasłuchiwacz przed wyczyszczeniem stanu uwierzytelniania kanału. Jeśli lokalny Gateway nie jest osiągalny, przełącza się na lokalne czyszczenie uwierzytelniania. - Uruchamiaj `channels login` z terminala na hoście gateway. Agent `exec` blokuje ten interaktywny przepływ logowania; natywne narzędzia logowania agenta dla kanału, takie jak `whatsapp_login`, powinny być używane z czatu, gdy są dostępne. ## Rozwiązywanie problemów - Uruchom `openclaw status --deep`, aby wykonać szerokie sondowanie. - Użyj `openclaw doctor` do prowadzonych napraw. - `openclaw channels list` nie drukuje już migawek użycia/limitów dostawców modeli. Do tego użyj `openclaw status` (przegląd) lub `openclaw models list` (dla każdego dostawcy). - `openclaw channels status` przełącza się na podsumowania tylko z konfiguracji, gdy gateway jest nieosiągalny. Jeśli poświadczenie obsługiwanego kanału jest skonfigurowane przez SecretRef, ale niedostępne w bieżącej ścieżce polecenia, raportuje to konto jako skonfigurowane z notatkami o degradacji zamiast pokazywać je jako nieskonfigurowane. ## Sondowanie możliwości Pobierz wskazówki dotyczące możliwości dostawcy (intencje/zakresy tam, gdzie są dostępne) oraz statyczną obsługę funkcji: ```bash openclaw channels capabilities openclaw channels capabilities --channel discord --target channel:123 ``` Uwagi: - `--channel` jest opcjonalne; pomiń je, aby wyświetlić każdy kanał (w tym rozszerzenia). - `--account` jest poprawne tylko z `--channel`. - `--target` akceptuje `channel:` lub surowy numeryczny identyfikator kanału i dotyczy tylko Discord. Dla kanałów głosowych Discord kontrola uprawnień oznacza brakujące `ViewChannel`, `Connect`, `Speak`, `SendMessages` i `ReadMessageHistory`. - Sondy są specyficzne dla dostawcy: intencje Discord + opcjonalne uprawnienia kanału; zakresy bota i użytkownika Slack; flagi bota Telegram + webhook; wersja demona Signal; token aplikacji Microsoft Teams + role/zakresy Graph (opisane tam, gdzie znane). Kanały bez sond raportują `Probe: unavailable`. ## Rozwiązywanie nazw na identyfikatory Rozwiązuj nazwy kanałów/użytkowników na identyfikatory, używając katalogu dostawcy: ```bash openclaw channels resolve --channel slack "#general" "@jane" openclaw channels resolve --channel discord "My Server/#support" "@someone" openclaw channels resolve --channel matrix "Project Room" ``` Uwagi: - Użyj `--kind user|group|auto`, aby wymusić typ celu. - Rozwiązywanie preferuje aktywne dopasowania, gdy wiele wpisów ma tę samą nazwę. - `channels resolve` jest tylko do odczytu. Jeśli wybrane konto jest skonfigurowane przez SecretRef, ale to poświadczenie jest niedostępne w bieżącej ścieżce polecenia, polecenie zwraca zdegradowane nierozwiązane wyniki z notatkami zamiast przerywać całe uruchomienie. - `channels resolve` nie instaluje pluginów kanałów. Użyj `channels add --channel ` przed rozwiązywaniem nazw dla kanału z katalogu możliwego do zainstalowania. ## Powiązane - [Dokumentacja CLI](/pl/cli) - [Przegląd kanałów](/pl/channels)