API für eingehende Kanalnachrichten

Empfangspfade für Channels folgen einem einheitlichen Ablauf:

Plattformereignis -> eingehende Fakten/Kontext -> Agentenantwort -> Nachrichtenzustellung

Verwenden Sie openclaw/plugin-sdk/channel-inbound für die Normalisierung, Formatierung, Roots und Orchestrierung eingehender Ereignisse. Verwenden Sie openclaw/plugin-sdk/channel-outbound für nativen Versand, Empfangsbestätigungen, dauerhafte Zustellung und das Verhalten der Live-Vorschau.

Zentrale Hilfsfunktionen

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

• buildChannelInboundEventContext(...): überträgt normalisierte Channel-Fakten in den Prompt-/Sitzungskontext. Übergeben Sie vom Channel verwaltete Metadaten zu Absender und Chat über channelContext, die Plugin-Hooks als ctx.channelContext erhalten. Erweitern Sie PluginHookChannelSenderContext oder PluginHookChannelChatContext aus diesem Unterpfad um Channel-spezifische Felder.
• runChannelInboundEvent(...): führt Aufnahme, Klassifizierung, Vorabprüfung, Auflösung, Aufzeichnung, Weiterleitung und Abschluss für ein eingehendes Plattformereignis aus.
• dispatchChannelInboundReply(...): zeichnet eine bereits zusammengestellte eingehende Antwort auf und leitet sie mit einem Zustelladapter weiter.

Gebündelte/native Channels, die bereits das injizierte Plugin-Laufzeitobjekt erhalten, können dieselben Hilfsfunktionen unter runtime.channel.inbound.* aufrufen, anstatt diesen Unterpfad direkt zu importieren:

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

Stellen Sie Eingaben für dispatchChannelInboundReply(...) für Kompatibilitäts-Dispatcher zusammen, bei denen die Plattformzustellung im Zustelladapter verbleibt. Neue Versandpfade sollten stattdessen Nachrichtenadapter und Hilfsfunktionen für dauerhafte Nachrichten aus channel-outbound verwenden.

Migration

Die Laufzeit-Aliasse runtime.channel.turn.* wurden entfernt. Verwenden Sie:

• runtime.channel.inbound.run(...) für rohe eingehende Ereignisse.
• runtime.channel.inbound.dispatchReply(...) für zusammengestellte Antwortkontexte.
• runtime.channel.inbound.buildContext(...) für eingehende Kontext-Nutzlasten.
• runtime.channel.inbound.runPreparedReply(...), veraltet, ausschließlich für vom Channel verwaltete vorbereitete Weiterleitungspfade, die bereits ihre eigene Weiterleitungs-Closure zusammenstellen.

Neuer Plugin-Code sollte keine mit turn benannten Channel-APIs einführen. Verwenden Sie die Terminologie für Modell- oder Agentendurchläufe nur im Agenten-/Provider-Code; Channel-Plugins verwenden Begriffe für Eingang, Nachricht, Zustellung und Antwort.