openclaw channels

Gestiona las cuentas de canales de chat y su estado en tiempo de ejecución en el Gateway.

Documentación relacionada:

• Guías de canales: Channels
• Configuración del Gateway: Configuration

Comandos comunes

openclaw channels list
openclaw channels status
openclaw channels capabilities
openclaw channels capabilities --channel discord --target channel:123
openclaw channels resolve --channel slack "#general" "@jane"
openclaw channels logs --channel all

Agregar / eliminar cuentas

openclaw channels add --channel telegram --token <bot-token>
openclaw channels remove --channel telegram --delete

Consejo: openclaw channels add --help muestra los flags por canal (token, app token, rutas de signal-cli, etc).

Cuando ejecutas openclaw channels add sin flags, el asistente interactivo puede solicitar:

• IDs de cuenta por canal seleccionado
• nombres de visualización opcionales para esas cuentas
• Bind configured channel accounts to agents now?

Si confirmas el bind ahora, el asistente pregunta qué agente debe ser dueño de cada cuenta de canal configurada y escribe bindings de enrutamiento con alcance de cuenta.

También puedes gestionar las mismas reglas de enrutamiento más tarde con openclaw agents bindings, openclaw agents bind y openclaw agents unbind (ver agents).

Cuando agregas una cuenta no predeterminada a un canal que todavía usa configuración de nivel superior de cuenta única (sin entradas en channels.<channel>.accounts aún), OpenClaw mueve los valores de cuenta única con alcance de cuenta a channels.<channel>.accounts.default, y luego escribe la nueva cuenta. Esto preserva el comportamiento de la cuenta original mientras pasa a la estructura multi-cuenta.

El comportamiento de enrutamiento se mantiene consistente:

• Los bindings existentes solo por canal (sin accountId) siguen coincidiendo con la cuenta por defecto.
• channels add no auto-crea ni reescribe bindings en modo no interactivo.
• La configuración interactiva puede opcionalmente agregar bindings con alcance de cuenta.

Si tu configuración ya estaba en un estado mixto (cuentas con nombre presentes, faltando default, y valores de cuenta única de nivel superior aún establecidos), ejecuta openclaw doctor --fix para mover los valores con alcance de cuenta a accounts.default.

Login / logout (interactivo)

openclaw channels login --channel whatsapp
openclaw channels logout --channel whatsapp

Solución de problemas

• Ejecuta openclaw status --deep para un sondeo amplio.
• Usa openclaw doctor para correcciones guiadas.
• openclaw channels list muestra Claude: HTTP 403 ... user:profile -> el snapshot de uso necesita el alcance user:profile. Usa --no-usage, o proporciona una clave de sesión de claude.ai (CLAUDE_WEB_SESSION_KEY / CLAUDE_WEB_COOKIE), o vuelve a autenticarte vía Claude Code CLI.
• openclaw channels status recurre a resúmenes solo de configuración cuando el gateway no es accesible. Si una credencial de canal soportada está configurada vía SecretRef pero no disponible en la ruta del comando actual, reporta esa cuenta como configurada con notas degradadas en lugar de mostrarla como no configurada.

Sondeo de capacidades

Obtiene indicaciones de capacidades del proveedor (intents/scopes donde estén disponibles) más soporte estático de características:

openclaw channels capabilities
openclaw channels capabilities --channel discord --target channel:123

Notas:

• --channel es opcional; omítelo para listar todos los canales (incluyendo extensiones).
• --target acepta channel:<id> o un id numérico de canal y solo aplica a Discord.
• Los sondeos son específicos del proveedor: intents de Discord + permisos opcionales de canal; scopes de bot + usuario de Slack; flags de bot de Telegram + webhook; versión del daemon de Signal; token de app de MS Teams + roles/scopes de Graph (anotados donde se conocen). Los canales sin sondeos reportan Probe: unavailable.

Resolver nombres a IDs

Resuelve nombres de canal/usuario a IDs usando el directorio del proveedor:

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 múltiples entradas comparten el mismo nombre.
• channels resolve es de solo lectura. Si una cuenta seleccionada está configurada vía SecretRef pero esa credencial no está disponible en la ruta del comando actual, el comando devuelve resultados degradados no resueltos con notas en lugar de abortar toda la ejecución.