> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API für eingehende Kanäle

Channel-Plugins sollten Empfangspfade mit den Begriffen inbound und message modellieren:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
platform event -> inbound facts/context -> agent reply -> message delivery
```

Verwenden Sie `openclaw/plugin-sdk/channel-inbound` für die Normalisierung
eingehender Ereignisse, Formatierung, Roots und Orchestrierung. Verwenden Sie
`openclaw/plugin-sdk/channel-outbound` für natives Senden, Empfangsbestätigungen,
dauerhafte Zustellung und Live-Vorschauverhalten.

## Kernhilfen

```ts theme={"theme":{"light":"min-light","dark":"min-dark"}}
import {
  buildChannelInboundEventContext,
  runChannelInboundEvent,
  dispatchChannelInboundReply,
} from "openclaw/plugin-sdk/channel-inbound";
```

* `buildChannelInboundEventContext(...)`: projiziert normalisierte Channel-Fakten
  in den Prompt-/Sitzungskontext. Verwenden Sie `channelContext`, um
  sender/chat-Metadaten im Besitz des Channels an den Plugin-Hook
  `ctx.channelContext` weiterzugeben; erweitern Sie
  `PluginHookChannelSenderContext` oder `PluginHookChannelChatContext` aus diesem
  Unterpfad für channelspezifische Felder.
* `runChannelInboundEvent(...)`: führt Ingest, Klassifizierung, Preflight,
  Auflösung, Aufzeichnung, Dispatch und Finalisierung für ein eingehendes
  Plattformereignis aus.
* `dispatchChannelInboundReply(...)`: zeichnet eine bereits zusammengestellte
  eingehende Antwort auf und dispatcht sie mit einem Zustellungsadapter.

Die injizierte Plugin-Laufzeit stellt dieselben High-Level-Hilfen unter
`runtime.channel.inbound.*` für gebündelte/native Channels bereit, die bereits das
Laufzeitobjekt erhalten.

```ts theme={"theme":{"light":"min-light","dark":"min-dark"}}
await runtime.channel.inbound.run({
  channel: "demo",
  accountId,
  raw: platformEvent,
  adapter: {
    ingest: normalizePlatformEvent,
    resolveTurn: resolveInboundReply,
  },
});
```

Kompatibilitäts-Dispatcher sollten Eingaben für
`dispatchChannelInboundReply(...)` zusammenstellen und die Plattformzustellung im
Zustellungsadapter belassen. Neue Sendepfade sollten Message-Adapter und
dauerhafte Message-Hilfen bevorzugen.

## Migration

Die alten 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-Payloads.
* `runtime.channel.inbound.runPreparedReply(...)` nur für vorbereitete
  Dispatch-Pfade im Besitz des Channels, die bereits ihre eigene
  Dispatch-Closure zusammenstellen.

Neuer Plugin-Code sollte keine Channel-APIs mit `turn` im Namen einführen. Halten
Sie Modell- oder Agent-Turn-Vokabular in Agent-/Provider-Code; Channel-Plugins
verwenden Begriffe wie inbound, message, delivery und reply.