Skip to main content
El acoplamiento de canales es un reenvío de llamadas para una sesión de OpenClaw. Mantiene el mismo contexto de conversación, pero cambia dónde se entregan las respuestas futuras de esa sesión. El acoplamiento solo funciona desde un chat directo; no se ejecuta desde un chat grupal.

​
Ejemplo

Alice puede enviar mensajes a OpenClaw en Telegram y Discord:
Si Alice envía esto desde un chat directo de Telegram:
OpenClaw mantiene el contexto de la sesión actual y cambia la ruta de respuesta: La sesión no se vuelve a crear. El historial de la transcripción permanece asociado a la misma sesión.

​
Por qué usarlo

Use el acoplamiento cuando una tarea comience en una aplicación de chat, pero las siguientes respuestas deban llegar a otro lugar. Flujo habitual:
  1. Iniciar una tarea de agente desde Telegram.
  2. Pasar a Discord, donde se coordina el trabajo.
  3. Enviar /dock_discord desde el chat directo de Telegram.
  4. Mantener la misma sesión de OpenClaw, pero recibir las respuestas futuras en Discord.

​
Configuración requerida

El acoplamiento requiere session.identityLinks. El remitente de origen y el interlocutor de destino deben estar en el mismo grupo de identidades:
Los valores son identificadores de interlocutor con el prefijo del canal: La clave canónica (alice arriba) es solo el nombre del grupo de identidades compartido. Los comandos de acoplamiento usan los valores con el prefijo del canal para demostrar que el remitente de origen y el interlocutor de destino son la misma persona.

​
Comandos

OpenClaw genera un comando /dock-<channel> por cada plugin de canal cargado que admita comandos nativos, por lo que la lista crece a medida que se añaden plugins. Plugins incluidos que actualmente lo admiten: La forma con guion bajo también es el nombre del comando nativo en superficies como Telegram, que exponen directamente los comandos con barra diagonal.

​
Qué cambia

El acoplamiento actualiza los campos de entrega de la sesión activa: Esos campos se conservan en el almacén de sesiones y se utilizan para la entrega de respuestas posteriores de esa sesión.

​
Qué no cambia

El acoplamiento no:
  • crea cuentas de canales
  • conecta un nuevo bot de Discord, Telegram, Slack o Mattermost
  • concede acceso a un usuario
  • elude las listas de permitidos de los canales ni las políticas de mensajes directos
  • mueve el historial de la transcripción a otra sesión
  • hace que usuarios no relacionados compartan una sesión
Solo cambia la ruta de entrega de la sesión actual.

​
Solución de problemas

El comando indica que el remitente no está vinculado. Añada tanto el remitente actual como el interlocutor de destino al mismo grupo session.identityLinks. Por ejemplo, si el remitente de Telegram 123 debe acoplarse al interlocutor de Discord 456, incluya tanto telegram:123 como discord:456. El comando indica que el acoplamiento solo está disponible desde chats directos. Envíe el comando de acoplamiento desde un chat directo con OpenClaw, no desde un chat grupal. El comando indica que no existe ninguna sesión activa. Realice el acoplamiento desde una sesión de chat directo existente. El comando necesita una entrada de sesión activa para poder conservar la nueva ruta. Las respuestas siguen llegando al canal anterior. Compruebe que el comando haya respondido con un mensaje de éxito y confirme que el identificador del interlocutor de destino coincida con el utilizado por ese canal. El acoplamiento solo cambia la ruta de la sesión activa; otra sesión podría seguir dirigiendo las respuestas a otro lugar. Necesito volver al canal anterior. Envíe el comando correspondiente al canal original, como /dock_telegram o /dock-telegram, desde un remitente vinculado.