API de entrada do canal

evento da plataforma -> fatos/contexto de entrada -> resposta do agente -> entrega da mensagem

​

Auxiliares principais

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

• buildChannelInboundEventContext(...): projeta os fatos normalizados do canal no contexto do prompt/da sessão. Passe os metadados do remetente/chat pertencentes ao canal por meio de channelContext, que os hooks do plugin recebem como ctx.channelContext. Amplie PluginHookChannelSenderContext ou PluginHookChannelChatContext a partir deste subcaminho para campos específicos do canal.
• runChannelInboundEvent(...): executa ingestão, classificação, pré-verificação, resolução, registro, encaminhamento e finalização para um evento de entrada da plataforma.
• dispatchChannelInboundReply(...): registra e encaminha uma resposta de entrada já montada com um adaptador de entrega.

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

​

Migração

• runtime.channel.inbound.run(...) para eventos de entrada brutos.
• runtime.channel.inbound.dispatchReply(...) para contextos de resposta montados.
• runtime.channel.inbound.buildContext(...) para cargas de contexto de entrada.
• runtime.channel.inbound.runPreparedReply(...), descontinuado, somente para caminhos de encaminhamento preparado pertencentes ao canal que já montam seu próprio closure de encaminhamento.