---
read_when:
    - คุณกำลังสร้างหรือรีแฟกเตอร์เส้นทางการส่งของ Plugin ช่องทางข้อความ
    - คุณต้องการการส่งคำตอบสุดท้ายที่คงทน ใบรับ การสรุปผลตัวอย่างแสดงสด หรือนโยบายการยืนยันการรับ
    - คุณกำลังย้ายจากตัวช่วย dispatch การตอบกลับแบบเดิม หรือจาก channel-message หรือ channel-message-runtime
summary: 'API วงจรชีวิตข้อความขาออกสำหรับ Plugin ช่องทาง: อะแดปเตอร์ ใบรับข้อความ การส่งแบบคงทน ตัวอย่างสด และตัวช่วยไปป์ไลน์การตอบกลับ'
title: API ขาออกของช่องทาง
x-i18n:
    generated_at: "2026-06-27T18:06:42Z"
    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 ควรเปิดเผยพฤติกรรมข้อความขาออกจาก
`openclaw/plugin-sdk/channel-outbound` ใช้
`openclaw/plugin-sdk/channel-inbound` สำหรับการจัดการ receive/context/dispatch

Core เป็นเจ้าของคิว ความทนทาน นโยบาย retry ทั่วไป hooks receipts และเครื่องมือ
`message` ที่ใช้ร่วมกัน ส่วน Plugin เป็นเจ้าของการเรียก native send/edit/delete, การทำให้ target เป็นรูปแบบมาตรฐาน, platform threading, quotes ที่เลือก, notification flags, สถานะบัญชี และ side effects เฉพาะแพลตฟอร์ม

## อะแดปเตอร์

Plugin ส่วนใหญ่กำหนดอะแดปเตอร์ `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,
        }),
      };
    },
  },
});
```

ประกาศเฉพาะความสามารถที่ native transport รักษาไว้จริงเท่านั้น ครอบคลุมความสามารถของ
send, receipt, live-preview และ receive-ack แต่ละรายการที่ประกาศไว้ด้วย contract helpers
ที่ export จาก subpath นี้

## อะแดปเตอร์ขาออกที่มีอยู่

ถ้า channel มีอะแดปเตอร์ `outbound` ที่เข้ากันได้อยู่แล้ว ให้ derive message
adapter แทนการทำซ้ำโค้ด send:

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

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

## การส่งแบบทนทาน

runtime send helpers อยู่บน `channel-outbound` เช่นกัน:

- `sendDurableMessageBatch(...)`
- `withDurableMessageSendContext(...)`
- `deliverInboundReplyWithMessageSendContext(...)`
- draft streaming/progress helpers เช่น `resolveChannelDraftStreamingChunking(...)`

`sendDurableMessageBatch(...)` คืน outcome ที่ชัดเจนหนึ่งรายการ:

- `sent`: มีข้อความแพลตฟอร์มที่มองเห็นได้อย่างน้อยหนึ่งข้อความถูกส่งแล้ว
- `suppressed`: ไม่ควรถือว่าข้อความแพลตฟอร์มใด ๆ หายไป
- `partial_failed`: มีข้อความแพลตฟอร์มอย่างน้อยหนึ่งข้อความถูกส่งก่อนที่ payload หรือ side effect ภายหลังจะล้มเหลว
- `failed`: ไม่มี platform receipt ถูกสร้างขึ้น

ใช้ `payloadOutcomes` เมื่อ batch ผสม payload ที่ส่งแล้ว ถูก suppress และล้มเหลว
อย่าอนุมาน hook cancellation จากผลลัพธ์ legacy direct-delivery ที่ว่างเปล่า

## Compatibility Dispatch

Inbound reply dispatch ควรถูกประกอบผ่าน
`dispatchChannelInboundReply(...)` จาก `channel-inbound` เก็บ platform delivery
ไว้ใน delivery adapter; ใช้ `channel-outbound` สำหรับ message adapters,
durable sends, receipts, live preview และตัวเลือก reply pipeline