ClawApps
ClawApps
❯ $ 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.

$
View on GitHub
1 
2# @clawapps/cli
3 
4Command-line client for the ClawApps AI workspace.
5Plug in Claude Code, Codex, Cursor and other AI agents in one line.
6 
7## Install
8 
9npm 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 
29Sign in by scanning the WhatsApp QR (valid for 3 minutes).
30Credentials are stored locally and reused by later commands.
31 
32$ clawapps login
33Scan with WhatsApp to login:
34█████████████████████
35Waiting for authentication...
36✔ Login successful!
37 
38### clawapps send <message>
39 
40Send a message to your workspace and stream the reply.
41 
42$ clawapps send "Weather in Toronto?"
43Toronto 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 
53Open a persistent interactive session with your workspace.
54 
55$ clawapps connect
56Connected to session: abc-123
57> Hello
58Hi! How can I help?
59> /quit
60 
61### clawapps balance
62 
63Show credit balance and membership status.
64 
65$ clawapps balance
66Account Balance
67 Credits: 78.16
68 Membership: free
69 
70### clawapps logout
71 
72Sign out and clear local credentials and session history.
73 
74### clawapps sessions
75 
76List or manage local session history.
77 
78$ clawapps sessions
79$ clawapps sessions --clear
80 
81## AI agent integration
82 
83External agents (Claude Code, Codex, Cursor, etc.) can call the CLI as a subprocess:
84 
85export CLAWAPPS_ACCESS_TOKEN="eyJ..."
86export CLAWAPPS_REFRESH_TOKEN="eyJ..."
87$ clawapps send "Deploy my app" --json
88 
89## Credentials
90 
91Stored at: ~/.clawapps/credentials.json (mode 0600)
92 
93Environment 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 
100Node.js >= 18
101