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

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

Raft є офіційним зовнішнім Plugin. Установіть його на хості Gateway: 
openclaw plugins install @openclaw/raft
openclaw 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 check
raft --profile openclaw message send
Raft не є звичайним транспортом push-повідомлень. OpenClaw не надсилає автоматично фінальний текст моделі назад через bridge, тому агент має використовувати Raft CLI після оброблення пробудження.

​
Перевірка

Перевірте, що OpenClaw може знайти CLI і має налаштований профіль: 
openclaw channels status --probe
openclaw plugins inspect raft --runtime --json
Потім надішліть повідомлення зовнішньому агенту Raft. У журналі Gateway має бути видно запуск Raft bridge, а потім вхідне пробудження. Агент має використати налаштований профіль Raft, щоб перевірити свої очікувані повідомлення.

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

Установіть Raft CLI на хості Gateway і зробіть raft доступним у PATH служби. Перевірте це за допомогою raft --help, а потім перезапустіть Gateway.
Перевірте, що в налаштований профіль виконано вхід і що він належить потрібному зовнішньому агенту Raft. Запустіть raft --profile <profile> agent bridge напряму, щоб побачити діагностику CLI.
Це очікувано, якщо агент не викликає Raft CLI. Bridge пробудження не передає тіла повідомлень або автоматичні фінальні відповіді. Перевірте політику інструментів агента й переконайтеся, що він може виконувати raft --profile <profile> message check і message send.

​
Посилання