phoneclaw - GitLite

KO | EN

gitlite — search

#javascript #hacktoberfest #react #llm #golang #machine-learning #linux #docker #awesome #kubernetes #vue #security #mcp #open-source

phoneclaw

(★ 565)

A version of openClaw/Clawdbot that automates android phones entirely without root, including all apps from a side-loaded APK. Acts as your 24/7 personal assistant on your phone.

파일 탐색기

최종 버전 다운로드 (.zip)

- - codeStyleConfig.xml
  - Project.xml
- .gitignore
- .name
- AndroidProjectSystem.xml
- compiler.xml
- deploymentTargetSelector.xml
- deviceManager.xml
- gradle.xml
- kotlinc.xml
- migrations.xml
- misc.xml
- runConfigurations.xml
- .gitignore
- build.gradle.kts
- google-services.json.example
- proguard-rules.pro
- instagram_clawscript.txt
- medium_clawscript.txt
- tiktok_clawscript.txt
- twitter_clawscript.txt
- youtube_clawscript.txt
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- libs.versions.toml
.gitignore
build.gradle.kts
gradle.properties
gradlew
gradlew.bat
LICENSE
README.md
settings.gradle.kts
SKILL.md
SuperPowers 4.png

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/rohanarun/phoneclaw

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd phoneclaw

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Gradle (Java/Kotlin)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java/Kotlin 프로젝트를 빌드/실행하려면 필요합니다.
Gradle 레포에 포함된 gradlew(Gradle Wrapper)를 쓰면 Gradle을 따로 설치할 필요가 없습니다.

cd app

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

./gradlew build

Gradle로 빌드를 진행합니다.

✅ BUILD SUCCESSFUL 메시지가 뜨면 성공입니다. build/ 폴더에 결과물이 생성됩니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**PhoneClaw**
PhoneClaw is an Android automation app that runs on-device workflows and lets you generate automation logic at runtime using **ClawScript**, a JavaScript-based scripting language built into the app.

PhoneClaw is inspired by Claude Bot/Claude Code and attempts to rebuild the agent loop for android phones natively to act as your personal assistant with access to all your apps.

**OpenClaw Install***

npm install -g superpowers-ai
superpowers --help

Open the URL it gives you to control the stream.

npm package: https://npmjs.com/package/superpowers-ai

Chrome Extension: https://chromewebstore.google.com/detail/superpowers-ai/oolmdenpaebkcokkccakmlmhcpnogalc

Clawhub: https://clawhub.ai/rohanarun/super-powers

**Docs**

https://rohanarun-phoneclaw.mintlify.app/

**Demos**

World's first software-only iPhone Automation: https://www.youtube.com/watch?v=QT67RvAt69o

Live demo: https://getsupers.com

iOS App: https://apps.apple.com/us/app/superpowers-ai/id6758969961

Apple Vision Pro demo: https://x.com/Viewforge/status/2028401641549164834

Automate your old Androids: https://youtube.com/live/Thc2sAt8uuk

Automated locking agent: https://x.com/Viewforge/status/2028591471860097289

Automated X Community Mod Agent: https://x.com/Viewforge/status/2028115961711415657

$phoneclaw(Solana token) integrated into our app: https://x.com/Viewforge/status/2026482468430426558

Flying Drones with AI:

[![Flying Drones with AI:](https://img.youtube.com/vi/SWb7RLR1lD0/0.jpg)](https://www.youtube.com/watch?v=SWb7RLR1lD0)

Automating Twitter In A Waymo With Android XR

[![Automating Twitter In A Waymo:](https://img.youtube.com/vi/_F5Wfbragh8/0.jpg)](https://www.youtube.com/watch?v=_F5Wfbragh8)

Automating Uploading Videos To Tiktok With Songs:

[![Automating Uploading Videos To Tiktok With Songs:](https://img.youtube.com/vi/TRqPFSixaog/0.jpg)](https://www.youtube.com/watch?v=TRqPFSixaog)

Automating Creating Instagram Accounts With 2FA From Email:

[![Automating Creating Instagram Accounts](https://img.youtube.com/vi/9zR43vLYCMs/0.jpg)](https://www.youtube.com/watch?v=9zR43vLYCMs)

Automating Captchas:

[![Automating Captchas:](https://img.youtube.com/vi/aBgbr27fR5M/0.jpg)](https://www.youtube.com/watch?v=aBgbr27fR5M)

**Updates**
- 2/19/26 updated to allow selecting the openrouter model

**What It Can Do**
- Automate multi-step app workflows on Android using the Accessibility service.
- Generate scripts at runtime for flexible, adaptive automations.
- Use vision-assisted UI targeting to click controls without hardcoded coordinates.
- Read visible on-screen text and values for branching, validation, and handoffs.
- Schedule automations with cron-like timing for recurring tasks.
- Chain actions across apps (browser, email, media, messaging) inside a single flow.
- Build flows that adapt to different device sizes, layouts, and language settings.

**Setup Instructions**
1) The cheapest phone is a $30 Moto G play you can buy at Walmart in the US. It is the phone used in the demos.
2) Enable developer mode on your android. You do not need to root the device.
3) Download Android Studio, download this Repo, open the Repo, and click Build > Generate Bundles or APKs > Generate APKs. 
4) Sideload the APK by downloading it or transferring it to your android and clicking install. Click allow when it asks for permissions.
5) When the app opens, use the voice commands to generate a simple automation like "open twitter and click the blue post button every hour"
6) It will run the agent, schedule it, then output a file you can edit in simple language like below.

**ClawScript**
ClawScript runs inside PhoneClaw using an embedded JS engine and exposes helper functions for automation, scheduling, and screen understanding. It is designed for fast iteration: write or generate small scripts at runtime, execute them immediately, and adjust based on UI feedback.

**ClawScript API (Core Helpers)**
- `speakText(text)` — Reads out text using on-device TTS to confirm state or provide progress.
- `delay(ms)` — Pauses execution for a specific number of milliseconds.
- `schedule(task, cronExpression)` — Registers a task string to run on a cron-like schedule.
- `clearSchedule()` — Removes all scheduled tasks.
- `magicClicker(description)` — Finds a UI element by natural-language description and taps it.
- `magicScraper(description)` — Answers a targeted question about what is visible on screen.
- `sendAgentEmail(to, subject, message)` — Sends an email from the device for notifications or handoffs.
- `safeInt(value, defaultVal)` — Safely parses values to integers with a fallback.

**magicClicker**
- Uses a screenshot plus vision to locate a target described in plain language.
- Taps the best-matching UI element through the Accessibility service.
- Best for repeatable flows where the UI layout may shift between devices.

**magicScraper**
- Uses a screenshot plus vision to answer a targeted question about what is visible.
- Returns a concise string that you can parse or branch on in your script.
- Best for reading text like OTP codes, status labels, or field values.

**Example Script**
```js
magicClicker("Create account")
delay(1500)
magicClicker("Email address field")
// ... type text via your own input helpers
magicClicker("Next")
const otp = magicScraper("The 2FA code shown in the SMS notification")
// ... submit otp
```

**Setup**
- Provide your Moondream auth token via Gradle properties (kept out of git):

```properties
# local.properties (project root) OR ~/.gradle/gradle.properties
MOONDREAM_AUTH=YOUR_TOKEN_HERE
```

**Community**

Discord: https://discord.gg/supers

Youtube: https://www.youtube.com/@getsuperpowers

Twitter: [https://x.com/i/communities/2025816983716184465](https://x.com/i/communities/2026071470741635468)