Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
openclaw channels

Zarządzaj kontami kanałów czatu i ich stanem działania w Gateway. Powiązana dokumentacja:

​
Typowe polecenia

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:<voice-channel-id>
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 <name>, --probe, --timeout <ms>, --json
  • channels capabilities: --channel <name>, --account <id> (tylko z --channel), --target <dest>, --timeout <ms>, --json
  • channels resolve: <entries...>, --channel <name>, --account <id>, --kind <auto|user|group>, --json
  • channels logs: --channel <name|all>, --lines <n>, --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

openclaw channels add --channel telegram --token <bot-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). 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.<channel>.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)

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: 
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:<id> 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: 
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 <name> przed rozwiązywaniem nazw dla kanału z katalogu możliwego do zainstalowania.

​
Powiązane