---
read_when:
    - Bạn đang xây dựng hoặc tái cấu trúc đường dẫn gửi của Plugin kênh nhắn tin
    - Bạn cần cơ chế gửi câu trả lời cuối bền vững, biên nhận, hoàn tất bản xem trước trực tiếp, hoặc chính sách xác nhận đã nhận
    - Bạn đang di chuyển từ channel-message, channel-message-runtime, hoặc các trình trợ giúp điều phối trả lời cũ
summary: 'API vòng đời tin nhắn gửi đi cho các Plugin kênh: bộ điều hợp, biên nhận, gửi bền vững, xem trước trực tiếp và trình trợ giúp quy trình phản hồi'
title: API gửi ra của kênh
x-i18n:
    generated_at: "2026-06-27T17:57:20Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: e9d2681c06ac808d7fe0218d1a48e6ba06ea5e80270816535d957782193e488f
    source_path: plugins/sdk-channel-outbound.md
    workflow: 16
---

Channel plugin nên phơi bày hành vi tin nhắn đi từ
`openclaw/plugin-sdk/channel-outbound`. Dùng
`openclaw/plugin-sdk/channel-inbound` cho điều phối nhận/ngữ cảnh/phân phối.

Core sở hữu việc xếp hàng, độ bền, chính sách thử lại chung, hook, biên nhận, và
công cụ `message` dùng chung. Plugin sở hữu các lệnh gọi gửi/chỉnh sửa/xóa gốc, chuẩn hóa đích,
luồng hội thoại theo nền tảng, trích dẫn đã chọn, cờ thông báo, trạng thái tài khoản,
và các tác dụng phụ đặc thù nền tảng.

## Bộ chuyển đổi

Hầu hết Plugin định nghĩa một bộ chuyển đổi `message`:

```ts
import {
  defineChannelMessageAdapter,
  createMessageReceiptFromOutboundResults,
} from "openclaw/plugin-sdk/channel-outbound";

export const demoMessageAdapter = defineChannelMessageAdapter({
  id: "demo",
  durableFinal: {
    capabilities: {
      text: true,
      replyTo: true,
      thread: true,
      messageSendingHooks: true,
    },
  },
  send: {
    text: async ({ cfg, to, text, accountId, replyToId, threadId, signal }) => {
      const sent = await sendDemoMessage({
        cfg,
        to,
        text,
        accountId: accountId ?? undefined,
        replyToId: replyToId ?? undefined,
        threadId: threadId == null ? undefined : String(threadId),
        signal,
      });

      return {
        receipt: createMessageReceiptFromOutboundResults({
          results: [{ channel: "demo", messageId: sent.id, conversationId: to }],
          kind: "text",
          threadId: threadId == null ? undefined : String(threadId),
          replyToId: replyToId ?? undefined,
        }),
      };
    },
  },
});
```

Chỉ khai báo các năng lực mà transport gốc thực sự bảo toàn. Bao phủ từng
năng lực gửi, biên nhận, xem trước trực tiếp, và xác nhận nhận đã khai báo bằng các
helper hợp đồng được xuất từ đường dẫn con này.

## Bộ chuyển đổi gửi đi hiện có

Nếu kênh đã có bộ chuyển đổi `outbound` tương thích, hãy dẫn xuất bộ chuyển đổi tin nhắn
thay vì sao chép mã gửi:

```ts
import { createChannelMessageAdapterFromOutbound } from "openclaw/plugin-sdk/channel-outbound";

export const messageAdapter = createChannelMessageAdapterFromOutbound({
  id: "demo",
  outbound,
  durableFinal: {
    capabilities: {
      text: true,
      media: true,
    },
  },
});
```

## Lượt gửi bền vững

Các helper gửi runtime cũng nằm trên `channel-outbound`:

- `sendDurableMessageBatch(...)`
- `withDurableMessageSendContext(...)`
- `deliverInboundReplyWithMessageSendContext(...)`
- các helper phát trực tuyến/tiến trình bản nháp như `resolveChannelDraftStreamingChunking(...)`

`sendDurableMessageBatch(...)` trả về một kết quả tường minh:

- `sent`: ít nhất một tin nhắn nền tảng hiển thị đã được phân phối.
- `suppressed`: không tin nhắn nền tảng nào nên được xem là bị thiếu.
- `partial_failed`: ít nhất một tin nhắn nền tảng đã được phân phối trước khi một payload hoặc tác dụng phụ sau đó thất bại.
- `failed`: không biên nhận nền tảng nào được tạo ra.

Dùng `payloadOutcomes` khi một batch trộn các payload đã gửi, bị chặn, và thất bại.
Không suy luận việc hủy hook từ một kết quả phân phối trực tiếp kế thừa rỗng.

## Phân phối tương thích

Phân phối trả lời đến nên được lắp ráp thông qua
`dispatchChannelInboundReply(...)` từ `channel-inbound`. Giữ việc phân phối nền tảng
trong bộ chuyển đổi phân phối; dùng `channel-outbound` cho bộ chuyển đổi tin nhắn,
gửi bền vững, biên nhận, xem trước trực tiếp, và các tùy chọn pipeline trả lời.