메인 콘텐츠로 건너뛰기

​
iOS App (Node)

사용 가능성: 내부 미리보기. iOS 앱은 아직 공개 배포되지 않았습니다.

​
기능

  • WebSocket (LAN 또는 tailnet)을 통해 게이트웨이에 연결합니다.
  • 노드 기능 공개: 캔버스, 화면 스냅샷, 카메라 캡처, 위치, 대화 모드, 음성 깨우기.
  • node.invoke 명령을 수신하고 노드 상태 이벤트를 보고합니다.

​
요구 사항

  • 다른 장치에서 실행되는 게이트웨이 (macOS, Linux 또는 WSL2를 통한 Windows).
  • 네트워크 경로:
    • Bonjour를 통한 동일 LAN, 또는
    • 유니캐스트 DNS-SD를 통한 Tailnet (예시 도메인: openclaw.internal.), 또는
    • 수동 호스트/포트 (대체 경로).

​
빠른 시작 (페어링 + 연결)

  1. 게이트웨이 시작:
openclaw gateway --port 18789
  1. iOS 앱에서 설정을 열고 발견된 게이트웨이를 선택하십시오 (또는 수동 호스트를 활성화하고 호스트/포트를 입력하십시오).
  2. 게이트웨이 호스트에서 페어링 요청 승인: 
openclaw nodes pending
openclaw nodes approve <requestId>
  1. 연결 확인:
openclaw nodes status
openclaw gateway call node.list --params "{}"

​
디바이스 검색 경로

​
Bonjour (LAN)

게이트웨이는 local.에 _openclaw-gw._tcp를 광고합니다. iOS 앱은 이를 자동으로 나열합니다.

​
Tailnet (네트워크 간)

mDNS가 차단된 경우, 유니캐스트 DNS-SD 구역을 사용하십시오 (도메인 선택; 예: openclaw.internal.) 및 Tailscale 분할 DNS. CoreDNS 예제를 위해 Bonjour을 참조하십시오.

​
수동 호스트/포트

설정에서 수동 호스트를 활성화하고 게이트웨이 호스트 + 포트를 입력하십시오 (기본 18789).

​
캔버스 + A2UI

iOS 노드는 WKWebView 캔버스를 렌더링합니다. 이를 구동하려면 node.invoke를 사용하세요: 
openclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"url":"http://<gateway-host>:18789/__openclaw__/canvas/"}'
주의사항:
  • 게이트웨이 캔버스 호스트는 /__openclaw__/canvas/ 및 /__openclaw__/a2ui/를 제공합니다.
  • 게이트웨이 HTTP 서버에서 제공됩니다 (게이트웨이 포트와 동일한 포트, 기본 18789).
  • 캔버스 호스트 URL이 광고될 때 iOS 노드는 연결 시 자동으로 A2UI로 이동합니다.
  • 내장 스캐폴드로 돌아가려면 canvas.navigate와 {"url":""}를 사용하세요.

​
캔버스 평가 / 스냅샷

openclaw nodes invoke --node "iOS Node" --command canvas.eval --params '{"javaScript":"(() => { const {ctx} = window.__openclaw; ctx.clearRect(0,0,innerWidth,innerHeight); ctx.lineWidth=6; ctx.strokeStyle=\"#ff2d55\"; ctx.beginPath(); ctx.moveTo(40,40); ctx.lineTo(innerWidth-40, innerHeight-40); ctx.stroke(); return \"ok\"; })()"}'

openclaw nodes invoke --node "iOS Node" --command canvas.snapshot --params '{"maxWidth":900,"format":"jpeg"}'

​
음성 깨우기 + 대화 모드

  • 음성 깨우기 및 대화 모드는 설정에서 사용할 수 있습니다.
  • iOS는 백그라운드 오디오를 중지할 수 있습니다; 앱이 활성 상태가 아닐 때 음성 기능을 최선의 노력으로 처리하십시오.

​
일반 오류

  • NODE_BACKGROUND_UNAVAILABLE: iOS 앱을 포그라운드로 가져오세요 (캔버스/카메라/화면 명령어가 필요합니다).
  • A2UI_HOST_NOT_CONFIGURED: 게이트웨이가 캔버스 호스트 URL을 광고하지 않았습니다; 게이트웨이 구성에서 canvasHost를 확인하십시오.
  • 페어링 프롬프트가 나타나지 않음: openclaw nodes pending을 실행하여 수동으로 승인하세요.
  • 재설치 후 재연결 실패: 키체인 페어링 토큰이 지워졌습니다; 노드를 다시 페어링하세요.

​
관련 문서