Hilos y sesiones de Matrix en OpenClaw
El ámbito de sesión de los mensajes directos, los modos de respuesta en hilo, la herencia de hilos, las vinculaciones de conversación de ACP, la política de vinculación de hilos y el historial de salas limitado a mensajes pendientes
Matrix admite hilos nativos, y OpenClaw trata los hilos y el enrutamiento de sesiones como dos decisiones independientes: dónde se publica una respuesta y a qué sesión pertenece una conversación. Si añades las vinculaciones de ACP, que convierten una sala o un hilo en un espacio de trabajo de programación persistente, y una ventana de historial de sala que solo lleva lo que el agente aún no ha visto, tienes el panorama completo. Estos son los dos ajustes, la herencia y los comandos, las vinculaciones de ACP y su configuración, y las reglas del historial.
Los dos ajustes
- El ámbito de sesión de los mensajes directos decide cómo se corresponden las salas de mensajes directos con las sesiones: por usuario, el valor predeterminado, comparte una sesión entre todas las salas de mensajes directos con el mismo interlocutor enrutado, mientras que por sala da a cada sala de mensajes directos de Matrix su propia clave de sesión, incluso para el mismo interlocutor.
- La respuesta en hilo decide dónde publica el bot: off mantiene las respuestas en el nivel superior y los mensajes entrantes en hilo en la sesión padre; inbound responde dentro de un hilo solo cuando el mensaje entrante ya estaba en él; y always responde dentro de un hilo cuya raíz es el mensaje que lo activó y enruta esa conversación a través de una sesión limitada al hilo desde el primer disparo; una sobrescritura solo para mensajes directos puede mantener planos los mensajes directos mientras los hilos de las salas siguen aislados.
- Seleccionar un destino de respuesta dentro de un hilo conserva tanto el hilo como el mensaje seleccionado, y los metadatos de respuesta que los clientes antiguos reciben en los mensajes en hilo no se tratan como un mensaje citado en el contexto del agente.
- Los mensajes entrantes en hilo incluyen la raíz del hilo como contexto adicional, los envíos de la herramienta de mensajes heredan automáticamente el hilo actual cuando apuntan a la misma sala o al mismo usuario de mensajes directos, salvo que se indique un id de hilo, la reutilización del usuario de destino en mensajes directos solo se aplica cuando los metadatos de la sesión demuestran que es el mismo interlocutor en la misma cuenta, y los comandos de sesión unbind, agents, idle y max-age, junto con los lanzamientos de ACP vinculados a hilos, funcionan en las salas y los mensajes directos de Matrix.
Las vinculaciones de conversación explícitas siempre prevalecen sobre sessionScope; las salas y los hilos vinculados conservan la sesión de destino elegida.
Vinculaciones de ACP
Las salas, los mensajes directos y los hilos existentes de Matrix pueden convertirse en espacios de trabajo de ACP persistentes sin cambiar la superficie de chat. El flujo del operador es un solo comando: un spawn de ACP con el indicador bind-here dentro del mensaje directo, la sala o el hilo que quieras seguir usando; en un mensaje directo o una sala de nivel superior, la superficie actual sigue siendo el chat y los mensajes futuros se enrutan a la sesión de ACP lanzada; dentro de un hilo existente, el indicador vincula ese hilo en el sitio; los comandos de nueva sesión y de restablecimiento restablecen en el sitio la misma sesión vinculada; y un comando close de ACP termina la sesión y elimina la vinculación. Bind-here nunca crea un hilo hijo; crear o vincular un hilo hijo mediante la opción de hilo del comando spawn depende del ajuste spawn-sessions. Cuando OpenClaw detecta que una sala de mensajes directos colisiona con otra en la misma sesión compartida, publica un aviso único que sugiere el ámbito por sala, pero solo mientras las vinculaciones de hilos están activadas.
Configuración e historial
- Matrix hereda los valores predeterminados globales de vinculación de hilos, con sobrescrituras por canal: activación, horas de inactividad, antigüedad máxima, un indicador spawn-sessions que controla los lanzamientos de hilos tanto de subagentes como de ACP y está activado por defecto, y un contexto de lanzamiento predeterminado; la corrección de doctor migra las claves de lanzamiento por tipo obsoletas, y un contexto de lanzamiento aislado impide que los lanzamientos de hilos de subagentes nativos bifurquen la transcripción padre.
- Un límite de historial define cuántos mensajes recientes de la sala se incluyen como historial entrante cuando un mensaje de la sala activa al agente; si no se define, recurre al límite global de chats de grupo, y si ninguno de los dos está definido, vale cero, es decir, desactivado; el historial de sala es solo para salas, y los mensajes directos mantienen el historial de sesión normal.
- El historial de sala es solo de pendientes: OpenClaw almacena en búfer los mensajes de la sala que no activaron una respuesta, toma una instantánea de esa ventana cuando llega una mención u otro disparador, deja el disparador actual fuera del bloque de historial porque es el cuerpo entrante y reutiliza la instantánea original en los reintentos del mismo evento en lugar de ir desplazándose hacia delante.
OpenClaw en Matrix es el artículo del canal que este amplía, y las sesiones de OpenClaw, las claves y los restablecimientos sobre los que se construyen estas correspondencias.
La misma forma en Discord
Las vinculaciones de hilos, los controles de inactividad y de antigüedad máxima y las vinculaciones de ACP son una política compartida entre canales, así que un flujo de trabajo aprendido en uno se traslada a los demás. Hilos y sesiones de Discord en OpenClaw es la versión de Discord de la misma página, y los subagentes de OpenClaw, los lanzamientos que reciben sesiones vinculadas a hilos.
En Diali
Matrix está en la lista de canales que se pueden conectar en Diali, junto con WhatsApp, Telegram, Discord, Slack, Mattermost, SMS y voz: la cuenta del homeserver y la lista de salas permitidas son tuyas; el Gateway es nuestro. OpenClaw alojado en Diali es el asistente, y conecta tu primer canal en cinco minutos explica cómo se vinculan esos canales.
- El ámbito decide la sesión; el hilo decide la respuesta.
- Las vinculaciones prevalecen; bind-here nunca crea un hilo.
- El historial es solo de pendientes y la instantánea se mantiene estable en los reintentos.
Deja de leer sobre ello y crea el tuyo
Configura un agente, elige un canal y ponlo a trabajar dentro de la aplicación que ya tienes abierta.
