❯ $ clawapps --connect
ClawApps CLI
Command-line direct access to your Claw workspace. One-line connect for OpenClaw, Claude Code, Codex, Cursor and any AI agent.
$
| 1 | |
| 2 | # @clawapps/cli |
| 3 | |
| 4 | Command-line client for the ClawApps AI workspace. |
| 5 | Plug in Claude Code, Codex, Cursor and other AI agents in one line. |
| 6 | |
| 7 | ## Install |
| 8 | |
| 9 | npm install -g @clawapps/cli |
| 10 | |
| 11 | ## Quick start |
| 12 | |
| 13 | # 1. Sign in (scan WhatsApp QR) |
| 14 | $ clawapps login |
| 15 | |
| 16 | # 2. Check balance |
| 17 | $ clawapps balance |
| 18 | |
| 19 | # 3. Send a message to your workspace |
| 20 | $ clawapps send "Hello" |
| 21 | |
| 22 | # 4. Or open a persistent session |
| 23 | $ clawapps connect |
| 24 | |
| 25 | ## Commands |
| 26 | |
| 27 | ### clawapps login |
| 28 | |
| 29 | Sign in by scanning the WhatsApp QR (valid for 3 minutes). |
| 30 | Credentials are stored locally and reused by later commands. |
| 31 | |
| 32 | $ clawapps login |
| 33 | Scan with WhatsApp to login: |
| 34 | █████████████████████ |
| 35 | Waiting for authentication... |
| 36 | ✔ Login successful! |
| 37 | |
| 38 | ### clawapps send <message> |
| 39 | |
| 40 | Send a message to your workspace and stream the reply. |
| 41 | |
| 42 | $ clawapps send "Weather in Toronto?" |
| 43 | Toronto today: 7°C, light rain. Bring an umbrella. |
| 44 | |
| 45 | # JSON output (for AI agent integration) |
| 46 | $ clawapps send "Hi" --json |
| 47 | {"event":"session_created","session_id":"abc-123"} |
| 48 | {"event":"text","content":"Hi! How can I help?"} |
| 49 | {"event":"complete","success":true} |
| 50 | |
| 51 | ### clawapps connect |
| 52 | |
| 53 | Open a persistent interactive session with your workspace. |
| 54 | |
| 55 | $ clawapps connect |
| 56 | Connected to session: abc-123 |
| 57 | > Hello |
| 58 | Hi! How can I help? |
| 59 | > /quit |
| 60 | |
| 61 | ### clawapps balance |
| 62 | |
| 63 | Show credit balance and membership status. |
| 64 | |
| 65 | $ clawapps balance |
| 66 | Account Balance |
| 67 | Credits: 78.16 |
| 68 | Membership: free |
| 69 | |
| 70 | ### clawapps logout |
| 71 | |
| 72 | Sign out and clear local credentials and session history. |
| 73 | |
| 74 | ### clawapps sessions |
| 75 | |
| 76 | List or manage local session history. |
| 77 | |
| 78 | $ clawapps sessions |
| 79 | $ clawapps sessions --clear |
| 80 | |
| 81 | ## AI agent integration |
| 82 | |
| 83 | External agents (Claude Code, Codex, Cursor, etc.) can call the CLI as a subprocess: |
| 84 | |
| 85 | export CLAWAPPS_ACCESS_TOKEN="eyJ..." |
| 86 | export CLAWAPPS_REFRESH_TOKEN="eyJ..." |
| 87 | $ clawapps send "Deploy my app" --json |
| 88 | |
| 89 | ## Credentials |
| 90 | |
| 91 | Stored at: ~/.clawapps/credentials.json (mode 0600) |
| 92 | |
| 93 | Environment variables override local credentials: |
| 94 | CLAWAPPS_ACCESS_TOKEN access token |
| 95 | CLAWAPPS_REFRESH_TOKEN refresh token |
| 96 | CLAWAPPS_RELAY_URL custom relay endpoint |
| 97 | |
| 98 | ## Requirements |
| 99 | |
| 100 | Node.js >= 18 |
| 101 |