RPC 어댑터

OpenClaw은 JSON-RPC를 통해 외부 CLI를 통합합니다. 현재 두 가지 패턴이 사용됩니다.

패턴 A: HTTP 데몬 (signal-cli)

  • signal-cli가 HTTP 위의 JSON-RPC로 데몬 실행.
  • 이벤트 스트림은 SSE (/api/v1/events).
  • 상태 프로브: /api/v1/check.
  • channels.signal.autoStart=true일 때 OpenClaw이 생명주기를 관리.

설정 및 엔드포인트는 Signal을 참조하세요.

패턴 B: stdio 자식 프로세스 (레거시: imsg)

참고: 새로운 iMessage 설정에는 BlueBubbles를 대신 사용하세요.

  • OpenClaw이 imsg rpc를 자식 프로세스로 생성 (레거시 iMessage 통합).
  • JSON-RPC가 stdin/stdout 위에 줄 단위로 (줄당 하나의 JSON 객체).
  • TCP 포트 없음, 데몬 필요 없음.

어댑터 가이드라인

  • 게이트웨이가 프로세스를 소유 (시작/중지가 프로바이더 생명주기에 연결).
  • RPC 클라이언트를 탄력적으로 유지: 타임아웃, 종료 시 재시작.
  • 표시 문자열보다 안정적 ID(예: chat_id)를 선호.