Skip to main content
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:
Jeśli Alice wyśle następujące polecenie z czatu bezpośredniego w Telegramie:
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:
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.