@chinaarjun/clawpilot
v1.0.1
Published
ClawAI relay client for Mac mini
Readme
ClawPilot
OpenClaw relay client for macOS and Linux hosts — connects your gateway machine for iOS app communication.
Installation
npm install -g @chinaarjun/clawpilotBeta Installation
For the Linux support test build:
npm install -g @chinaarjun/clawpilot@betaUsage
Pair
Generate a QR code for iOS pairing:
clawpilot pairPrint only the pairing code without rendering a QR code:
clawpilot pair --code-onlyOptions:
-n, --name <name>— Display name for this host--code-only— Print only the access code and skip QR code output
Run
Start the relay client:
clawpilot runCheck Status
Show pairing config and background service status:
clawpilot statusInstall Background Service
Install as a background service:
clawpilot install- macOS: installs a
launchduser agent - Linux: prefers
systemd --user, and falls back tonohupwhensystemctl --useris unavailable
On Linux hosts without systemd --user, clawpilot install will generate a fallback launcher at:
~/.clawai/clawpilot-start.shYou can start it manually with:
bash ~/.clawai/clawpilot-start.shStop Service
Stop the relay client background service:
clawpilot stopRemove Service
Remove the background service (keeps config):
clawpilot uninstallHow It Works
- Pair — Generate a QR code
- Scan QR with iOS app — iOS app pairs with your Mac
- Run — Relay client stays connected
- Communicate — iOS app sends commands to Mac
Requirements
- macOS or Linux
- Node.js 18+
License
MIT
