Skip to main content
Raft łączy agenta OpenClaw z agentem zewnętrznym Raft za pośrednictwem lokalnego CLI Raft. Raft wysyła uwierzytelnione sygnały wybudzenia do Gateway; następnie agent używa CLI Raft do sprawdzania i wysyłania wiadomości. Obsługiwany jest wyłącznie czat bezpośredni (bez grup).

​
Instalacja

Raft jest oficjalnym zewnętrznym pluginem. Zainstaluj go na hoście Gateway:
Szczegóły: Pluginy

​
Wymagania wstępne

  • Obszar roboczy Raft z agentem zewnętrznym.
  • CLI Raft zainstalowane na tym samym hoście co Gateway OpenClaw i dostępne w zmiennej PATH usługi.
  • Profil CLI Raft, w którym użytkownik jest już zalogowany i który jest powiązany z tym agentem zewnętrznym.
Plugin nie przechowuje danych uwierzytelniających Raft; CLI Raft przechowuje uwierzytelnienie we własnym profilu.

​
Konfiguracja

Ustaw profil w konfiguracji:
Dla konta domyślnego możesz zamiast tego ustawić RAFT_PROFILE w środowisku Gateway:
Użyj nazwanego konta, gdy jeden Gateway łączy się z więcej niż jednym agentem zewnętrznym Raft:
Konfiguracja interaktywna zapisuje ten sam profil:

​
Jak to działa

Po uruchomieniu Gateway plugin:
  1. Otwiera punkt końcowy HTTP wybudzania dostępny wyłącznie przez local loopback, używając portu efemerycznego.
  2. Uruchamia raft --profile <profile> agent bridge z tym punktem końcowym oraz tokenem unikatowym dla procesu.
  3. Akceptuje wyłącznie uwierzytelnione, niezawierające treści sygnały wybudzenia z identyfikatorem zapobiegającym ponownemu odtworzeniu, pochodzące z lokalnego mostu.
  4. Wymaga jednego z pól eventId, attemptId, messageId, delivery_id, wake_id lub id w każdym ładunku wybudzenia.
  5. Deduplikuje ponawiane dostarczenia wybudzeń według identyfikatora zdarzenia mostu przez 24 godziny, również po ponownym uruchomieniu Gateway.
  6. Zwraca stabilną sesję środowiska uruchomieniowego dla bieżącego mostu oraz pustą partię opróżniania aktywności dla protokołu CLI Raft.
  7. Uruchamia jedną serializowaną turę agenta OpenClaw dla każdego zaakceptowanego wybudzenia.
Most odpowiada za ponawianie dostarczania przez Raft i ponowne nawiązywanie połączenia. Tura OpenClaw otrzymuje wyłącznie powiadomienie o wybudzeniu, a nie skopiowaną treść wiadomości Raft. Używa CLI do odczytywania oczekujących wiadomości i wysyłania odpowiedzi:
Raft nie jest transportem wiadomości typu push. OpenClaw nie wysyła automatycznie końcowego tekstu modelu z powrotem przez most, dlatego po przetworzeniu wybudzenia agent musi użyć CLI Raft.

​
Weryfikacja

Sprawdź, czy OpenClaw może znaleźć CLI i ma skonfigurowany profil:
Następnie wyślij wiadomość do agenta zewnętrznego Raft. Dziennik Gateway powinien pokazać uruchomienie mostu Raft, a następnie przychodzące wybudzenie. Agent powinien użyć skonfigurowanego profilu Raft do sprawdzenia oczekujących wiadomości.

​
Rozwiązywanie problemów

Zainstaluj CLI Raft na hoście Gateway i udostępnij polecenie raft w zmiennej PATH usługi. Zweryfikuj je za pomocą raft --help, a następnie uruchom ponownie Gateway.
Sprawdź, czy skonfigurowany profil jest zalogowany i należy do właściwego agenta zewnętrznego Raft. Uruchom bezpośrednio raft --profile <profile> agent bridge, aby zobaczyć diagnostykę CLI.
Jest to oczekiwane, gdy agent nie wywołuje CLI Raft. Most wybudzania nie przenosi treści wiadomości ani automatycznych odpowiedzi końcowych. Sprawdź zasady używania narzędzi przez agenta i upewnij się, że może on uruchamiać raft --profile <profile> message check oraz message send.

​
Materiały referencyjne