English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

CLI commands

Canais

openclaw channels

Gerencie contas de canais de chat e seu status de runtime no Gateway.

Documentos relacionados:

Comandos comuns

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 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 incluídos que ainda não têm uma conta configurada e canais do catálogo instalável 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 / resolver / logs

  • channels status: --probe, --timeout <ms>, --json
  • channels capabilities: --channel <name>, --account <id> (somente com --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 é 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 o estado do transporte mais resultados da 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 de saída de sondagem ao vivo.

Não use openclaw sessions, Gateway sessions.list ou a ferramenta sessions_list do agente como sinal de integridade do socket do canal. Essas superfícies relatam linhas de conversas armazenadas, não o estado de runtime do provedor. Depois de uma reinicialização do provedor Discord, uma conta conectada, mas silenciosa, pode estar saudável mesmo que nenhuma linha de sessão Discord apareça até o próximo evento de conversa de entrada ou saída.

Adicionar / remover contas

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

channels remove opera apenas em plugins de canal instalados/configurados. Use channels add primeiro para canais de catálogo instalável. Para plugins de canal com backend de runtime, channels remove também pede ao Gateway em execução que pare a conta selecionada antes de atualizar a configuração, então desabilitar ou excluir uma conta não deixa o listener antigo ativo até a reinicialização.

Superfícies comuns de adição não interativa incluem:

  • canais com bot-token: --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 baseada em env de conta padrão, onde houver suporte

Se um plugin de canal precisar ser instalado durante um comando de adição orientado por flags, o OpenClaw usa a origem 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
  • Bind configured channel accounts to agents now?

Se você confirmar a vinculação agora, o assistente pergunta qual agente deve ser dono de cada conta de canal configurada e grava bindings de roteamento com escopo de conta.

Você também pode gerenciar as mesmas regras de roteamento depois com openclaw agents bindings, openclaw agents bind e openclaw agents unbind (consulte agentes).

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.<channel>.accounts.default, mas canais incluídos 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 preserva essa conta em vez de criar uma nova accounts.default.

O comportamento de roteamento permanece consistente:

  • Bindings existentes somente de canal (sem accountId) continuam correspondendo à conta padrão.
  • channels add não cria nem reescreve bindings automaticamente no modo não interativo.
  • A configuração interativa pode adicionar opcionalmente bindings 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.

Login e logout (interativos)

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 está 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. exec do agente bloqueia esse fluxo de login interativo; ferramentas de login nativas do canal para agentes, como whatsapp_login, devem ser usadas a partir do 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 esses dados, 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 via 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

Busca dicas de capacidade do provedor (intents/escopos quando disponíveis) mais suporte estático a recursos:

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:<id> 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 do 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:

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 via SecretRef, mas essa credencial estiver indisponível no caminho do comando atual, o comando retorna resultados não resolvidos degradados com notas em vez de abortar toda a execução.
  • channels resolve não instala plugins de canal. Use channels add --channel <name> antes de resolver nomes para um canal de catálogo instalável.

Relacionado