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 포트 없음, 데몬 불필요.

사용되는 핵심 메서드:

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

레거시 설정 및 주소 지정 방법(chat_id 권장)은 iMessage를 참조하십시오.

어댑터 가이드라인

• 게이트웨이가 프로세스를 소유합니다 (시작/중지는 프로바이더 라이프사이클에 연결됨).
• RPC 클라이언트를 견고하게 유지하십시오: 타임아웃, 종료 시 재시작.
• 표시 문자열보다 안정적인 ID(예: chat_id)를 선호하십시오.