PhysiClaw
An AI agent that physically operates a phone — the way you do.
PhysiClaw watches a phone's screen with a camera and taps it with a stylus, working the phone the way a person would. No APIs, no OAuth, no ADB cables, nothing installed on the phone — just unlock it, set it on the desk, and let the agent work.
It's built for the everyday errands that pile up — ordering takeout, shopping for groceries, booking a ride, paying a bill, replying to a message. Anything you can do by hand on your phone, PhysiClaw can do for you.
Why a physical body?
The apps that run your daily life are closed off: most expose no public API, and simulated input — desktop automation or Android's ADB — leaves software fingerprints that anti-bot systems flag. So PhysiClaw treats the screen itself as the API: a camera reads it, a stylus performs the gestures. To the phone it's indistinguishable from a real finger — nothing to detect — and it reaches virtually any app reliably.
The trade-off is speed: a few seconds per action, in exchange for universality and reliability.
How it works
PhysiClaw has its own dedicated phone running its own WhatsApp account. Add it as a contact and chat with it like a real person — tell it what you need in plain language:
Order a latte on DoorDash.
What's the weather tomorrow?
Buy milk and eggs on Instacart.
Its runtime loops continuously, waking the agent when a scheduled task is due or the screen lights up with a new message. The agent unlocks the phone, reads your message, and does the task — pausing for confirmation when it matters, like a payment — then replies with the result, saves its memory, and exits until it's next woken.
Getting started
You'll need the PhysiClaw hardware — the arm, stylus, and camera — plus an iPhone for it to operate.
The physiclaw CLI runs on macOS, Windows, and Linux:
# Install the CLI (uv + Python 3.12 + physiclaw)
curl -fsSL https://physiclaw.ai/install.sh | bash
# Windows: iwr -useb https://physiclaw.ai/install.ps1 | iex
physiclaw models key <provider> # add your LLM API key
physiclaw models use <provider/model> # pick the model the agent runs on
physiclaw doctor # check your environment
physiclaw # start the server — opens the hardware-setup wizard, then runs the agent
License
MIT — both the CAD-as-code hardware and the agent software.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file physiclaw-0.4.1.tar.gz.
File metadata
- Download URL: physiclaw-0.4.1.tar.gz
- Upload date:
- Size: 2.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.8.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e27dfe76494582913317f2501d441f7d61c10747143bd676f29b0159f7420358
|
|
| MD5 |
69054ed4097009c8f7795e6fa4bd1eb2
|
|
| BLAKE2b-256 |
001e42c85216ee696d4e0b4879fa0620f32ee407eb11c18371a9ec74d872bcd0
|
File details
Details for the file physiclaw-0.4.1-py3-none-any.whl.
File metadata
- Download URL: physiclaw-0.4.1-py3-none-any.whl
- Upload date:
- Size: 660.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.8.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c6162a6f6b846b4531f07c1688ddc04618ca01db6732c8afc364a53b42d52e1d
|
|
| MD5 |
788b76af0e936d40d3ee1be725a2b803
|
|
| BLAKE2b-256 |
7482cf81f2579be1dccaae24a9ad51274d1be8b23a69f0dbad0bff98328c1f6c
|
