GitHub - physiclaw/PhysiClaw: The AI agent that interacts with you in the real world. · GitHub
/" data-turbo-transient="true" />
Skip to content
Search/
Sign in<br>Sign upAppearance settings
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
physiclaw
PhysiClaw
Public
Notifications<br>You must be signed in to change notification settings
Fork<br>35
Star<br>351
main
BranchesTags
Go to file
CodeOpen more actions menu
Latest commit
History<br>1,640 Commits<br>1,640 Commits
Folders and files<br>NameNameLast commit message<br>Last commit date<br>.github/workflows
.github/workflows
docs
docs
hardware
hardware
licenses
licenses
scripts
scripts
skills
skills
src/physiclaw
src/physiclaw
tests
tests
.gitignore
.gitignore
.markdownlint.json
.markdownlint.json
.python-version
.python-version
LICENSE
LICENSE
Makefile
Makefile
README.md
README.md
THIRD_PARTY_NOTICES.md
THIRD_PARTY_NOTICES.md
install.ps1
install.ps1
install.sh
install.sh
pyproject.toml
pyproject.toml
uv.lock
uv.lock
View all files
Repository files navigation
PhysiClaw
An AI agent that physically operates a phone — the way you do.
English docs · Demo video
中文文档 · 演示视频
PhysiClaw watches a phone's screen with a camera and taps it with a stylus,<br>working the phone the way a person would. No APIs, no OAuth, no ADB cables,<br>nothing installed on the phone — just unlock it, set it on the desk, and let<br>the agent work.
It's built for the everyday errands that pile up — ordering takeout, shopping<br>for groceries, booking a ride, paying a bill, replying to a message. Anything<br>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,<br>and simulated input — desktop automation or Android's ADB — leaves software<br>fingerprints that anti-bot systems flag. So PhysiClaw treats the screen itself<br>as the API: a camera reads it, a stylus performs the gestures. To the phone<br>it's indistinguishable from a real finger — nothing to detect — and it reaches<br>virtually any app reliably.
The trade-off is speed: a few seconds per action, in exchange for universality<br>and reliability.
How it works
PhysiClaw has its own dedicated phone running its own WhatsApp account.<br>Add it as a contact and chat with it like a real person — tell it what you need<br>in plain language:
Order a latte on DoorDash.<br>What's the weather tomorrow?<br>Buy milk and eggs on Instacart.
Its runtime loops continuously, waking the agent when a scheduled task is due<br>or the screen lights up with a new message. The agent unlocks the phone, reads<br>your message, and does the task — pausing for confirmation when it matters,<br>like a payment — then replies with the result, saves its memory, and exits<br>until it's next woken.
Getting started
You'll need the PhysiClaw hardware — the arm, stylus, and camera — plus an<br>iPhone for it to operate.
The physiclaw CLI runs on macOS, Windows, and Linux:
# add your LLM API key<br>physiclaw models use # pick the model the agent runs on<br>physiclaw doctor # check your environment<br>physiclaw # start the server — opens the hardware-setup wizard, then runs the agent"># Install the CLI (uv + Python 3.12 + physiclaw)<br>curl -fsSL https://physiclaw.ai/install.sh | bash<br># Windows: iwr -useb https://physiclaw.ai/install.ps1 | iex
physiclaw models key provider> # add your LLM API key<br>physiclaw models use provider/model> # pick the model the agent runs on<br>physiclaw doctor # check your environment<br>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.
About<br>The AI agent that interacts with you in the real world.<br>physiclaw.ai<br>Topics<br>agentic-aiai-agentembodied-agentembodied-aigui-agentgui-agentsphone-automationphone-use-agentrobot-arm<br>Resources<br>Readme<br>MIT license<br>Activity<br>Stars<br>351 stars<br>Watchers<br>3 watching<br>Forks<br>35 forks<br>Report repository
Releases
Packages
Contributors
Languages
You can’t perform that action at this time.