API sortante des canaux

Les plugins de canal doivent exposer le comportement des messages sortants depuis openclaw/plugin-sdk/channel-outbound. Utilisez openclaw/plugin-sdk/channel-inbound pour l’orchestration de la réception, du contexte et de la distribution.

Le cœur possède la mise en file d’attente, la durabilité, la politique de nouvelle tentative générique, les hooks, les reçus et l’outil message partagé. Le plugin possède les appels natifs send/edit/delete, la normalisation des cibles, les fils de discussion de la plateforme, les citations sélectionnées, les indicateurs de notification, l’état du compte et les effets de bord propres à la plateforme.

Adaptateur

La plupart des plugins définissent un adaptateur message :

   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,        }),      };    },  },});

Ne déclarez que les capacités que le transport natif préserve réellement. Couvrez chaque capacité déclarée d’envoi, de reçu, d’aperçu en direct et d’accusé de réception avec les helpers de contrat exportés depuis ce sous-chemin.

Adaptateurs sortants existants

Si le canal dispose déjà d’un adaptateur outbound compatible, dérivez l’adaptateur de message au lieu de dupliquer le code d’envoi :

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

Envois durables

Les helpers d’envoi du runtime résident également dans channel-outbound :

• sendDurableMessageBatch(...)
• withDurableMessageSendContext(...)
• deliverInboundReplyWithMessageSendContext(...)
• helpers de streaming/progression des brouillons tels que resolveChannelDraftStreamingChunking(...)

sendDurableMessageBatch(...) renvoie un résultat explicite :

• sent : au moins un message visible de la plateforme a été livré.
• suppressed : aucun message de plateforme ne doit être considéré comme manquant.
• partial_failed : au moins un message de plateforme a été livré avant l’échec d’une charge utile ou d’un effet de bord ultérieur.
• failed : aucun reçu de plateforme n’a été produit.

Utilisez payloadOutcomes lorsqu’un lot mélange des charges utiles envoyées, supprimées et échouées. N’inférez pas l’annulation d’un hook à partir d’un résultat de livraison directe hérité vide.

Distribution de compatibilité

La distribution des réponses entrantes doit être assemblée via dispatchChannelInboundReply(...) depuis channel-inbound. Conservez la livraison propre à la plateforme dans l’adaptateur de livraison ; utilisez channel-outbound pour les adaptateurs de message, les envois durables, les reçus, l’aperçu en direct et les options de pipeline de réponse.