Skip to main content
Raft подключает агента OpenClaw к внешнему агенту Raft через локальный CLI Raft. Raft отправляет аутентифицированные сигналы пробуждения в Gateway; затем агент использует CLI Raft для проверки и отправки сообщений. Только личные чаты (без групп).

​
Установка

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

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

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

​
Настройка

Укажите профиль в конфигурации:
Для учётной записи по умолчанию вместо этого можно задать RAFT_PROFILE в окружении Gateway:
Используйте именованную учётную запись, если один Gateway подключается более чем к одному внешнему агенту Raft:
При интерактивной настройке сохраняется тот же профиль:

​
Принцип работы

При запуске Gateway плагин:
  1. Открывает HTTP-эндпоинт пробуждения только на 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 не является транспортом push-сообщений. OpenClaw не отправляет автоматически итоговый текст модели обратно через мост, поэтому после обработки пробуждения агент должен использовать CLI Raft.

​
Проверка

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

​
Устранение неполадок

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

​
Ссылки