OpenClaw v2026.2 적용 | 본 문서는 Gateway 배포를 완료했으며 모바일 기기에서 사용하려는 사용자를 대상으로 합니다.
TL;DR: iOS/Android 앱이 “노드"로 Gateway에 연결되어 카메라, 화면 녹화, 위치, 알림 기능을 제공합니다. 페어링 흐름: 앱 실행 → Gateway 발견 → 페어링 코드 입력. 명령: camera.snap(촬영), screen.record(녹화), location.get(위치), notification.send(알림). 음성 웨이크업은 iOS에서만 “Hey Claw” 지원.
모바일 기능 개요
기능 비교
| 기능 | iOS | Android | 설명 |
|---|---|---|---|
| 메시지 송수신 | ✅ | ✅ | WebChat 또는 채팅 앱 통해 |
| Canvas | ✅ | ✅ | 시각화 인터페이스 |
| 카메라 | ✅ | ✅ | 촬영 후 AI 분석 |
| 화면 녹화 | ✅ | ✅ | 녹화 및 화면 공유 |
| 위치 서비스 | ✅ | ✅ | 현재 위치 확인 |
| 알림 | ✅ | ✅ | AI가 보낸 알림 수신 |
| 음성 웨이크업 | ✅ | ❌ | “Hey Claw” 웨이크업 |
| 로컬 실행 | ❌ | ❌ | Gateway 연결 필요 |
아키텍처
[iOS/Android 앱] <--WiFi/셀룰러--> [Gateway] <---> [Agent]
| |
[Node API] [Tools/Skills]
| |
[기기 기능] [외부 서비스]
- 카메라
- 화면
- 위치
- 알림
iOS 설치
시스템 요구사항
| 요구사항 | 버전 |
|---|---|
| iOS | 15.0+ |
| 기기 | iPhone 8 이상 |
설치 방법
방법 1: TestFlight(권장)
- TestFlight 베타 참여
- OpenClaw iOS 앱 설치
- 앱 실행 후 페어링
방법 2: 소스 빌드
# 저장소 클론
git clone https://github.com/openclaw/openclaw.git
cd openclaw/apps/ios
# 의존성 설치
pod install
# Xcode 열기
open OpenClaw.xcworkspace
# 빌드 후 기기에 설치
iOS 권한 설정
| 권한 | 용도 | 필수 |
|---|---|---|
| 카메라 | 촬영 분석 | 선택 |
| 사진 라이브러리 | 사진 저장/읽기 | 선택 |
| 위치 | 현재 위치 확인 | 선택 |
| 알림 | 메시지 알림 수신 | 권장 |
| 마이크 | 음성 웨이크업 | 선택 |
| Face ID | 보안 인증 | 선택 |
Android 설치
시스템 요구사항
| 요구사항 | 버전 |
|---|---|
| Android | 10.0+ (API 29+) |
| 기기 | 대부분의 최신 기기 |
설치 방법
방법 1: APK 직접 설치
- 최신 APK 다운로드
- 출처를 알 수 없는 앱 설치 허용
- 설치 후 앱 실행
방법 2: 소스 빌드
# 저장소 클론
git clone https://github.com/openclaw/openclaw.git
cd openclaw/apps/android
# 빌드
./gradlew assembleDebug
# 기기에 설치
adb install app/build/outputs/apk/debug/app-debug.apk
Android 권한 설정
| 권한 | 용도 | 필수 |
|---|---|---|
| 카메라 | 촬영 분석 | 선택 |
| 저장소 | 파일 저장/읽기 | 선택 |
| 위치 | 현재 위치 확인 | 선택 |
| 알림 | 메시지 알림 수신 | 권장 |
| 마이크 | 음성 입력 | 선택 |
노드 페어링
페어링 흐름
sequenceDiagram
participant A as 모바일 앱
participant G as Gateway
participant D as 발견 서비스
A->>D: 브로드캐스트 발견 요청
D-->>A: Gateway 발견
A->>G: 페어링 요청
G-->>A: 페어링 코드 반환
A->>A: 페어링 코드 표시
Note over A,G: 사용자가 앱에 페어링 코드 입력
A->>G: 페어링 코드 제출
G->>G: 페어링 코드 검증
G-->>A: 페어링 성공
A->>G: 노드 기능 등록
G-->>A: 등록 확인
페어링 단계
1. Gateway 실행 확인
# Gateway 시작
openclaw gateway --port 18789
# 상태 확인
openclaw health
2. 모바일 앱 실행
OpenClaw iOS/Android 앱을 실행합니다.
3. Gateway 발견
앱이 로컬 네트워크의 Gateway를 자동 스캔하거나, 수동으로 Gateway 주소를 입력합니다:
http://192.168.1.100:18789
4. 페어링 코드 확인
Gateway 터미널에서 페어링 코드를 확인합니다:
openclaw pairing list
# 출력 예시:
# Node Code Platform
# ios-1 ABC123 iOS
# android-1 XYZ789 Android
5. 페어링 코드 입력
앱에 페어링 코드를 입력하여 페어링을 완료합니다.
노드 설정
{
"nodes": {
"ios-1": {
"platform": "ios",
"capabilities": ["camera", "screen_record", "location", "notification"],
"autoConnect": true
},
"android-1": {
"platform": "android",
"capabilities": ["camera", "screen_record", "location", "notification", "sms"],
"autoConnect": true
}
}
}
카메라 기능
촬영 후 AI 분석
사용자: 냉장고에 뭐가 있는지 봐줘
Agent: 네, 휴대폰 카메라로 확인해볼게요...
[camera.snap 호출]
[이미지 분석]
냉장고 안에는:
- 우유(반 병)
- 달걀(6개)
- 오이(2개)
- 토마토(몇 개)
토마토 계란볶음 해먹을 수 있겠네요~
카메라 명령
| 명령 | 설명 |
|---|---|
camera.snap |
사진 촬영 |
camera.video |
비디오 녹화 |
camera.switch |
전/후면 카메라 전환 |
카메라 설정
{
"nodes": {
"ios-1": {
"camera": {
"defaultCamera": "back",
"quality": "high",
"saveToGallery": false
}
}
}
}
화면 녹화
녹화 및 공유
사용자: 이 앱 어떻게 쓰는지 봐줘
Agent: 네, 화면 녹화를 시작해주세요...
[사용자가 앱 조작]
Agent: 확인했습니다. 할 일 앱이네요.
다음과 같이 사용할 수 있어요:
1. 오른쪽 아래 + 버튼으로 작업 추가
2. 왼쪽으로 스와이프해 삭제
3. 작업을 탭하면 상세 편집
화면 녹화 설정
{
"nodes": {
"ios-1": {
"screenRecord": {
"maxDuration": 300,
"quality": "medium",
"withAudio": true
}
}
}
}
위치 서비스
현재 위치 확인
사용자: 근처에 맛있는 거 있어?
Agent: 현재 위치를 확인해볼게요...
[location.get 호출]
현재 서울시 강남구 삼성동 근처에 계시네요.
추천 맛집:
1. OO식당 - 4.8점, 한식
2. XX라멘 - 4.7점, 일식
3. ...
위치 명령
| 명령 | 설명 |
|---|---|
location.get |
현재 위치 확인 |
location.watch |
위치 변경 지속 감시 |
위치 설정
{
"nodes": {
"ios-1": {
"location": {
"accuracy": "high",
"distanceFilter": 100
}
}
}
}
알림 기능
알림 전송
Agent: 작업이 완료되었어요. 휴대폰으로 알림 보낼게요.
[notification.send 호출]
휴대폰에 알림 수신:
제목: 작업 완료
내용: 코드가 프로덕션에 배포되었습니다
알림 설정
{
"nodes": {
"ios-1": {
"notification": {
"enabled": true,
"sound": true,
"badge": true
}
}
}
}
음성 웨이크업(iOS)
음성 웨이크업 설정
{
"nodes": {
"ios-1": {
"voiceWake": {
"enabled": true,
"keyword": "hey claw",
"sensitivity": "medium"
}
}
}
}
음성 웨이크업 사용
- “Hey Claw"라고 말하기
- 앱이 자동으로 청취 시작
- 질문 말하기
- Agent 응답
모바일 Canvas
모바일에서 Canvas
모바일 Canvas는 데스크톱과 동일한 시각화 경험을 제공합니다:
- 대화형 대시보드
- 실시간 데이터 표시
- 폼 입력
- 차트 및 테이블
모바일 Canvas 최적화
{
"canvas": {
"mobile": {
"adaptiveLayout": true,
"touchGestures": true,
"performanceMode": "balanced"
}
}
}
노드 관리
노드 확인
# 모든 노드 확인
openclaw nodes list
# 출력 예시:
# Node Platform Status Capabilities
# ios-1 iOS online camera,location,notification
# android-1 Android offline camera,location,sms
# 노드 상세 확인
openclaw nodes show ios-1
노드 작업
# 노드 활성화
openclaw nodes enable ios-1
# 노드 비활성화
openclaw nodes disable ios-1
# 노드 연결 해제
openclaw nodes disconnect ios-1
# 노드 이름 변경
openclaw nodes rename ios-1 --name "내 iPhone"
문제 해결
노드 연결 실패
# Gateway 상태 확인
openclaw health
# 네트워크 확인
ping 192.168.1.100
# 노드 로그 확인
openclaw logs --node ios-1
권한 문제
# 노드 권한 확인
openclaw nodes permissions ios-1
# 출력 예시:
# Permission Status
# Camera Granted
# Location Granted
# Notification Granted
# Microphone Denied
페어링 실패
- Gateway가 실행 중인지 확인
- 네트워크 연결 확인(동일 LAN)
- 방화벽 설정 확인
- 페어링 재시도
요약
모바일 노드로 OpenClaw 기능이 확장됩니다:
- 카메라: 촬영 분석, 비디오 녹화
- 위치: 현재 위치 확인
- 알림: 휴대폰으로 메시지 푸시
- Canvas: 모바일 시각화 인터페이스
- 음성 웨이크업: 핸즈프리 조작
업데이트 기록:
- 2026-02-26: 초판 발행
시리즈 네비게이션:
- ← 이전: 원격 배포 방안
- → 다음: 자동화 및 예약 작업