واجهة 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(...)، وهي مهملة، فقط لمسارات الإرسال المُعَدّة التي تملكها القناة وتُجمّع بالفعل دالة الإرسال الخاصة بها.