Saltar al contenido principal

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

Administra cuentas de canales de chat y su estado de ejecución en el Gateway. Documentación relacionada:

​
Comandos comunes

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 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 <name>, --probe, --timeout <ms>, --json
  • channels capabilities: --channel <name>, --account <id> (solo con --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 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

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 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). 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.<channel>.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)

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: 
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:<id> 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: 
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 <name> antes de resolver nombres para un canal instalable del catálogo.

​
Relacionado