Dokowanie kanału

Dokowanie kanału to przekierowanie odpowiedzi dla jednej sesji OpenClaw. Zachowuje ten sam kontekst konwersacji, ale zmienia miejsce dostarczania przyszłych odpowiedzi w tej sesji. Dokowanie działa tylko z czatu bezpośredniego; nie można go uruchomić z czatu grupowego.

Przykład

Alice może wysyłać wiadomości do OpenClaw w Telegramie i Discordzie:

{  session: {    identityLinks: {      alice: ["telegram:123", "discord:456"],    },  },}

Jeśli Alice wyśle następujące polecenie z czatu bezpośredniego w Telegramie:

/dock_discord

OpenClaw zachowa kontekst bieżącej sesji i zmieni trasę odpowiedzi:

Sesja nie jest tworzona ponownie. Historia transkrypcji pozostaje powiązana z tą samą sesją.

Dlaczego warto go używać

Dokowania należy używać, gdy zadanie rozpoczyna się w jednej aplikacji czatu, ale kolejne odpowiedzi powinny trafiać do innej.

Typowy przebieg:

1. Rozpocznij zadanie agenta w Telegramie.
2. Przejdź do Discorda, gdzie koordynujesz pracę.
3. Wyślij /dock_discord z czatu bezpośredniego w Telegramie.
4. Zachowaj tę samą sesję OpenClaw, ale odbieraj przyszłe odpowiedzi w Discordzie.

Wymagana konfiguracja

Dokowanie wymaga session.identityLinks. Nadawca źródłowy i docelowy uczestnik muszą należeć do tej samej grupy tożsamości:

{  session: {    identityLinks: {      alice: ["telegram:123", "discord:456", "slack:U123"],    },  },}

Wartości są identyfikatorami uczestników poprzedzonymi nazwą kanału:

Klucz kanoniczny (alice powyżej) jest jedynie nazwą wspólnej grupy tożsamości. Polecenia dokowania używają wartości poprzedzonych nazwą kanału, aby potwierdzić, że nadawca źródłowy i docelowy uczestnik są tą samą osobą.

Polecenia

OpenClaw generuje jedno polecenie /dock-<channel> dla każdego załadowanego pluginu kanału, który obsługuje polecenia natywne, więc lista rośnie wraz z dodawaniem pluginów. Dołączone pluginy, które obecnie je obsługują:

Forma z podkreśleniem jest również nazwą natywnego polecenia w interfejsach takich jak Telegram, które bezpośrednio udostępniają polecenia z ukośnikiem.

Co się zmienia

Dokowanie aktualizuje pola dostarczania aktywnej sesji:

Pola te są zapisywane w magazynie sesji i używane do dostarczania późniejszych odpowiedzi w tej sesji.

Co się nie zmienia

Dokowanie nie:

• tworzy kont kanałów
• łączy nowego bota Discorda, Telegrama, Slacka ani Mattermosta
• przyznaje użytkownikowi dostępu
• omija list dozwolonych kanałów ani zasad wiadomości bezpośrednich
• przenosi historii transkrypcji do innej sesji
• powoduje współdzielenia sesji przez niepowiązanych użytkowników

Zmienia wyłącznie 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 uczestnika do tej samej grupy session.identityLinks. Jeśli na przykład nadawca Telegram 123 ma zadokować do uczestnika Discord 456, uwzględnij zarówno telegram:123, jak i discord:456.

Polecenie informuje, że dokowanie jest dostępne tylko z czatów bezpośrednich.

Wyślij polecenie dokowania z czatu bezpośredniego z OpenClaw, a nie z czatu grupowego.

Polecenie informuje, że nie istnieje aktywna sesja.

Dokuj z istniejącej sesji czatu bezpośredniego. Polecenie wymaga wpisu aktywnej sesji, aby móc zapisać nową trasę.

Odpowiedzi nadal trafiają do starego kanału.

Sprawdź, czy polecenie zwróciło komunikat o powodzeniu, i potwierdź, że identyfikator docelowego uczestnika odpowiada identyfikatorowi używanemu przez ten kanał. Dokowanie zmienia tylko trasę aktywnej sesji; inna sesja może nadal kierować odpowiedzi w inne miejsce.

Muszę przełączyć się z powrotem.

Wyślij odpowiednie polecenie dla pierwotnego kanału, na przykład /dock_telegram lub /dock-telegram, od powiązanego nadawcy.