Raft

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

Установка

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

openclaw plugins install @openclaw/raftopenclaw gateway restart

Подробнее: Плагины

Предварительные требования

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

Плагин не хранит учетные данные 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 плагин:

1. Открывает HTTP-эндпоинт пробуждения только для loopback на эфемерном порту.
2. Запускает raft --profile <profile> agent bridge с этим эндпоинтом и токеном для текущего процесса.
3. Принимает только аутентифицированные сигналы пробуждения без содержимого с идентификатором повтора от локального моста.
4. Требует одно из полей: eventId, attemptId, messageId, delivery_id, wake_id или id.
5. Дедуплицирует недавние повторные доставки пробуждения по идентификатору события моста, в том числе между перезапусками Gateway.
6. Возвращает стабильную runtime-сессию для текущего моста и пустой пакет очистки активности для протокола Raft CLI.
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