PhysiClaw
An AI agent that physically operates a phone — the way you do.
English docs · Demo video · Assembly video
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
Metadata
1 maintainer
Release files for physiclaw 0.7.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| physiclaw-0.7.5.tar.gz | 3.7 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| physiclaw-0.7.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.8 MB
Release files / physiclaw-0.7.5.tar.gz
| Download URL | physiclaw-0.7.5.tar.gz |
|---|---|
| Size | 3.7 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
42c20645dbd1bcfa0c1b2e7d2a394acafd821417d83beca2310cbef0c9c12afb
|
|
BLAKE2b-256 checksum How to use checksums |
1a5af8f392a7b1c3f6c4dec63e5b35fca37f194702f93dc35137ac36bb5e6664
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.2
|
Release files / physiclaw-0.7.5-py3-none-any.whl
| Download URL | physiclaw-0.7.5-py3-none-any.whl |
|---|---|
| Size | 1.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
092a179815eb9d3e8c0d5bb7804f78f393d92d8dc8ba0d2ab9c2009891f153d9
|
|
BLAKE2b-256 checksum How to use checksums |
87205de574df382daa7cb5bcb28d85b7e893cbe627e526dfaa32889487e05fc9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.2
|
Security for physiclaw 0.7.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
