REST API 및 프로토콜 (API)

Path: /v1/chat/completions
특징: 기존의 OpenAI SDK를 그대로 사용하여 OpenClaw 에이전트와 대화할 수 있습니다.

OpenClaw 게이트웨이는 외부 프로그램이 에이전트의 기능을 호출하거나 상태를 조회할 수 있도록 표준 HTTP 인터페이스를 제공합니다.

🚀 주요 엔드포인트

비결정론적인 대화 없이, 특정 도구만 프로그램적으로 실행하고 싶을 때 사용합니다.

Body:

{
  "tool": "read_file",
  "args": { "path": "package.json" }
}

OpenAI API 규격과 호환되는 대화 엔드포인트입니다.

모든 API 호출은 헤더에 인증 토큰을 포함해야 합니다. Authorization: Bearer <your_gateway_token>

실시간 메시지 스트리밍과 이벤트 알림을 위해 내부적인 바이너리 프로토콜(Wire Protocol)을 지원합니다. 주로 대시보드 UI와 게이트웨이 간의 초고속 데이터 전송에 사용됩니다.

API 상세 사양(Swagger/OpenAPI UI)은 게이트웨이가 실행 중일 때 http://localhost:18789/docs에서 확인할 수 있습니다.