OmeniaClaw channels

Beheer chatkanaalaccounts en hun runtime-status op de Gateway.

Gerelateerde documentatie:

• Kanaalhandleidingen: Kanalen
• Gateway-configuratie: Configuratie

Algemene opdrachten

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 toont alleen chatkanalen: standaard geconfigureerde accounts, met statustags installed, configured en enabled per account. Geef --all mee om ook gebundelde kanalen te tonen die nog geen geconfigureerd account hebben, en installeerbare cataloguskanalen die nog niet op schijf staan. Authenticatieproviders (OAuth + API-sleutels) en momentopnamen van gebruik/quota van modelproviders worden hier niet meer afgedrukt; gebruik OmeniaClaw models auth list voor provider-authenticatieprofielen en OmeniaClaw status of OmeniaClaw models list voor gebruik.

Status / mogelijkheden / oplossen / logs

• channels status: --channel <name>, --probe, --timeout <ms>, --json
• channels capabilities: --channel <name>, --account <id> (alleen met --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 is het live pad: op een bereikbare Gateway voert het per account probeAccount en optionele auditAccount-controles uit, zodat de uitvoer de transportstatus plus proberesultaten kan bevatten, zoals works, probe failed, audit ok of audit failed. Als de Gateway onbereikbaar is, valt channels status terug op samenvattingen op basis van alleen configuratie in plaats van live probe-uitvoer.

Gebruik OmeniaClaw sessions, Gateway sessions.list of de agent-tool sessions_list niet als signaal voor de socketstatus van een kanaal. Die oppervlakken rapporteren opgeslagen conversatierijen, niet de runtime-status van de provider. Na een herstart van een Discord-provider kan een verbonden maar stil account gezond zijn terwijl er geen Discord-sessierij verschijnt tot de volgende inkomende of uitgaande conversatiegebeurtenis.

Accounts toevoegen / verwijderen

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 werkt alleen op geïnstalleerde/geconfigureerde kanaalplugins. Gebruik eerst channels add voor installeerbare cataloguskanalen. Voor runtime-ondersteunde kanaalplugins vraagt channels remove ook aan de draaiende Gateway om het geselecteerde account te stoppen voordat de configuratie wordt bijgewerkt, zodat het uitschakelen of verwijderen van een account de oude listener niet actief laat tot een herstart.

Veelvoorkomende niet-interactieve toevoegingsoppervlakken zijn onder andere:

• bot-tokenkanalen: --token, --bot-token, --app-token, --token-file
• Signal/iMessage-transportvelden: --signal-number, --cli-path, --http-url, --http-host, --http-port, --db-path, --service, --region
• Google Chat-velden: --webhook-path, --webhook-url, --audience-type, --audience
• Matrix-velden: --homeserver, --user-id, --access-token, --password, --device-name, --initial-sync-limit
• Nostr-velden: --private-key, --relay-urls
• Tlon-velden: --ship, --url, --code, --group-channels, --dm-allowlist, --auto-discover-channels
• --use-env voor door env ondersteunde authenticatie van standaardaccounts waar dat wordt ondersteund

Als een kanaalplugin moet worden geïnstalleerd tijdens een door flags aangestuurde add-opdracht, gebruikt OmeniaClaw de standaardinstallatiebron van het kanaal zonder de interactieve prompt voor plugininstallatie te openen.

Wanneer je OmeniaClaw channels add zonder flags uitvoert, kan de interactieve wizard vragen om:

• account-id's per geselecteerd kanaal
• optionele weergavenamen voor die accounts
• Route these channel accounts to agents now?

Als je nu binden bevestigt, vraagt de wizard welke agent eigenaar moet zijn van elk geconfigureerd kanaalaccount en schrijft hij accountspecifieke routeringsbindingen.

Je kunt dezelfde routeringsregels later ook beheren met OmeniaClaw agents bindings, OmeniaClaw agents bind en OmeniaClaw agents unbind (zie agents).

Wanneer je een niet-standaardaccount toevoegt aan een kanaal dat nog steeds single-accountinstellingen op topniveau gebruikt, promoveert OmeniaClaw accountspecifieke topniveauwaarden naar de accountmap van het kanaal voordat het nieuwe account wordt geschreven. De meeste kanalen plaatsen die waarden in channels.<channel>.accounts.default, maar gebundelde kanalen kunnen in plaats daarvan een bestaand overeenkomend gepromoveerd account behouden. Matrix is het huidige voorbeeld: als er al één benoemd account bestaat, of defaultAccount naar een bestaand benoemd account wijst, behoudt promotie dat account in plaats van een nieuw accounts.default te maken.

Routeringsgedrag blijft consistent:

• Bestaande bindingen op alleen kanaalniveau (geen accountId) blijven overeenkomen met het standaardaccount.
• channels add maakt of herschrijft geen bindingen automatisch in niet-interactieve modus.
• Interactieve setup kan optioneel accountspecifieke bindingen toevoegen.

Als je configuratie al in een gemengde staat was (benoemde accounts aanwezig en single-accountwaarden op topniveau nog ingesteld), voer dan OmeniaClaw doctor --fix uit om accountspecifieke waarden te verplaatsen naar het gepromoveerde account dat voor dat kanaal is gekozen. De meeste kanalen promoveren naar accounts.default; Matrix kan in plaats daarvan een bestaand benoemd/standaarddoel behouden.

Inloggen en uitloggen (interactief)

OmeniaClaw channels login --channel whatsappOmeniaClaw channels logout --channel whatsapp

• channels login ondersteunt --verbose.
• channels login en logout kunnen het kanaal afleiden wanneer er slechts één ondersteund inlogdoel is geconfigureerd.
• channels logout geeft de voorkeur aan het live Gateway-pad wanneer dit bereikbaar is, zodat uitloggen elke actieve listener stopt voordat de authenticatiestatus van het kanaal wordt gewist. Als een lokale Gateway niet bereikbaar is, valt het terug op lokale authenticatieopschoning.
• Voer channels login uit vanaf een terminal op de gatewayhost. Agent exec blokkeert deze interactieve inlogflow; kanaaleigen agent-inlogtools, zoals whatsapp_login, moeten vanuit chat worden gebruikt wanneer beschikbaar.

Probleemoplossing

• Voer OmeniaClaw status --deep uit voor een brede probe.
• Gebruik OmeniaClaw doctor voor begeleide oplossingen.
• OmeniaClaw channels list drukt geen momentopnamen van gebruik/quota van modelproviders meer af. Gebruik daarvoor OmeniaClaw status (overzicht) of OmeniaClaw models list (per provider).
• OmeniaClaw channels status valt terug op samenvattingen op basis van alleen configuratie wanneer de Gateway onbereikbaar is. Als een ondersteunde kanaalcredential via SecretRef is geconfigureerd maar niet beschikbaar is in het huidige opdrachtpad, rapporteert het dat account als geconfigureerd met gedegradeerde notities in plaats van het als niet geconfigureerd te tonen.

Mogelijkhedenprobe

Haal providerhints voor mogelijkheden op (intents/scopes waar beschikbaar) plus statische functieondersteuning:

OmeniaClaw channels capabilitiesOmeniaClaw channels capabilities --channel discord --target channel:123

Notities:

• --channel is optioneel; laat het weg om elk kanaal weer te geven (inclusief extensies).
• --account is alleen geldig met --channel.
• --target accepteert channel:<id> of een onbewerkt numeriek kanaal-id en is alleen van toepassing op Discord. Voor Discord-spraakkanalen markeert de permissiecontrole ontbrekende ViewChannel, Connect, Speak, SendMessages en ReadMessageHistory.
• Probes zijn providerspecifiek: Discord-intents + optionele kanaalpermissies; Slack-bot + gebruikersscopes; Telegram-botflags + Webhook; Signal-daemonversie; Microsoft Teams-app-token + Graph-rollen/scopes (geannoteerd waar bekend). Kanalen zonder probes rapporteren Probe: unavailable.

Namen omzetten naar ID's

Zet kanaal-/gebruikersnamen om naar ID's met de providerdirectory:

OmeniaClaw channels resolve --channel slack "#general" "@jane"OmeniaClaw channels resolve --channel discord "My Server/#support" "@someone"OmeniaClaw channels resolve --channel matrix "Project Room"

Notities:

• Gebruik --kind user|group|auto om het doeltype af te dwingen.
• Oplossing geeft de voorkeur aan actieve overeenkomsten wanneer meerdere vermeldingen dezelfde naam delen.
• channels resolve is alleen-lezen. Als een geselecteerd account via SecretRef is geconfigureerd maar die credential niet beschikbaar is in het huidige opdrachtpad, retourneert de opdracht gedegradeerde onopgeloste resultaten met notities in plaats van de hele uitvoering af te breken.
• channels resolve installeert geen kanaalplugins. Gebruik channels add --channel <name> voordat je namen oplost voor een installeerbaar cataloguskanaal.

Gerelateerd

• CLI-referentie
• Kanalenoverzicht