> ## 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.

# Interfejs API przychodzący kanału

Wtyczki kanałów powinny modelować ścieżki odbioru rzeczownikami związanymi z przychodzącymi zdarzeniami i wiadomościami:

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

Używaj `openclaw/plugin-sdk/channel-inbound` do normalizacji zdarzeń przychodzących,
formatowania, korzeni i orkiestracji. Używaj
`openclaw/plugin-sdk/channel-outbound` do natywnego
wysyłania, potwierdzeń odbioru, trwałego dostarczania i działania podglądu na żywo.

## Główne helpery

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

* `buildChannelInboundEventContext(...)`: rzutuje znormalizowane fakty kanału na
  kontekst promptu/sesji. Użyj `channelContext`, aby przekazać należące do kanału
  metadane nadawcy/czatu do hooka wtyczki `ctx.channelContext`; rozszerz
  `PluginHookChannelSenderContext` lub `PluginHookChannelChatContext` z tej
  ścieżki podrzędnej o pola specyficzne dla kanału.
* `runChannelInboundEvent(...)`: uruchamia pobieranie, klasyfikację, kontrolę wstępną, rozwiązywanie,
  rejestrowanie, wysyłkę i finalizację dla jednego przychodzącego zdarzenia platformy.
* `dispatchChannelInboundReply(...)`: rejestruje i wysyła już złożoną
  odpowiedź przychodzącą za pomocą adaptera dostarczania.

Wstrzyknięte środowisko uruchomieniowe wtyczki udostępnia te same wysokopoziomowe helpery pod
`runtime.channel.inbound.*` dla kanałów dołączonych/natywnych, które już otrzymują
obiekt środowiska uruchomieniowego.

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

Dispatchery zgodności powinny składać dane wejściowe `dispatchChannelInboundReply(...)`
i utrzymywać dostarczanie platformowe w adapterze dostarczania. Nowe ścieżki wysyłania powinny
preferować adaptery wiadomości i trwałe helpery wiadomości.

## Migracja

Stare aliasy środowiska uruchomieniowego `runtime.channel.turn.*` zostały usunięte. Używaj:

* `runtime.channel.inbound.run(...)` dla surowych zdarzeń przychodzących.
* `runtime.channel.inbound.dispatchReply(...)` dla złożonych kontekstów odpowiedzi.
* `runtime.channel.inbound.buildContext(...)` dla ładunków kontekstu przychodzącego.
* `runtime.channel.inbound.runPreparedReply(...)` tylko dla należących do kanału przygotowanych
  ścieżek wysyłki, które już składają własne domknięcie wysyłki.

Nowy kod wtyczki nie powinien wprowadzać interfejsów API kanału nazwanych `turn`. Słownictwo tur modelu lub
agenta trzymaj w kodzie agenta/dostawcy; wtyczki kanałów używają terminów dotyczących danych przychodzących,
wiadomości, dostarczania i odpowiedzi.