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.
El acoplamiento de canales es el reenvío de llamadas para una sesión de OpenClaw.
Mantiene el mismo contexto de conversación, pero cambia dónde se entregarán las respuestas futuras de
esa sesión.
Ejemplo
Alice puede enviar mensajes a OpenClaw en Telegram y Discord:
{
session: {
identityLinks: {
alice: ["telegram:123", "discord:456"],
},
},
}
| Antes del acoplamiento | Después de /dock_discord |
|---|
Las respuestas van a Telegram 123 | Las respuestas van a Discord 456 |
Por qué usarlo
Usa el acoplamiento cuando una tarea empieza en una aplicación de chat, pero las siguientes respuestas deben llegar
a otro lugar.
Flujo común:
- Inicia una tarea de agente desde Telegram.
- Muévete a Discord, donde estás coordinando el trabajo.
- Envía
/dock_discord desde la sesión de Telegram.
- Mantén la misma sesión de OpenClaw, pero recibe las respuestas futuras en Discord.
Configuración requerida
El acoplamiento requiere session.identityLinks. El remitente de origen y el par de destino
deben estar en el mismo grupo de identidad:
{
session: {
identityLinks: {
alice: ["telegram:123", "discord:456", "slack:U123"],
},
},
}
| Valor | Significado |
|---|
telegram:123 | id de remitente de Telegram 123 |
discord:456 | id de par directo de Discord 456 |
slack:U123 | id de usuario de Slack U123 |
alice arriba) es solo el nombre del grupo de identidad compartido. Los comandos de acoplamiento
usan los valores con prefijo de canal para demostrar que el remitente de origen y
el par de destino son la misma persona.
Comandos
Los comandos de acoplamiento se generan a partir de los plugins de canal cargados que admiten comandos
nativos. Comandos incluidos actuales:
| 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 |
Qué cambia
El acoplamiento actualiza los campos de entrega de la sesión activa:
| Campo de sesión | Ejemplo después de /dock_discord |
|---|
lastChannel | discord |
lastTo | 456 |
lastAccountId | la cuenta del canal de destino, o default |
Qué no cambia
El acoplamiento no:
- crea cuentas de canal
- conecta un nuevo bot de Discord, Telegram, Slack o Mattermost
- concede acceso a un usuario
- omite las listas de permitidos del canal ni las políticas de MD
- mueve el historial de 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 dice que el remitente no está vinculado.
Añade tanto el remitente actual como el par de destino al mismo grupo de
session.identityLinks. Por ejemplo, si el remitente de Telegram 123 debe acoplarse
al par de Discord 456, incluye tanto telegram:123 como discord:456.
El comando dice que no existe ninguna sesión activa.
Acopla desde una sesión existente de chat directo. El comando necesita una entrada de sesión activa
para poder conservar la nueva ruta.
Las respuestas todavía van al canal anterior.
Comprueba que el comando respondió con un mensaje de éxito y confirma que el id del par de destino
coincide con el id usado por ese canal. El acoplamiento solo cambia la ruta de la sesión
activa; otra sesión aún puede enrutar a otro lugar.
Necesito volver a cambiar.
Envía el comando correspondiente para el canal original, como /dock_telegram o
/dock-telegram, desde un remitente vinculado.