> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Raft

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

## Установка

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/raft
openclaw gateway restart
```

Подробнее: [Плагины](https://docs2.openclaw.ai/ru/tools/plugin.md)

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

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

Плагин не хранит учётные данные Raft; CLI Raft сохраняет данные
аутентификации в собственном профиле.

## Настройка

Укажите профиль в конфигурации:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    raft: {
      enabled: true,
      profile: "openclaw",
    },
  },
}
```

Для учётной записи по умолчанию вместо этого можно задать `RAFT_PROFILE` в окружении
Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
RAFT_PROFILE=openclaw
```

Используйте именованную учётную запись, если один Gateway подключается более чем к одному внешнему агенту Raft:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    raft: {
      accounts: {
        support: {
          profile: "support-agent",
        },
        engineering: {
          profile: "engineering-agent",
        },
      },
    },
  },
}
```

При интерактивной настройке сохраняется тот же профиль:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw channels add --channel 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,
чтобы прочитать ожидающие сообщения и отправить ответ:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
raft --profile openclaw message check
raft --profile openclaw message send
```

> [!NOTE]
>
> Raft не является транспортом push-сообщений. OpenClaw не отправляет автоматически итоговый текст модели обратно через мост, поэтому после обработки пробуждения агент должен использовать CLI Raft.

## Проверка

Убедитесь, что OpenClaw может найти CLI и что профиль настроен:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw channels status --probe
openclaw plugins inspect raft --runtime --json
```

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

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

> [accordion] CLI Raft отсутствует
>
> Установите CLI Raft на хосте Gateway и сделайте `raft` доступным в
> `PATH` службы. Проверьте его с помощью `raft --help`, затем перезапустите Gateway.

> [accordion] Мост немедленно завершает работу
>
> Убедитесь, что в настроенном профиле выполнен вход и что он принадлежит нужному
> внешнему агенту Raft. Запустите `raft --profile <profile> agent bridge` напрямую,
> чтобы просмотреть диагностические данные CLI.

> [accordion] Пробуждение поступает, но ответ Raft не отправляется
>
> Это ожидаемое поведение, если агент не вызывает CLI Raft. Мост пробуждения
> не передаёт тела сообщений и не отправляет итоговые ответы автоматически. Проверьте
> политику инструментов агента и убедитесь, что он может выполнять `raft --profile <profile>
>         message check` и `message send`.

## Ссылки

* [Raft](https://raft.build/)
* [Документация Raft](https://docs.raft.build/welcome/)
* [Интеграция Raft с Hermes](https://hermes-agent.nousresearch.com/docs/user-guide/messaging/raft)