Пліт

Raft підключає агента OpenClaw до зовнішнього агента Raft через локальний CLI Raft. Raft надсилає автентифіковані сигнали пробудження до Gateway, після чого агент використовує CLI Raft для перевірки та надсилання повідомлень. Підтримуються лише особисті чати (без груп).

Встановлення

Raft — офіційний зовнішній плагін. Установіть його на хості Gateway:

openclaw plugins install @openclaw/raftopenclaw gateway restart

Докладніше: Плагіни

Передумови

• Робочий простір Raft із зовнішнім агентом.
• CLI Raft, установлений на тому самому хості, що й Gateway OpenClaw, і доступний у PATH служби.
• Профіль CLI Raft, у якому уже виконано вхід і який пов’язано з цим зовнішнім агентом.

Плагін не зберігає облікові дані Raft; CLI Raft зберігає дані автентифікації у власному профілі.

Налаштування

Укажіть профіль у конфігурації:

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

Для облікового запису за замовчуванням натомість можна задати RAFT_PROFILE у середовищі Gateway:

RAFT_PROFILE=openclaw

Використовуйте іменований обліковий запис, якщо один Gateway підключається до кількох зовнішніх агентів Raft:

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

Під час інтерактивного налаштування зберігається той самий профіль:

openclaw channels add --channel raft

Принцип роботи

Під час запуску Gateway плагін:

1. Відкриває HTTP-кінцеву точку пробудження, доступну лише через local loopback, на тимчасовому порту.
2. Запускає raft --profile <profile> agent bridge із цією кінцевою точкою та окремим токеном для кожного процесу.
3. Приймає від локального мосту лише автентифіковані сигнали пробудження без вмісту, що мають ідентифікатор для захисту від повторного відтворення.
4. Вимагає наявності одного з eventId, attemptId, messageId, delivery_id, wake_id або id у кожному корисному навантаженні пробудження.
5. Протягом 24 годин усуває дублікати повторно доставлених сигналів пробудження за ідентифікатором події мосту, зокрема після перезапусків Gateway.
6. Повертає стабільний сеанс середовища виконання для поточного мосту та порожній пакет отримання активності для протоколу CLI Raft.
7. Запускає один послідовний цикл агента OpenClaw для кожного прийнятого сигналу пробудження.

Міст керує повторними спробами доставки Raft і повторними підключеннями. Цикл OpenClaw отримує лише сповіщення про пробудження, а не копію тексту повідомлення Raft. Він використовує CLI, щоб прочитати повідомлення, які очікують на обробку, і надіслати відповідь:

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

Перевірка

Перевірте, чи OpenClaw може знайти CLI та чи має налаштований профіль:

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

Потім надішліть повідомлення зовнішньому агенту Raft. У журналі Gateway має з’явитися запуск мосту Raft, а потім — вхідний сигнал пробудження. Агент має використати налаштований профіль Raft для перевірки повідомлень, які очікують на обробку.

Усунення несправностей

Посилання

• Raft
• Документація Raft
• Інтеграція Hermes із Raft