API входящих сообщений канала

Plugin каналов должны моделировать пути получения через существительные inbound и message:

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

Используйте openclaw/plugin-sdk/channel-inbound для нормализации входящих событий, форматирования, корней и оркестрации. Используйте openclaw/plugin-sdk/channel-outbound для нативной отправки, подтверждений получения, надежной доставки и поведения живого предпросмотра.

Основные вспомогательные функции

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

• buildChannelInboundEventContext(...): проецирует нормализованные факты канала в контекст промпта/сессии. Используйте channelContext, чтобы передавать принадлежащие каналу метаданные отправителя/чата в хук Plugin ctx.channelContext; расширяйте PluginHookChannelSenderContext или PluginHookChannelChatContext из этого подпути для полей, специфичных для канала.
• runChannelInboundEvent(...): выполняет прием, классификацию, предварительную проверку, разрешение, запись, dispatch и финализацию для одного входящего события платформы.
• dispatchChannelInboundReply(...): записывает и отправляет уже собранный входящий ответ через адаптер доставки.

Внедренный рантайм Plugin предоставляет те же высокоуровневые вспомогательные функции в runtime.channel.inbound.* для встроенных/нативных каналов, которые уже получают объект рантайма.

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

Диспетчеры совместимости должны собирать входные данные dispatchChannelInboundReply(...) и держать доставку платформы в адаптере доставки. Новые пути отправки должны предпочитать адаптеры сообщений и вспомогательные функции надежных сообщений.

Миграция

Старые псевдонимы рантайма runtime.channel.turn.* были удалены. Используйте:

• runtime.channel.inbound.run(...) для сырых входящих событий.
• runtime.channel.inbound.dispatchReply(...) для собранных контекстов ответа.
• runtime.channel.inbound.buildContext(...) для полезных нагрузок входящего контекста.
• runtime.channel.inbound.runPreparedReply(...) только для принадлежащих каналу подготовленных путей dispatch, которые уже собирают собственное замыкание dispatch.

Новый код Plugin не должен вводить API каналов с именем turn. Держите лексику model или agent turn внутри кода агентов/провайдеров; Plugin каналов используют термины inbound, message, delivery и reply.