--- read_when: - Você quer adicionar/remover contas de canais (WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (Plugin)/Signal/iMessage/Matrix) - Você quer verificar o status do canal ou acompanhar os logs do canal summary: Referência da CLI para `openclaw channels` (contas, status, iniciar/encerrar sessão, registros) title: Canais x-i18n: generated_at: "2026-05-11T20:25:22Z" model: gpt-5.5 provider: openai source_hash: 58a964b4db9526defab6ee47b7a99c11086e345d42c8d20f5262fc134337947f source_path: cli/channels.md workflow: 16 --- # `openclaw channels` Gerencie contas de canais de chat e o status de runtime delas no Gateway. Documentos relacionados: - Guias de canais: [Canais](/pt-BR/channels) - Configuração do Gateway: [Configuração](/pt-BR/gateway/configuration) ## Comandos comuns ```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` mostra apenas canais de chat: contas configuradas por padrão, com tags de status `installed`, `configured` e `enabled` por conta. Passe `--all` para também exibir canais integrados que ainda não têm conta configurada e canais do catálogo instaláveis que ainda não estão no disco. Provedores de autenticação (OAuth + chaves de API) e snapshots de uso/cota de provedores de modelo não são mais impressos aqui; use `openclaw models auth list` para perfis de autenticação de provedores e `openclaw status` ou `openclaw models list` para uso. ## Status / capacidades / resolução / logs - `channels status`: `--channel `, `--probe`, `--timeout `, `--json` - `channels capabilities`: `--channel `, `--account ` (somente com `--channel`), `--target `, `--timeout `, `--json` - `channels resolve`: ``, `--channel `, `--account `, `--kind `, `--json` - `channels logs`: `--channel `, `--lines `, `--json` `channels status --probe` é o caminho ao vivo: em um Gateway acessível, ele executa verificações `probeAccount` por conta e verificações opcionais `auditAccount`, então a saída pode incluir estado de transporte mais resultados de sondagem como `works`, `probe failed`, `audit ok` ou `audit failed`. Se o Gateway estiver inacessível, `channels status` recorre a resumos somente de configuração em vez da saída de sondagem ao vivo. Não use `openclaw sessions`, Gateway `sessions.list` nem a ferramenta `sessions_list` do agente como sinal de integridade do soquete do canal. Essas superfícies relatam linhas de conversas armazenadas, não o estado de runtime do provedor. Após uma reinicialização do provedor Discord, uma conta conectada, mas silenciosa, pode estar íntegra mesmo que nenhuma linha de sessão do Discord apareça até o próximo evento de conversa de entrada ou saída. ## Adicionar / remover contas ```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` mostra flags por canal (token, chave privada, token do app, caminhos do signal-cli etc.). `channels remove` opera apenas em Plugins de canal instalados/configurados. Use `channels add` primeiro para canais instaláveis do catálogo. Para Plugins de canal com suporte de runtime, `channels remove` também solicita ao Gateway em execução que pare a conta selecionada antes de atualizar a configuração, para que desabilitar ou excluir uma conta não deixe o listener antigo ativo até a reinicialização. Superfícies comuns de adição não interativa incluem: - canais de token de bot: `--token`, `--bot-token`, `--app-token`, `--token-file` - campos de transporte do Signal/iMessage: `--signal-number`, `--cli-path`, `--http-url`, `--http-host`, `--http-port`, `--db-path`, `--service`, `--region` - campos do Google Chat: `--webhook-path`, `--webhook-url`, `--audience-type`, `--audience` - campos do Matrix: `--homeserver`, `--user-id`, `--access-token`, `--password`, `--device-name`, `--initial-sync-limit` - campos do Nostr: `--private-key`, `--relay-urls` - campos do Tlon: `--ship`, `--url`, `--code`, `--group-channels`, `--dm-allowlist`, `--auto-discover-channels` - `--use-env` para autenticação de conta padrão baseada em env quando houver suporte Se um Plugin de canal precisar ser instalado durante um comando de adição orientado por flags, o OpenClaw usa a fonte de instalação padrão do canal sem abrir o prompt interativo de instalação de Plugin. Quando você executa `openclaw channels add` sem flags, o assistente interativo pode solicitar: - IDs de conta por canal selecionado - nomes de exibição opcionais para essas contas - `Route these channel accounts to agents now?` Se você confirmar a vinculação agora, o assistente pergunta qual agente deve possuir cada conta de canal configurada e grava vínculos de roteamento com escopo de conta. Você também pode gerenciar as mesmas regras de roteamento posteriormente com `openclaw agents bindings`, `openclaw agents bind` e `openclaw agents unbind` (consulte [agentes](/pt-BR/cli/agents)). Quando você adiciona uma conta não padrão a um canal que ainda está usando configurações de nível superior de conta única, o OpenClaw promove valores de nível superior com escopo de conta para o mapa de contas do canal antes de gravar a nova conta. A maioria dos canais coloca esses valores em `channels..accounts.default`, mas canais integrados podem preservar uma conta promovida correspondente existente. Matrix é o exemplo atual: se uma conta nomeada já existir, ou `defaultAccount` apontar para uma conta nomeada existente, a promoção preservará essa conta em vez de criar uma nova `accounts.default`. O comportamento de roteamento permanece consistente: - Vínculos existentes somente de canal (sem `accountId`) continuam correspondendo à conta padrão. - `channels add` não cria nem reescreve vínculos automaticamente em modo não interativo. - A configuração interativa pode opcionalmente adicionar vínculos com escopo de conta. Se sua configuração já estava em um estado misto (contas nomeadas presentes e valores de conta única de nível superior ainda definidos), execute `openclaw doctor --fix` para mover valores com escopo de conta para a conta promovida escolhida para esse canal. A maioria dos canais promove para `accounts.default`; Matrix pode preservar um destino nomeado/padrão existente em vez disso. ## Login e logout (interativo) ```bash openclaw channels login --channel whatsapp openclaw channels logout --channel whatsapp ``` - `channels login` oferece suporte a `--verbose`. - `channels login` e `logout` podem inferir o canal quando apenas um destino de login compatível estiver configurado. - `channels logout` prefere o caminho ao vivo do Gateway quando acessível, então o logout para qualquer listener ativo antes de limpar o estado de autenticação do canal. Se um Gateway local não estiver acessível, ele recorre à limpeza de autenticação local. - Execute `channels login` em um terminal no host do gateway. O `exec` do agente bloqueia esse fluxo de login interativo; ferramentas de login nativas de canal para agentes, como `whatsapp_login`, devem ser usadas pelo chat quando disponíveis. ## Solução de problemas - Execute `openclaw status --deep` para uma sondagem ampla. - Use `openclaw doctor` para correções guiadas. - `openclaw channels list` não imprime mais snapshots de uso/cota de provedores de modelo. Para isso, use `openclaw status` (visão geral) ou `openclaw models list` (por provedor). - `openclaw channels status` recorre a resumos somente de configuração quando o gateway está inacessível. Se uma credencial de canal compatível estiver configurada por SecretRef, mas indisponível no caminho do comando atual, ele relata essa conta como configurada com notas degradadas em vez de mostrá-la como não configurada. ## Sondagem de capacidades Busque dicas de capacidades do provedor (intents/escopos quando disponíveis) mais suporte estático a recursos: ```bash openclaw channels capabilities openclaw channels capabilities --channel discord --target channel:123 ``` Observações: - `--channel` é opcional; omita para listar todos os canais (incluindo extensions). - `--account` só é válido com `--channel`. - `--target` aceita `channel:` ou um ID numérico bruto de canal e se aplica apenas ao Discord. Para canais de voz do Discord, a verificação de permissão sinaliza a ausência de `ViewChannel`, `Connect`, `Speak`, `SendMessages` e `ReadMessageHistory`. - As sondagens são específicas do provedor: intents do Discord + permissões opcionais de canal; escopos de bot + usuário do Slack; flags de bot + Webhook do Telegram; versão do daemon do Signal; token de app + funções/escopos do Graph do Microsoft Teams (anotados quando conhecidos). Canais sem sondagens relatam `Probe: unavailable`. ## Resolver nomes para IDs Resolva nomes de canais/usuários para IDs usando o diretório do provedor: ```bash openclaw channels resolve --channel slack "#general" "@jane" openclaw channels resolve --channel discord "My Server/#support" "@someone" openclaw channels resolve --channel matrix "Project Room" ``` Observações: - Use `--kind user|group|auto` para forçar o tipo de destino. - A resolução prefere correspondências ativas quando várias entradas compartilham o mesmo nome. - `channels resolve` é somente leitura. Se uma conta selecionada estiver configurada por SecretRef, mas essa credencial estiver indisponível no caminho do comando atual, o comando retorna resultados degradados não resolvidos com notas em vez de abortar toda a execução. - `channels resolve` não instala Plugins de canal. Use `channels add --channel ` antes de resolver nomes para um canal instalável do catálogo. ## Relacionado - [Referência da CLI](/pt-BR/cli) - [Visão geral de canais](/pt-BR/channels)