채널 인바운드 API

플랫폼 이벤트 -> 인바운드 정보/컨텍스트 -> 에이전트 응답 -> 메시지 전달

​

핵심 헬퍼

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

• buildChannelInboundEventContext(...): 정규화된 채널 정보를 프롬프트/세션 컨텍스트에 투영합니다. 채널이 소유한 발신자/채팅 메타데이터는 channelContext를 통해 전달하며, Plugin 훅에서는 이를 ctx.channelContext로 확인합니다. 채널별 필드를 추가하려면 이 하위 경로의 PluginHookChannelSenderContext 또는 PluginHookChannelChatContext를 확장합니다.
• runChannelInboundEvent(...): 하나의 인바운드 플랫폼 이벤트에 대해 수집, 분류, 사전 점검, 확인, 기록, 디스패치, 완료 처리를 실행합니다.
• dispatchChannelInboundReply(...): 이미 조립된 인바운드 응답을 전달 어댑터를 통해 기록하고 디스패치합니다.

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

​

마이그레이션

• 원시 인바운드 이벤트에는 runtime.channel.inbound.run(...)을 사용합니다.
• 조립된 응답 컨텍스트에는 runtime.channel.inbound.dispatchReply(...)를 사용합니다.
• 인바운드 컨텍스트 페이로드에는 runtime.channel.inbound.buildContext(...)를 사용합니다.
• 자체 디스패치 클로저를 이미 조립하는 채널 소유의 준비된 디스패치 경로에만 더 이상 권장되지 않는 runtime.channel.inbound.runPreparedReply(...)를 사용합니다.