English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Developer and self-hosted

Raft

Obsługa Raft łączy agenta OpenClaw z zewnętrznym agentem Raft za pośrednictwem lokalnego Raft CLI. Raft wysyła uwierzytelnione wskazówki wybudzania do Gateway. Następnie agent używa Raft CLI do sprawdzania i wysyłania wiadomości.

Instalacja

Raft jest oficjalnym zewnętrznym pluginem. Zainstaluj go na hoście Gateway:

bash
openclaw plugins install @openclaw/raftopenclaw gateway restart

Szczegóły: Pluginy

Wymagania wstępne

  • Obszar roboczy Raft z zewnętrznym agentem.
  • Raft CLI zainstalowany na tym samym hoście co OpenClaw Gateway.
  • Profil Raft CLI, który jest już zalogowany i powiązany z tym zewnętrznym agentem.

Plugin nie przechowuje poświadczeń Raft. Raft CLI przechowuje to uwierzytelnienie we własnym profilu.

Konfiguracja

Ustaw profil w konfiguracji:

json5
{  channels: {    raft: {      enabled: true,      profile: "openclaw",    },  },}

Dla konta domyślnego możesz zamiast tego ustawić RAFT_PROFILE w środowisku Gateway:

bash
RAFT_PROFILE=openclaw

Użyj nazwanego konta, gdy jeden Gateway łączy się z więcej niż jednym zewnętrznym agentem Raft:

json5
{  channels: {    raft: {      accounts: {        support: {          profile: "support-agent",        },        engineering: {          profile: "engineering-agent",        },      },    },  },}

Interaktywny przepływ konfiguracji zapisuje ten sam profil:

bash
openclaw channels setup raft

Jak to działa

Gdy Gateway się uruchamia, plugin:

  1. Otwiera punkt końcowy HTTP wybudzania dostępny tylko przez local loopback na efemerycznym porcie.
  2. Uruchamia raft --profile <profile> agent bridge z tym punktem końcowym i tokenem przypisanym do procesu.
  3. Akceptuje tylko uwierzytelnione, pozbawione treści wskazówki wybudzania z tożsamością powtórzenia z lokalnego mostu.
  4. Wymaga jednego z eventId, attemptId, messageId, delivery_id, wake_id lub id.
  5. Deduplikuje ostatnie ponowione dostarczenia wybudzania według identyfikatora zdarzenia mostu, także między restartami Gateway.
  6. Zwraca stabilną sesję uruchomieniową dla bieżącego mostu oraz pustą partię opróżniania aktywności dla protokołu Raft CLI.
  7. Uruchamia jedną serializowaną turę agenta OpenClaw dla każdego zaakceptowanego wybudzenia.

Most odpowiada za ponowne próby dostarczania i ponowne połączenia Raft. Tura OpenClaw otrzymuje tylko powiadomienie o wybudzeniu, a nie skopiowaną treść wiadomości Raft. Używa CLI do odczytu oczekujących wiadomości i wysłania odpowiedzi:

bash
raft --profile openclaw message checkraft --profile openclaw message send

Weryfikacja

Sprawdź, czy OpenClaw może znaleźć CLI i ma skonfigurowany profil:

bash
openclaw channels status --probeopenclaw plugins inspect raft --runtime --json

Następnie wyślij wiadomość do zewnętrznego agenta Raft. Dziennik Gateway powinien pokazać uruchomienie mostu Raft, a potem przychodzące wybudzenie. Agent powinien użyć skonfigurowanego profilu Raft do sprawdzenia oczekujących wiadomości.

Rozwiązywanie problemów

Raft CLI is missing

Zainstaluj Raft CLI na hoście Gateway i udostępnij raft w PATH usługi. Zweryfikuj to za pomocą raft --help, a następnie zrestartuj Gateway.

The bridge exits immediately

Sprawdź, czy skonfigurowany profil jest zalogowany i należy do zamierzonego zewnętrznego agenta Raft. Uruchom raft --profile <profile> agent bridge bezpośrednio, aby zobaczyć diagnostykę CLI.

A wake arrives but no Raft response is sent

Jest to oczekiwane, gdy agent nie wywołuje Raft CLI. Most wybudzania nie przenosi treści wiadomości ani automatycznych odpowiedzi końcowych. Sprawdź politykę narzędzi agenta i upewnij się, że może uruchamiać raft --profile <profile> message check oraz message send.

Odnośniki

Was this useful?
On this page

On this page