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)

• OpenClaw은 iMessage를 위해 imsg rpc를 자식 프로세스로 실행합니다.
• JSON-RPC는 stdin/stdout을 통해 줄 단위로 구분됩니다(줄당 하나의 JSON 객체).
• TCP 포트와 데몬이 필요하지 않습니다.

사용되는 핵심 메서드:

• watch.subscribe → 알림(method: "message")
• watch.unsubscribe
• send
• chats.list(프로브/진단)

설정 및 주소 지정은 iMessage를 참조하세요(표시 문자열보다 chat_id 권장).

어댑터 지침

• Gateway가 프로세스를 관리합니다(시작/중지는 제공자 수명 주기와 연동됨).
• RPC 클라이언트의 복원력을 유지하세요. 시간 제한을 설정하고 종료 시 재시작해야 합니다.
• 표시 문자열보다 안정적인 ID(예: chat_id)를 사용하세요.

관련 항목

• Gateway 프로토콜