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

# Kanal gelen API'si

Kanal Plugin'leri, alma yollarını gelen ve ileti adlarıyla modellemelidir:

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

Gelen olay normalleştirme, biçimlendirme, kökler ve orkestrasyon için
`openclaw/plugin-sdk/channel-inbound` kullanın. Yerel gönderim, alındı bilgisi,
kalıcı teslim ve canlı önizleme davranışı için
`openclaw/plugin-sdk/channel-outbound` kullanın.

## Çekirdek Yardımcılar

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

* `buildChannelInboundEventContext(...)`: normalleştirilmiş kanal bilgilerini
  istem/oturum bağlamına yansıtın. Kanalın sahip olduğu gönderen/sohbet
  meta verilerini Plugin kancası `ctx.channelContext` içine geçirmek için
  `channelContext` kullanın; kanala özgü alanlar için bu alt yoldaki
  `PluginHookChannelSenderContext` veya `PluginHookChannelChatContext` türünü
  genişletin.
* `runChannelInboundEvent(...)`: tek bir gelen platform olayı için alma,
  sınıflandırma, ön denetim, çözümleme, kaydetme, gönderme ve sonlandırma
  işlemlerini çalıştırın.
* `dispatchChannelInboundReply(...)`: zaten derlenmiş bir gelen yanıtı bir teslim
  bağdaştırıcısıyla kaydedip gönderin.

Enjekte edilen Plugin çalışma zamanı, çalışma zamanı nesnesini zaten alan
paketlenmiş/yerel kanallar için aynı üst düzey yardımcıları
`runtime.channel.inbound.*` altında sunar.

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

Uyumluluk göndericileri `dispatchChannelInboundReply(...)` girdilerini
derlemeli ve platform teslimini teslim bağdaştırıcısında tutmalıdır. Yeni
gönderim yolları ileti bağdaştırıcılarını ve kalıcı ileti yardımcılarını tercih
etmelidir.

## Geçiş

Eski `runtime.channel.turn.*` çalışma zamanı takma adları kaldırıldı. Şunları
kullanın:

* Ham gelen olaylar için `runtime.channel.inbound.run(...)`.
* Derlenmiş yanıt bağlamları için `runtime.channel.inbound.dispatchReply(...)`.
* Gelen bağlam yükleri için `runtime.channel.inbound.buildContext(...)`.
* Yalnızca kendi gönderim kapanışını zaten derleyen, kanalın sahip olduğu
  hazırlanmış gönderim yolları için `runtime.channel.inbound.runPreparedReply(...)`.

Yeni Plugin kodu `turn` adlı kanal API'leri eklememelidir. Model veya agent
turn söz dağarcığını agent/sağlayıcı kodu içinde tutun; kanal Plugin'leri gelen,
ileti, teslim ve yanıt terimlerini kullanır.