API de entrada del canal

Las rutas de recepción de los canales siguen un único flujo:

evento de la plataforma -> hechos/contexto de entrada -> respuesta del agente -> entrega del mensaje

Use openclaw/plugin-sdk/channel-inbound para la normalización de eventos de entrada, el formato, las raíces y la orquestación. Use openclaw/plugin-sdk/channel-outbound para el envío nativo, la confirmación, la entrega duradera y el comportamiento de la vista previa en tiempo real.

Funciones auxiliares principales

   buildChannelInboundEventContext,  runChannelInboundEvent,  dispatchChannelInboundReply,} from "openclaw/plugin-sdk/channel-inbound";

• buildChannelInboundEventContext(...): proyecta los hechos normalizados del canal en el contexto del prompt y de la sesión. Pase los metadatos del remitente y del chat gestionados por el canal mediante channelContext, que los hooks del Plugin reciben como ctx.channelContext. Amplíe PluginHookChannelSenderContext o PluginHookChannelChatContext desde esta subruta para los campos específicos del canal.
• runChannelInboundEvent(...): ejecuta la ingesta, clasificación, comprobación previa, resolución, registro, despacho y finalización de un evento de entrada de la plataforma.
• dispatchChannelInboundReply(...): registra y despacha una respuesta de entrada ya ensamblada mediante un adaptador de entrega.

Los canales integrados o nativos que ya reciben el objeto inyectado del entorno de ejecución del Plugin pueden invocar las mismas funciones auxiliares mediante runtime.channel.inbound.*, en lugar de importar directamente esta subruta:

await runtime.channel.inbound.run({  channel: "demo",  accountId,  raw: platformEvent,  adapter: {    ingest: normalizePlatformEvent,    resolveTurn: resolveInboundReply,  },});

Ensamble las entradas de dispatchChannelInboundReply(...) para los despachadores de compatibilidad que mantienen la entrega de la plataforma en el adaptador de entrega. Las nuevas rutas de envío deben usar adaptadores de mensajes y funciones auxiliares de mensajes duraderos de channel-outbound.

Migración

Se eliminaron los alias de entorno de ejecución runtime.channel.turn.*. Use:

• runtime.channel.inbound.run(...) para eventos de entrada sin procesar.
• runtime.channel.inbound.dispatchReply(...) para contextos de respuesta ensamblados.
• runtime.channel.inbound.buildContext(...) para cargas útiles de contexto de entrada.
• runtime.channel.inbound.runPreparedReply(...), obsoleto, solo para rutas de despacho preparado gestionadas por el canal que ya ensamblan su propio cierre de despacho.

El código nuevo de los Plugins no debe introducir API de canales con nombres basados en turn. Mantenga la terminología de turnos del modelo o del agente dentro del código del agente o proveedor; los Plugins de canal usan los términos entrada, mensaje, entrega y respuesta.