API de entrada del canal

Los plugins de canal deben modelar las rutas de recepción con sustantivos de entrada y de mensaje:

platform event -> inbound facts/context -> agent reply -> message delivery

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

Helpers principales

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

• buildChannelInboundEventContext(...): proyecta los datos normalizados del canal en el contexto de prompt/sesión. Usa channelContext para pasar metadatos de remitente/chat propiedad del canal al hook de plugin ctx.channelContext; amplía PluginHookChannelSenderContext o PluginHookChannelChatContext desde esta subruta para campos específicos del canal.
• runChannelInboundEvent(...): ejecuta la ingesta, clasificación, preflight, resolución, registro, despacho y finalización de un evento de plataforma entrante.
• dispatchChannelInboundReply(...): registra y despacha una respuesta entrante ya ensamblada con un adaptador de entrega.

El runtime de plugin inyectado expone los mismos helpers de alto nivel bajo runtime.channel.inbound.* para canales empaquetados/nativos que ya reciben el objeto de runtime.

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

Los despachadores de compatibilidad deben ensamblar las entradas de dispatchChannelInboundReply(...) y mantener la entrega de plataforma en el adaptador de entrega. Las nuevas rutas de envío deben preferir adaptadores de mensaje y helpers de mensajes duraderos.

Migración

Los alias antiguos de runtime runtime.channel.turn.* se eliminaron. Usa:

• runtime.channel.inbound.run(...) para eventos entrantes sin procesar.
• runtime.channel.inbound.dispatchReply(...) para contextos de respuesta ensamblados.
• runtime.channel.inbound.buildContext(...) para cargas útiles de contexto entrante.
• runtime.channel.inbound.runPreparedReply(...) solo para rutas de despacho preparadas propiedad del canal que ya ensamblan su propio cierre de despacho.

El código nuevo de plugin no debe introducir API de canal con nombre turn. Mantén el vocabulario de turno de modelo o agente dentro del código de agente/proveedor; los plugins de canal usan términos de entrada, mensaje, entrega y respuesta.