Przykład
Alice może wysyłać wiadomości do OpenClaw w Telegramie i Discordzie:
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:- Rozpocznij zadanie agenta w Telegramie.
- Przejdź do Discorda, gdzie koordynujesz pracę.
- Wyślij
/dock_discordz czatu bezpośredniego w Telegramie. - Zachowaj tę samą sesję OpenClaw, ale odbieraj przyszłe odpowiedzi w Discordzie.
Wymagana konfiguracja
Dokowanie wymagasession.identityLinks. Nadawca źródłowy i docelowy uczestnik
muszą należeć do tej samej grupy tożsamości:
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
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 grupysession.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.