iOS App (Node) 시작하기

모바일 기기를 개발 워크플로우나 자동화 시스템에 통합하려고 할 때, 네트워크 설정이나 기기 권한 문제로 골머리를 앓는 경우가 많아요. 특히 모바일 기기의 센서 데이터나 화면에 접근하는 과정이 복잡하면 금방 지치게 되죠.

OpenClaw iOS App을 사용하면 iPhone이나 iPad를 하나의 Node로 만들어 Gateway에 간단히 연결할 수 있어요. 현재 이 기능은 internal preview 단계로 제공됩니다.

필요한 것

• macOS, Linux 또는 Windows(WSL2)에서 실행 중인 Gateway
• Bonjour를 지원하는 동일 LAN 환경, 또는 Tailnet(unicast DNS-SD), 또는 수동 호스트/포트 설정이 가능한 네트워크 경로

빠른 시작

5분 안에 iOS 기기를 Node로 연결하고 페어링하는 방법이에요.

1. 우선 Gateway를 실행하세요.

openclaw gateway --port 18789

2. iOS 앱의 Settings에서 검색된 Gateway를 선택하세요. 자동 검색이 안 된다면 Manual Host를 활성화하고 직접 호스트와 포트를 입력하면 돼요.

3. Gateway가 실행 중인 호스트에서 페어링 요청을 승인하세요.

openclaw nodes pending
openclaw nodes approve <requestId>

4. 연결이 잘 되었는지 확인해 보세요.

openclaw nodes status
openclaw gateway call node.list --params "{}"

Canvas + A2UI 활용

iOS Node는 WKWebView 기반의 캔버스를 렌더링합니다. node.invoke 명령어로 캔버스를 제어할 수 있어요.

openclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"url":"http://<gateway-host>:18793/__openclaw__/canvas/"}'

연결 시 Canvas 호스트 URL이 광고되면 iOS Node가 자동으로 A2UI로 이동합니다. 기본 스캐폴드로 돌아가려면 canvas.navigate에 {"url":""}를 담아 보내세요.

Canvas 스냅샷 및 스크립트 실행

캔버스에 직접 JavaScript를 실행하거나 현재 상태를 스냅샷으로 찍을 수도 있어요.

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"}'

문제 해결

문제가 발생하면 다음 내용을 확인해 보세요.

• NODE_BACKGROUND_UNAVAILABLE: iOS 앱을 포그라운드로 가져오세요. 캔버스, 카메라, 화면 관련 명령어는 앱이 화면에 떠 있어야 작동해요.
• A2UI_HOST_NOT_CONFIGURED: Gateway가 Canvas 호스트 URL을 광고하지 않고 있어요. Gateway 설정에서 canvasHost 항목을 확인해 보세요.
• 페어링 프롬프트가 나타나지 않음: openclaw nodes pending 명령어를 실행해 수동으로 승인해야 합니다.
• 재설치 후 재연결 실패: 앱을 재설치하면 Keychain에 저장된 페어링 토큰이 사라져요. Node를 다시 페어링하세요.

설정 과정에서 도움이 더 필요하다면 AI Setup Assistant에게 물어보세요.

다음 단계

• Pairing
• Discovery
• Bonjour