チャネル受信 API

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

​

コアヘルパー

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

• buildChannelInboundEventContext(...): 正規化されたチャンネルのファクトを プロンプト/セッションコンテキストへ投影します。channelContext を使用して、チャンネル所有の 送信者/チャットメタデータを Plugin hook ctx.channelContext に渡します。 チャンネル固有フィールドには、このサブパスの PluginHookChannelSenderContext または PluginHookChannelChatContext を拡張します。
• runChannelInboundEvent(...): 1 つの受信プラットフォームイベントについて、取り込み、分類、事前確認、解決、 記録、ディスパッチ、完了処理を実行します。
• 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(...)。