Naar hoofdinhoud gaan

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

Beheer chatkanaalaccounts en hun runtimestatus op de Gateway. Gerelateerde documentatie:

​
Veelgebruikte opdrachten

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

​
Status / mogelijkheden / oplossen / logs

  • channels status: --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 uitvoer transportstatus plus probe-resultaten kan bevatten, zoals works, probe failed, audit ok of audit failed. Als de Gateway onbereikbaar is, valt channels status terug op alleen-configuratiesamenvattingen in plaats van live probe-uitvoer. Gebruik openclaw sessions, Gateway sessions.list of de agent-tool sessions_list niet als signaal voor socketgezondheid van kanalen. Die oppervlakken rapporteren opgeslagen gespreksrijen, niet de runtimestatus 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 gespreksgebeurtenis.

​
Accounts toevoegen / verwijderen

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 toont kanaalspecifieke vlaggen (token, private key, app-token, signal-cli-paden, enz.).
channels remove werkt alleen op geinstalleerde/geconfigureerde kanaalplugins. Gebruik eerst channels add voor installeerbare cataloguskanalen. Voor runtime-ondersteunde kanaalplugins vraagt channels remove ook 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 toevoegoppervlakken zijn:
  • 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 env-ondersteunde auth van standaardaccounts waar ondersteund
Als een kanaalplugin moet worden geinstalleerd tijdens een vlaggestuurde toevoegopdracht, gebruikt OpenClaw de standaardinstallatiebron van het kanaal zonder de interactieve installatieprompt voor plugins te openen. Wanneer je openclaw channels add zonder vlaggen uitvoert, kan de interactieve wizard vragen om:
  • account-id’s per geselecteerd kanaal
  • optionele weergavenamen voor die accounts
  • Bind configured 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 routingbindingen. Je kunt dezelfde routingregels later ook beheren met openclaw agents bindings, openclaw agents bind en openclaw agents unbind (zie agents). Wanneer je een niet-standaardaccount toevoegt aan een kanaal dat nog single-account top-level-instellingen gebruikt, promoveert OpenClaw accountspecifieke top-level-waarden naar de accountmap van het kanaal voordat het nieuwe account wordt geschreven. De meeste kanalen plaatsen die waarden in channels.<channel>.accounts.default, maar meegeleverde kanalen kunnen in plaats daarvan een bestaand overeenkomend gepromoveerd account behouden. Matrix is het huidige voorbeeld: als er al een benoemd account bestaat, of defaultAccount naar een bestaand benoemd account wijst, behoudt promotie dat account in plaats van een nieuw accounts.default aan te maken. Routinggedrag blijft consistent:
  • Bestaande alleen-kanaalbindingen (zonder accountId) blijven overeenkomen met het standaardaccount.
  • channels add maakt of herschrijft geen bindingen automatisch in niet-interactieve modus.
  • Interactieve configuratie kan optioneel accountspecifieke bindingen toevoegen.
Als je configuratie al in een gemengde staat was (benoemde accounts aanwezig en top-level single-account-waarden nog ingesteld), voer dan openclaw 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)

openclaw channels login --channel whatsapp
openclaw channels logout --channel whatsapp
  • channels login ondersteunt --verbose.
  • channels login en logout kunnen het kanaal afleiden wanneer slechts een ondersteund logindoel is geconfigureerd.
  • channels logout geeft de voorkeur aan het live Gateway-pad wanneer bereikbaar, zodat uitloggen elke actieve listener stopt voordat de auth-status van het kanaal wordt gewist. Als een lokale Gateway niet bereikbaar is, valt het terug op lokale auth-opruiming.
  • Voer channels login uit vanuit een terminal op de gatewayhost. Agent exec blokkeert deze interactieve loginflow; kanaaleigen agent-logintools, zoals whatsapp_login, moeten vanuit chat worden gebruikt wanneer beschikbaar.

​
Probleemoplossing

  • Voer openclaw status --deep uit voor een brede probe.
  • Gebruik openclaw doctor voor begeleide oplossingen.
  • openclaw channels list drukt geen momentopnamen van modelprovidergebruik/quota meer af. Gebruik daarvoor openclaw status (overzicht) of openclaw models list (per provider).
  • openclaw channels status valt terug op alleen-configuratiesamenvattingen 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 opmerkingen in plaats van het als niet geconfigureerd te tonen.

​
Mogelijkhedenprobe

Haal providerhints voor mogelijkheden op (intents/scopes waar beschikbaar) plus statische functieondersteuning: 
openclaw channels capabilities
openclaw channels capabilities --channel discord --target channel:123
Opmerkingen:
  • --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 geldt alleen voor 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-botvlaggen + 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: 
openclaw channels resolve --channel slack "#general" "@jane"
openclaw channels resolve --channel discord "My Server/#support" "@someone"
openclaw channels resolve --channel matrix "Project Room"
Opmerkingen:
  • Gebruik --kind user|group|auto om het doeltype af te dwingen.
  • Resolutie geeft de voorkeur aan actieve overeenkomsten wanneer meerdere items 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 niet-opgeloste resultaten met opmerkingen in plaats van de hele run af te breken.
  • channels resolve installeert geen kanaalplugins. Gebruik channels add --channel <name> voordat je namen oplost voor een installeerbaar cataloguskanaal.

​
Gerelateerd