래프트

Raft는 로컬 Raft CLI를 통해 OpenClaw 에이전트를 Raft External Agent에 연결합니다. Raft는 인증된 깨우기 알림을 Gateway로 전송하며, 이후 에이전트는 Raft CLI를 사용하여 메시지를 확인하고 전송합니다. 일대일 채팅만 지원합니다(그룹은 지원하지 않음).

설치

Raft는 공식 외부 Plugin입니다. Gateway 호스트에 설치합니다.

openclaw plugins install @openclaw/raftopenclaw gateway restart

자세한 내용: Plugin

사전 요구 사항

• External Agent가 있는 Raft 워크스페이스.
• OpenClaw Gateway와 동일한 호스트에 설치되어 있고 서비스의 PATH에 등록된 Raft CLI.
• 이미 로그인되어 있으며 해당 External Agent와 연결된 Raft CLI 프로필.

Plugin은 Raft 자격 증명을 저장하지 않으며, Raft CLI가 자체 프로필에 해당 인증 정보를 보관합니다.

구성

구성에서 프로필을 설정합니다.

{  channels: {    raft: {      enabled: true,      profile: "openclaw",    },  },}

기본 계정의 경우 대신 Gateway 환경에서 RAFT_PROFILE을 설정할 수 있습니다.

RAFT_PROFILE=openclaw

하나의 Gateway가 둘 이상의 Raft External Agent에 연결될 때는 명명된 계정을 사용합니다.

{  channels: {    raft: {      accounts: {        support: {          profile: "support-agent",        },        engineering: {          profile: "engineering-agent",        },      },    },  },}

대화형 설정에서도 동일한 프로필이 기록됩니다.

openclaw channels add --channel raft

작동 방식

Gateway가 시작되면 Plugin은 다음 작업을 수행합니다.

1. 임시 포트에서 루프백 전용 HTTP 깨우기 엔드포인트를 엽니다.
2. 해당 엔드포인트 및 프로세스별 토큰과 함께 raft --profile <profile> agent bridge를 시작합니다.
3. 로컬 브리지에서 재생 방지 식별 정보가 포함된 인증된 무내용 깨우기 알림만 수락합니다.
4. 모든 깨우기 페이로드에 eventId, attemptId, messageId, delivery_id, wake_id, id 중 하나가 있어야 합니다.
5. Gateway가 재시작된 경우를 포함하여, 브리지 이벤트 ID를 기준으로 재시도된 깨우기 전달을 24시간 동안 중복 제거합니다.
6. 현재 브리지에 대한 안정적인 런타임 세션과 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 External Agent에 메시지를 전송합니다. Gateway 로그에는 Raft 브리지가 시작된 후 인바운드 깨우기가 표시되어야 합니다. 에이전트는 구성된 Raft 프로필을 사용하여 대기 중인 메시지를 확인해야 합니다.

문제 해결

참고 자료

• Raft
• Raft 문서
• Hermes Raft 통합