API đầu vào của kênh

Các đường dẫn tiếp nhận của kênh tuân theo một luồng:

sự kiện nền tảng -> dữ kiện/ngữ cảnh đầu vào -> phản hồi của tác nhân -> chuyển phát tin nhắn

Sử dụng openclaw/plugin-sdk/channel-inbound để chuẩn hóa sự kiện đầu vào, định dạng, xác định gốc và điều phối. Sử dụng openclaw/plugin-sdk/channel-outbound cho thao tác gửi gốc, biên nhận, chuyển phát bền vững và hành vi xem trước trực tiếp.

Các hàm hỗ trợ cốt lõi

   buildChannelInboundEventContext,  runChannelInboundEvent,  dispatchChannelInboundReply,} from "openclaw/plugin-sdk/channel-inbound";

• buildChannelInboundEventContext(...): ánh xạ các dữ kiện kênh đã chuẩn hóa vào ngữ cảnh lời nhắc/phiên. Truyền siêu dữ liệu người gửi/cuộc trò chuyện do kênh sở hữu qua channelContext, mà các hook của plugin sẽ nhận dưới dạng ctx.channelContext. Mở rộng PluginHookChannelSenderContext hoặc PluginHookChannelChatContext từ đường dẫn con này cho các trường dành riêng cho kênh.
• runChannelInboundEvent(...): chạy các bước tiếp nhận, phân loại, kiểm tra sơ bộ, phân giải, ghi lại, điều phối và hoàn tất cho một sự kiện nền tảng đầu vào.
• dispatchChannelInboundReply(...): ghi lại và điều phối một phản hồi đầu vào đã được tập hợp bằng bộ điều hợp chuyển phát.

Các kênh đi kèm/gốc đã nhận được đối tượng môi trường chạy plugin được chèn có thể gọi cùng các hàm hỗ trợ qua runtime.channel.inbound.* thay vì nhập trực tiếp đường dẫn con này:

await runtime.channel.inbound.run({  channel: "demo",  accountId,  raw: platformEvent,  adapter: {    ingest: normalizePlatformEvent,    resolveTurn: resolveInboundReply,  },});

Tập hợp các đầu vào của dispatchChannelInboundReply(...) cho những bộ điều phối tương thích vẫn duy trì việc chuyển phát qua nền tảng trong bộ điều hợp chuyển phát. Các đường dẫn gửi mới nên sử dụng bộ điều hợp tin nhắn và các hàm hỗ trợ tin nhắn bền vững từ channel-outbound.

Di chuyển

Các bí danh môi trường chạy runtime.channel.turn.* đã bị loại bỏ. Sử dụng:

• runtime.channel.inbound.run(...) cho các sự kiện đầu vào thô.
• runtime.channel.inbound.dispatchReply(...) cho các ngữ cảnh phản hồi đã được tập hợp.
• runtime.channel.inbound.buildContext(...) cho các tải trọng ngữ cảnh đầu vào.
• runtime.channel.inbound.runPreparedReply(...), đã lỗi thời, chỉ dành cho các đường dẫn điều phối được chuẩn bị do kênh sở hữu và đã tự tập hợp closure điều phối riêng.

Mã plugin mới không nên đưa vào các API kênh có tên chứa turn. Chỉ sử dụng thuật ngữ lượt của mô hình hoặc tác nhân trong mã tác nhân/nhà cung cấp; các plugin kênh sử dụng thuật ngữ đầu vào, tin nhắn, chuyển phát và phản hồi.