--- read_when: - Desea agregar/quitar cuentas de canal (WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (Plugin)/Signal/iMessage/Matrix) - Desea comprobar el estado del canal o seguir los registros del canal summary: Referencia de CLI para `openclaw channels` (cuentas, estado, inicio/cierre de sesión, registros) title: Canales x-i18n: generated_at: "2026-05-11T20:25:42Z" model: gpt-5.5 provider: openai source_hash: 58a964b4db9526defab6ee47b7a99c11086e345d42c8d20f5262fc134337947f source_path: cli/channels.md workflow: 16 --- # `openclaw channels` Administra cuentas de canales de chat y su estado de ejecución en el Gateway. Documentación relacionada: - Guías de canales: [Canales](/es/channels) - Configuración del Gateway: [Configuración](/es/gateway/configuration) ## Comandos comunes ```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` muestra solo canales de chat: cuentas configuradas de forma predeterminada, con etiquetas de estado `installed`, `configured` y `enabled` por cuenta. Pasa `--all` para mostrar también canales incluidos que todavía no tienen una cuenta configurada y canales del catálogo instalables que aún no están en disco. Los proveedores de autenticación (OAuth + claves de API) y las instantáneas de uso/cuota de proveedores de modelos ya no se imprimen aquí; usa `openclaw models auth list` para los perfiles de autenticación de proveedores y `openclaw status` u `openclaw models list` para el uso. ## Estado / capacidades / resolución / registros - `channels status`: `--channel `, `--probe`, `--timeout `, `--json` - `channels capabilities`: `--channel `, `--account ` (solo con `--channel`), `--target `, `--timeout `, `--json` - `channels resolve`: ``, `--channel `, `--account `, `--kind `, `--json` - `channels logs`: `--channel `, `--lines `, `--json` `channels status --probe` es la ruta en vivo: en un Gateway accesible ejecuta comprobaciones `probeAccount` y, opcionalmente, `auditAccount` por cuenta, por lo que la salida puede incluir el estado del transporte además de resultados de sondeo como `works`, `probe failed`, `audit ok` o `audit failed`. Si el Gateway no es accesible, `channels status` recurre a resúmenes basados solo en la configuración en lugar de una salida de sondeo en vivo. No uses `openclaw sessions`, `sessions.list` del Gateway ni la herramienta `sessions_list` del agente como señal de estado de los sockets del canal. Esas superficies informan filas de conversaciones almacenadas, no el estado de ejecución del proveedor. Después de reiniciar un proveedor de Discord, una cuenta conectada pero sin actividad puede estar en buen estado aunque no aparezca ninguna fila de sesión de Discord hasta el siguiente evento de conversación entrante o saliente. ## Agregar / eliminar cuentas ```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` muestra las opciones por canal (token, clave privada, token de aplicación, rutas de signal-cli, etc.). `channels remove` solo funciona con plugins de canal instalados/configurados. Usa primero `channels add` para canales instalables del catálogo. En plugins de canal respaldados por runtime, `channels remove` también solicita al Gateway en ejecución que detenga la cuenta seleccionada antes de actualizar la configuración, de modo que deshabilitar o eliminar una cuenta no deje activo el listener anterior hasta el reinicio. Las superficies comunes de agregado no interactivo incluyen: - canales con token de bot: `--token`, `--bot-token`, `--app-token`, `--token-file` - campos de transporte de Signal/iMessage: `--signal-number`, `--cli-path`, `--http-url`, `--http-host`, `--http-port`, `--db-path`, `--service`, `--region` - campos de Google Chat: `--webhook-path`, `--webhook-url`, `--audience-type`, `--audience` - campos de Matrix: `--homeserver`, `--user-id`, `--access-token`, `--password`, `--device-name`, `--initial-sync-limit` - campos de Nostr: `--private-key`, `--relay-urls` - campos de Tlon: `--ship`, `--url`, `--code`, `--group-channels`, `--dm-allowlist`, `--auto-discover-channels` - `--use-env` para autenticación respaldada por variables de entorno en la cuenta predeterminada donde sea compatible Si es necesario instalar un Plugin de canal durante un comando de agregado controlado por opciones, OpenClaw usa la fuente de instalación predeterminada del canal sin abrir el aviso interactivo de instalación de plugins. Cuando ejecutas `openclaw channels add` sin opciones, el asistente interactivo puede solicitar: - identificadores de cuenta por canal seleccionado - nombres visibles opcionales para esas cuentas - `Route these channel accounts to agents now?` Si confirmas vincular ahora, el asistente pregunta qué agente debe poseer cada cuenta de canal configurada y escribe bindings de enrutamiento con alcance de cuenta. También puedes administrar las mismas reglas de enrutamiento más adelante con `openclaw agents bindings`, `openclaw agents bind` y `openclaw agents unbind` (consulta [agentes](/es/cli/agents)). Cuando agregas una cuenta no predeterminada a un canal que todavía usa ajustes de nivel superior de una sola cuenta, OpenClaw promueve los valores de nivel superior con alcance de cuenta al mapa de cuentas del canal antes de escribir la nueva cuenta. La mayoría de los canales colocan esos valores en `channels..accounts.default`, pero los canales incluidos pueden conservar en su lugar una cuenta promovida coincidente existente. Matrix es el ejemplo actual: si ya existe una cuenta con nombre, o si `defaultAccount` apunta a una cuenta con nombre existente, la promoción conserva esa cuenta en lugar de crear una nueva `accounts.default`. El comportamiento de enrutamiento se mantiene coherente: - Los bindings existentes solo de canal (sin `accountId`) siguen coincidiendo con la cuenta predeterminada. - `channels add` no crea ni reescribe bindings automáticamente en modo no interactivo. - La configuración interactiva puede agregar opcionalmente bindings con alcance de cuenta. Si tu configuración ya estaba en un estado mixto (cuentas con nombre presentes y valores de una sola cuenta de nivel superior aún establecidos), ejecuta `openclaw doctor --fix` para mover los valores con alcance de cuenta a la cuenta promovida elegida para ese canal. La mayoría de los canales se promueven a `accounts.default`; Matrix puede conservar en su lugar un destino con nombre/predeterminado existente. ## Inicio y cierre de sesión (interactivo) ```bash openclaw channels login --channel whatsapp openclaw channels logout --channel whatsapp ``` - `channels login` admite `--verbose`. - `channels login` y `logout` pueden inferir el canal cuando solo hay configurado un destino de inicio de sesión compatible. - `channels logout` prefiere la ruta en vivo del Gateway cuando es accesible, de modo que el cierre de sesión detiene cualquier listener activo antes de limpiar el estado de autenticación del canal. Si no se puede acceder a un Gateway local, recurre a la limpieza local de autenticación. - Ejecuta `channels login` desde una terminal en el host del Gateway. `exec` del agente bloquea este flujo interactivo de inicio de sesión; las herramientas de inicio de sesión nativas del canal para agentes, como `whatsapp_login`, deben usarse desde el chat cuando estén disponibles. ## Solución de problemas - Ejecuta `openclaw status --deep` para un sondeo amplio. - Usa `openclaw doctor` para correcciones guiadas. - `openclaw channels list` ya no imprime instantáneas de uso/cuota de proveedores de modelos. Para eso, usa `openclaw status` (vista general) u `openclaw models list` (por proveedor). - `openclaw channels status` recurre a resúmenes basados solo en la configuración cuando no se puede acceder al Gateway. Si una credencial de canal compatible está configurada mediante SecretRef pero no está disponible en la ruta del comando actual, informa esa cuenta como configurada con notas de degradación en lugar de mostrarla como no configurada. ## Sondeo de capacidades Obtén indicios de capacidades del proveedor (intenciones/ámbitos donde estén disponibles) además de soporte estático de funciones: ```bash openclaw channels capabilities openclaw channels capabilities --channel discord --target channel:123 ``` Notas: - `--channel` es opcional; omítelo para enumerar todos los canales (incluidas las extensiones). - `--account` solo es válido con `--channel`. - `--target` acepta `channel:` o un id numérico de canal sin procesar y solo se aplica a Discord. Para los canales de voz de Discord, la comprobación de permisos marca la ausencia de `ViewChannel`, `Connect`, `Speak`, `SendMessages` y `ReadMessageHistory`. - Los sondeos son específicos del proveedor: intenciones de Discord + permisos opcionales del canal; bot de Slack + ámbitos de usuario; flags de bot de Telegram + webhook; versión del daemon de Signal; token de aplicación de Microsoft Teams + roles/ámbitos de Graph (anotados cuando se conocen). Los canales sin sondeos informan `Probe: unavailable`. ## Resolver nombres a IDs Resuelve nombres de canales/usuarios a IDs mediante el directorio del proveedor: ```bash openclaw channels resolve --channel slack "#general" "@jane" openclaw channels resolve --channel discord "My Server/#support" "@someone" openclaw channels resolve --channel matrix "Project Room" ``` Notas: - Usa `--kind user|group|auto` para forzar el tipo de destino. - La resolución prefiere coincidencias activas cuando varias entradas comparten el mismo nombre. - `channels resolve` es de solo lectura. Si una cuenta seleccionada está configurada mediante SecretRef pero esa credencial no está disponible en la ruta del comando actual, el comando devuelve resultados no resueltos degradados con notas en lugar de abortar toda la ejecución. - `channels resolve` no instala plugins de canal. Usa `channels add --channel ` antes de resolver nombres para un canal instalable del catálogo. ## Relacionado - [Referencia de CLI](/es/cli) - [Vista general de canales](/es/channels)