프로토콜 개요
OpenClaw Gateway는 여러 통신 프로토콜을 사용합니다: HTTP REST API(관리 작업 및 동기 요청), WebSocket(실시간 양방향 통신), SSE(스트리밍 응답), Webhook HTTP POST(채널 플랫폼 메시지 수신).
HTTP REST API
기본 엔드포인트: /health, /api/status, /api/chat, /api/models, /api/channels, /api/sessions
스트리밍 응답 (SSE)
stream: true일 때 Server-Sent Events를 사용하여 스트리밍 응답을 반환합니다.
WebSocket 프로토콜
실시간 양방향 통신에 사용됩니다. 인증, 메시지, 핑/퐁, 구독 등의 메시지 유형을 지원합니다.
속도 제한 헤더
Gateway는 응답에 속도 제한 정보를 포함합니다: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
정리
Gateway의 통신 프로토콜을 이해하는 것은 커스텀 통합 개발과 문제 해결에 매우 중요합니다. HTTP REST API는 간단한 통합에, WebSocket은 실시간 상호작용이 필요한 시나리오에, SSE는 스트리밍 출력의 표준 선택입니다.