Skip to main content
Ścieżki odbierania kanałów korzystają z jednego przepływu:
Użyj openclaw/plugin-sdk/channel-inbound do normalizacji zdarzeń wejściowych, formatowania, katalogów głównych i orkiestracji. Użyj openclaw/plugin-sdk/channel-outbound do natywnego wysyłania, potwierdzeń, trwałego dostarczania i działania podglądu na żywo.

​
Podstawowe funkcje pomocnicze

  • buildChannelInboundEventContext(...): odwzorowuje znormalizowane fakty kanału w kontekście promptu/sesji. Przekaż metadane nadawcy/czatu należące do kanału przez channelContext, który hooki Pluginu otrzymują jako ctx.channelContext. Rozszerz PluginHookChannelSenderContext lub PluginHookChannelChatContext z tej podścieżki o pola specyficzne dla kanału.
  • runChannelInboundEvent(...): wykonuje przyjęcie, klasyfikację, kontrolę wstępną, rozpoznanie, zapis, wysłanie i finalizację jednego przychodzącego zdarzenia platformy.
  • dispatchChannelInboundReply(...): zapisuje i wysyła już złożoną odpowiedź wejściową za pomocą adaptera dostarczania.
Wbudowane/natywne kanały, które już otrzymują wstrzyknięty obiekt środowiska uruchomieniowego Pluginu, mogą wywoływać te same funkcje pomocnicze przez runtime.channel.inbound.*, zamiast bezpośrednio importować tę podścieżkę:
Przygotuj dane wejściowe dispatchChannelInboundReply(...) dla zgodnych wstecznie dyspozytorów, które pozostawiają dostarczanie przez platformę w adapterze dostarczania. Nowe ścieżki wysyłania powinny zamiast tego używać adapterów wiadomości i funkcji pomocniczych trwałych wiadomości z channel-outbound.

​
Migracja

Aliasy środowiska uruchomieniowego runtime.channel.turn.* zostały usunięte. Użyj:
  • runtime.channel.inbound.run(...) dla nieprzetworzonych zdarzeń wejściowych.
  • runtime.channel.inbound.dispatchReply(...) dla złożonych kontekstów odpowiedzi.
  • runtime.channel.inbound.buildContext(...) dla ładunków kontekstu wejściowego.
  • runtime.channel.inbound.runPreparedReply(...), przestarzałe, tylko dla należących do kanału ścieżek wysyłania przygotowanych odpowiedzi, które już tworzą własne domknięcie wysyłające.
Nowy kod Pluginu nie powinien wprowadzać interfejsów API kanałów z turn w nazwie. Terminologię dotyczącą przebiegu modelu lub agenta należy zachować w kodzie agenta/dostawcy; Pluginy kanałów używają terminów dotyczących danych wejściowych, wiadomości, dostarczania i odpowiedzi.