Sessions and memory
Acoplamiento de canales
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:
{ session: { identityLinks: { alice: ["telegram:123", "discord:456"], }, },}Si Alice envía esto desde un chat directo de Telegram:
/dock_discordOpenClaw mantiene el contexto de la sesión actual y cambia la ruta de respuesta:
| Antes del acoplamiento | Después de /dock_discord |
|---|---|
Las respuestas van a Telegram 123 |
Las respuestas van a Discord 456 |
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:
- Iniciar una tarea de agente desde Telegram.
- Pasar a Discord, donde se coordina el trabajo.
- Enviar
/dock_discorddesde el chat directo de Telegram. - 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:
{ session: { identityLinks: { alice: ["telegram:123", "discord:456", "slack:U123"], }, },}Los valores son identificadores de interlocutor con el prefijo del canal:
| Valor | Significado |
|---|---|
telegram:123 |
Identificador del remitente de Telegram 123 |
discord:456 |
Identificador del interlocutor directo de Discord 456 |
slack:U123 |
Identificador de usuario de Slack U123 |
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:
| Canal de destino | Comando | Alias |
|---|---|---|
| Discord | /dock-discord |
/dock_discord |
| Mattermost | /dock-mattermost |
/dock_mattermost |
| Slack | /dock-slack |
/dock_slack |
| Telegram | /dock-telegram |
/dock_telegram |
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:
| Campo de la sesión | Ejemplo después de /dock_discord |
|---|---|
lastChannel |
discord |
lastTo |
456 |
lastAccountId |
la cuenta del canal de destino, o default |
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.
