OmeniaClaw channels

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

Powiązana dokumentacja:

• Przewodniki po kanałach: Kanały
• Konfiguracja Gateway: Konfiguracja

Typowe polecenia

OmeniaClaw channels listOmeniaClaw channels list --allOmeniaClaw channels statusOmeniaClaw channels capabilitiesOmeniaClaw channels capabilities --channel discord --target channel:123OmeniaClaw channels capabilities --channel discord --target channel:<voice-channel-id>OmeniaClaw channels resolve --channel slack "#general" "@jane"OmeniaClaw 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 OmeniaClaw models auth list dla profili uwierzytelniania dostawców oraz OmeniaClaw status lub OmeniaClaw 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 OmeniaClaw 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

OmeniaClaw channels add --channel telegram --token <bot-token>OmeniaClaw channels add --channel nostr --private-key "$NOSTR_PRIVATE_KEY"OmeniaClaw channels remove --channel telegram --delete

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, OmeniaClaw używa domyślnego źródła instalacji kanału bez otwierania interaktywnego monitu instalacji pluginu.

Gdy uruchomisz OmeniaClaw 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ą OmeniaClaw agents bindings, OmeniaClaw agents bind i OmeniaClaw agents unbind (zobacz agenci).

Gdy dodajesz niedomyślne konto do kanału, który nadal używa ustawień najwyższego poziomu dla pojedynczego konta, OmeniaClaw 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 OmeniaClaw 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)

OmeniaClaw channels login --channel whatsappOmeniaClaw 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 OmeniaClaw status --deep, aby wykonać szerokie sondowanie.
• Użyj OmeniaClaw doctor do prowadzonych napraw.
• OmeniaClaw channels list nie drukuje już migawek użycia/limitów dostawców modeli. Do tego użyj OmeniaClaw status (przegląd) lub OmeniaClaw models list (dla każdego dostawcy).
• OmeniaClaw 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:

OmeniaClaw channels capabilitiesOmeniaClaw 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:

OmeniaClaw channels resolve --channel slack "#general" "@jane"OmeniaClaw channels resolve --channel discord "My Server/#support" "@someone"OmeniaClaw 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

• Dokumentacja CLI
• Przegląd kanałów