USB 연결, ADB 또는 root 권한 없이 네트워크를 통해 Android 기기를 제어하기 위한 로컬 우선 자동화 스킬입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install agent-android
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 agent-android 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
Agent Android란 무엇인가요?
Agent Android는 원격 기기 상호 작용 및 로봇 프로세스 자동화(RPA)를 위해 설계된 Openclaw Skills 라이브러리의 강력한 추가 기능입니다. AI Agent가 휴대폰에서 직접 호스팅되는 경량 HTTP 서비스를 통해 Android 기기를 제어할 수 있도록 합니다. 이 스킬은 로컬 우선 원칙에 따라 작동하며, UI 읽기, 탭, 입력 및 스크린샷이 로컬 네트워크(LAN) 내에 유지되어 최대의 개인 정보 보호와 성능을 보장합니다. ADB와 같은 전통적인 개발 도구의 필요성을 제거함으로써 기술적 지식이 부족한 환경에서도 설정을 간소화하고 기기 UI 트리에 대한 심층적인 기술적 접근 권한을 제공합니다.
Agent Android 활용 사례
- Android 애플리케이션 내 반복 작업 자동화
- 원격 모바일 앱 테스트 및 UI 검증 수행
- AI 음성 또는 텍스트 명령을 통해 Android 인터페이스 탐색
- 공개 API를 제공하지 않는 모바일 앱에서 데이터 추출
- 물리적 연결 없이 로컬 네트워크를 통해 Android 기기 관리
Agent Android 작동 원리
- 기기의 상태 엔드포인트에 접속하여 서비스가 활성화되어 있는지 확인합니다.
- 앱 탐색 명령을 사용하여 사용 가능한 애플리케이션을 검색하고 대상 패키지를 식별합니다.
- 원하는 애플리케이션을 실행하여 Android 기기의 전면에 표시합니다.
- 현재 UI 트리를 검사하여 리소스 ID, 텍스트 레이블 및 요소 경계를 매핑합니다.
- 매핑된 UI 요소를 기반으로 탭, 스와이프 또는 텍스트 입력과 같은 특정 작업을 수행합니다.
- UI 트리 검사를 새로 고쳐 작업 결과를 확인하고 루프의 다음 단계를 준비합니다.
Agent Android 설정 가이드
Openclaw Skills 컬렉션에서 이 스킬을 시작하려면 CLI가 경로(path)에 있는지 확인하세요. uv 패키지 관리자를 사용하여 설치합니다:
uv tool install aivane-agent-android
uv tool update-shell
또한 http://<device-ip>:8080과 같은 URL에서 로컬 API 서비스를 호스팅하려면 Android 기기에서 AIVane 앱을 실행해야 합니다.
Agent Android 데이터 스키마 및 분류 체계
이 스킬은 주로 Android UI 계층 구조와 메타데이터를 통해 데이터를 구성합니다. 정보 구조는 다음과 같습니다:
| 데이터 유형 | 설명 |
|---|---|
| UI Tree | 모든 가시적인 화면 요소와 해당 속성을 계층적으로 표현합니다. |
| RefID | 빠른 REPL 상호 작용을 위해 요소에 할당된 임시 세션 기반 정수입니다. |
| Resource ID | 특정 UI 구성 요소에 대해 네이티브 Android 개발자가 정의한 ID입니다. |
| XPath | 복잡한 레이아웃에서 요소를 고유하게 식별하는 데 사용되는 동적 생성 경로 문자열입니다. |
| Attributes | 텍스트, 클래스, 경계, 클릭 가능 여부를 포함한 요소의 메타데이터입니다. |
Agent Android 고급 기능
- 탐색적 기기 제어 및 실시간 디버깅을 위한 대화형 REPL 모드.
- 즉석에서 고유한 요소 선택기를 생성하고 검증하기 위한 고급 XPath 지원.
- 시각적 검증 또는 AI 분석을 위해 스냅샷을 저장하는 화면 캡처 기능.
- 필드 지우기 및 Home, Back과 같은 특수 시스템 키 입력을 포함한 포괄적인 입력 처리.
- 특정 텍스트나 요소가 화면에 나타날 때까지 Agent가 대기할 수 있도록 하는 대기 메커니즘.
SKILL.md
로드 중
관련 Openclaw 스킬
LLM Memory Integration
AI 에이전트의 영속적 컨텍스트를 위해 벡터 검색과 Sqlite 기반 FTS를 제공하는 하이브리드 메모리 관리 시스템입니다.
Blackboard Dark Poster Generator
진정한 손글씨 마커 타이포그래피와 미니멀리즘 디자인이 특징인 고대비 다크 포스터 및 튜토리얼 커버를 생성하는 AI agent 스킬입니다.
궈촹싸이(Guochuangsai) 비즈니스 모델 디자인 전문가
중국 국제 대학생 혁신 대회를 위한 승리하는 비즈니스 모델을 구축, 최적화 및 발표하도록 설계된 AI 기반 컨설턴트입니다.
위챗 공식 계정 초안 게시기
Markdown 또는 HTML 콘텐츠를 위챗 공식 계정 초안함으로 직접 업로드하기 위한 전문 자동화 스킬입니다.
추천*
