Raft

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

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

Raft є офіційним зовнішнім Plugin. Установіть його на хості Gateway:

openclaw plugins install @openclaw/raftopenclaw gateway restart

Докладніше: Plugins

Передумови

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

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

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

Задайте профіль у конфігурації:

{  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 setup raft

Як це працює

Коли Gateway запускається, Plugin:

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

Bridge відповідає за повторні спроби доставлення 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 bridge, а потім вхідне пробудження. Агент має використати налаштований профіль Raft, щоб перевірити свої очікувані повідомлення.

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

Посилання

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