> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API de entrada del canal

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

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
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

```ts theme={"theme":{"light":"min-light","dark":"min-dark"}}
import {
  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.

```ts theme={"theme":{"light":"min-light","dark":"min-dark"}}
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.