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

渠道接收路径遵循一个流程：

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

使用 `openclaw/plugin-sdk/channel-inbound` 处理入站事件规范化、格式化、根目录和编排。使用
`openclaw/plugin-sdk/channel-outbound` 处理原生发送、回执、持久化投递和实时预览行为。

## 核心辅助函数

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

* `buildChannelInboundEventContext(...)`：将规范化的渠道事实投射到 prompt/会话上下文中。通过 `channelContext` 传递渠道拥有的发送者/聊天元数据，插件钩子会将其视为 `ctx.channelContext`。从此子路径扩展 `PluginHookChannelSenderContext` 或 `PluginHookChannelChatContext`，以添加渠道特定字段。
* `runChannelInboundEvent(...)`：对一个入站平台事件运行摄取、分类、预检、解析、记录、分发和收尾。
* `dispatchChannelInboundReply(...)`：使用投递适配器记录并分发一个已组装的入站回复。

已经接收注入式插件运行时对象的内置/原生渠道，可以改为调用 `runtime.channel.inbound.*` 下的相同辅助函数，而不是直接导入此子路径：

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

为兼容性分发器组装 `dispatchChannelInboundReply(...)` 输入，这类分发器会把平台投递保留在投递适配器中。新的发送路径应改用来自 `channel-outbound` 的消息适配器和持久化消息辅助函数。

## 迁移

`runtime.channel.turn.*` 运行时别名已移除。请使用：

* `runtime.channel.inbound.run(...)` 用于原始入站事件。
* `runtime.channel.inbound.dispatchReply(...)` 用于已组装的回复上下文。
* `runtime.channel.inbound.buildContext(...)` 用于入站上下文载荷。
* `runtime.channel.inbound.runPreparedReply(...)` 已弃用，仅用于渠道拥有、且已经组装自身分发闭包的预备分发路径。

新的插件代码不应引入以 `turn` 命名的渠道 API。将模型或智能体轮次词汇保留在智能体/提供商代码中；渠道插件使用入站、消息、投递和回复等术语。