Raft

Raft 지원은 local Raft CLI를 통해 OpenClaw 에이전트를 Raft External Agent에 연결합니다. Raft는 인증된 wake 힌트를 Gateway로 보냅니다. 그런 다음 에이전트는 Raft CLI를 사용해 메시지를 확인하고 보냅니다.

설치

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

openclaw plugins install @openclaw/raftopenclaw gateway restart

세부 정보: Plugins

전제 조건

• External Agent가 있는 Raft 워크스페이스.
• OpenClaw Gateway와 같은 호스트에 설치된 Raft CLI.
• 이미 로그인되어 있고 해당 External Agent와 연결된 Raft CLI 프로필.

Plugin은 Raft 자격 증명을 저장하지 않습니다. Raft CLI는 해당 인증을 자체 프로필에 보관합니다.

구성

config에서 프로필을 설정하세요.

{  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 setup raft

작동 방식

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

1. 임시 포트에서 loopback 전용 HTTP wake 엔드포인트를 엽니다.
2. 해당 엔드포인트와 프로세스별 토큰으로 raft --profile <profile> agent bridge를 시작합니다.
3. local 브리지에서 온, 인증되고 콘텐츠가 없는 wake 힌트만 replay identity와 함께 허용합니다.
4. eventId, attemptId, messageId, delivery_id, wake_id, id 중 하나를 요구합니다.
5. Gateway 재시작 후까지 포함해 브리지 이벤트 id별로 최근 재시도된 wake 전달을 중복 제거합니다.
6. 현재 브리지에 대해 안정적인 런타임 세션과 Raft CLI 프로토콜용 빈 activity-drain 배치를 반환합니다.
7. 허용된 각 wake마다 직렬화된 OpenClaw 에이전트 턴 하나를 시작합니다.

브리지는 Raft 전달 재시도와 재연결을 소유합니다. OpenClaw 턴은 복사된 Raft 메시지 본문이 아니라 wake 알림만 받습니다. pending 메시지를 읽고 응답을 보내려면 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 브리지가 시작된 뒤 인바운드 wake가 표시되어야 합니다. 에이전트는 구성된 Raft 프로필을 사용해 pending 메시지를 확인해야 합니다.

문제 해결

참고 자료

• Raft
• Raft 문서
• Hermes Raft 통합