Przejdź do głównej treści
Dokowanie kanału to przekazywanie połączeń dla jednej sesji OpenClaw. Zachowuje ten sam kontekst rozmowy, ale zmienia miejsce, do którego będą dostarczane przyszłe odpowiedzi dla tej sesji.

​
Przykład

Alice może pisać do OpenClaw na Telegram i Discord: 
{
  session: {
    identityLinks: {
      alice: ["telegram:123", "discord:456"],
    },
  },
}
Jeśli Alice wyśle to z Telegram: 
/dock_discord
OpenClaw zachowuje bieżący kontekst sesji i zmienia trasę odpowiedzi:
Przed dokowaniemPo /dock_discord
Odpowiedzi trafiają do Telegram 123Odpowiedzi trafiają do Discord 456
Sesja nie jest tworzona ponownie. Historia transkryptu pozostaje przypisana do tej samej sesji.

​
Dlaczego tego używać

Użyj dokowania, gdy zadanie zaczyna się w jednej aplikacji czatu, ale kolejne odpowiedzi powinny trafiać gdzie indziej. Typowy przepływ:
  1. Uruchom zadanie agenta z Telegram.
  2. Przenieś się do Discord, gdzie koordynujesz pracę.
  3. Wyślij /dock_discord z sesji Telegram.
  4. Zachowaj tę samą sesję OpenClaw, ale odbieraj przyszłe odpowiedzi w Discord.

​
Wymagana konfiguracja

Dokowanie wymaga session.identityLinks. Nadawca źródłowy i docelowy peer muszą znajdować się w tej samej grupie tożsamości: 
{
  session: {
    identityLinks: {
      alice: ["telegram:123", "discord:456", "slack:U123"],
    },
  },
}
Wartości to identyfikatory peerów z prefiksem kanału:
WartośćZnaczenie
telegram:123identyfikator nadawcy Telegram 123
discord:456identyfikator bezpośredniego peera Discord 456
slack:U123identyfikator użytkownika Slack U123
Klucz kanoniczny (alice powyżej) jest tylko wspólną nazwą grupy tożsamości. Polecenia dokowania używają wartości z prefiksem kanału, aby potwierdzić, że nadawca źródłowy i docelowy peer to ta sama osoba.

​
Polecenia

Polecenia dokowania są generowane z załadowanych pluginów kanałów, które obsługują polecenia natywne. Obecne polecenia w pakiecie:
Kanał docelowyPolecenieAlias
Discord/dock-discord/dock_discord
Mattermost/dock-mattermost/dock_mattermost
Slack/dock-slack/dock_slack
Telegram/dock-telegram/dock_telegram
Aliasy z podkreśleniem są przydatne w natywnych powierzchniach poleceń, takich jak Telegram.

​
Co się zmienia

Dokowanie aktualizuje pola dostarczania aktywnej sesji:
Pole sesjiPrzykład po /dock_discord
lastChanneldiscord
lastTo456
lastAccountIdkonto kanału docelowego albo default
Te pola są utrwalane w magazynie sesji i używane przez późniejsze dostarczanie odpowiedzi dla tej sesji.

​
Co się nie zmienia

Dokowanie nie:
  • tworzy kont kanałów
  • łączy nowego bota Discord, Telegram, Slack ani Mattermost
  • nadaje użytkownikowi dostępu
  • omija list dozwolonych kanałów ani zasad DM
  • przenosi historii transkryptu do innej sesji
  • sprawia, że niepowiązani użytkownicy współdzielą sesję
Zmienia tylko trasę dostarczania dla bieżącej sesji.

​
Rozwiązywanie problemów

Polecenie informuje, że nadawca nie jest powiązany. Dodaj zarówno bieżącego nadawcę, jak i docelowego peera do tej samej grupy session.identityLinks. Na przykład, jeśli nadawca Telegram 123 ma zostać zadokowany do peera Discord 456, uwzględnij zarówno telegram:123, jak i discord:456. Polecenie informuje, że nie istnieje aktywna sesja. Dokuj z istniejącej sesji czatu bezpośredniego. Polecenie wymaga aktywnego wpisu sesji, aby mogło utrwalić nową trasę. Odpowiedzi nadal trafiają do starego kanału. Sprawdź, czy polecenie zwróciło komunikat powodzenia, i potwierdź, że identyfikator docelowego peera odpowiada identyfikatorowi używanemu przez ten kanał. Dokowanie zmienia tylko trasę aktywnej sesji; inna sesja może nadal kierować odpowiedzi gdzie indziej. Muszę przełączyć z powrotem. Wyślij pasujące polecenie dla pierwotnego kanału, takie jak /dock_telegram lub /dock-telegram, od powiązanego nadawcy.