@clawapps/cli

Command-line client for the ClawApps AI agent platform. Authenticate via WeChat, interact with your agent workspace, and integrate with external AI assistants.

Install

npm install -g @clawapps/cli

Quick Start

# 1. Login (scan WeChat QR code)
clawapps login

# 2. Check balance
clawapps balance

# 3. Send a message to your agent
clawapps send "hello"

# 4. Or start a persistent session
clawapps connect

Commands

clawapps login

Log in via WeChat QR code. Scan with WeChat to authenticate (valid for 3 minutes). Tokens are stored locally for subsequent commands.

$ clawapps login
Scan with WeChat to login:
█████████████████████
█████████████████████
Waiting for authentication...
✔ Login successful!

clawapps logout

Log out and clear local credentials and session history.

clawapps send <message>

Send a message to your agent workspace and receive the response.

# Human-readable output
$ clawapps send "what's the weather in Toronto?"
Toronto today: 7°C, rainy. Bring an umbrella.

# JSON output (for AI assistant integration)
$ clawapps send "hello" --json
{"event":"session_created","session_id":"abc-123"}
{"event":"text","content":"Hello! How can I help you?"}
{"event":"complete","success":true,"usage":{...}}

Options: --json --session-id <id> --new-session --timeout <ms>

clawapps connect

Start a persistent interactive session with your agent workspace.

# Interactive mode
$ clawapps connect
Connected to session: abc-123
> hello
Hello! How can I help you?
> /quit

# JSON pipe mode (AI assistant integration)
$ clawapps connect --json

Options: --json --session-id <id> --timeout <ms>

clawapps balance

Check your credit balance.

$ clawapps balance
Account Balance
  Credits:    78.16
  Membership: free

$ clawapps balance --json
{"credits":78.16,"membership":"free","display_name":"sammi"}

clawapps sessions

List or manage local session history.

$ clawapps sessions
$ clawapps sessions --clear

AI Assistant Integration

External AI assistants (e.g., Claude Code) can use the CLI as a subprocess:

export CLAWAPPS_ACCESS_TOKEN="eyJ..."
export CLAWAPPS_REFRESH_TOKEN="eyJ..."
clawapps send "deploy my app" --json

JSON events (stdout, one per line):

Event	Description
session_created	Session ID assigned
text	Assistant response text (streaming)
mode_change	Switched from Gemini to Claude mode
complete	Response finished with usage stats
cost	Credits consumed and remaining balance
error	Error occurred

Credentials

Tokens stored at ~/.clawapps/credentials.json (permissions 0600).

Environment variables override local credentials:

• CLAWAPPS_ACCESS_TOKEN — Access token
• CLAWAPPS_REFRESH_TOKEN — Refresh token
• CLAWAPPS_RELAY_URL — Custom relay endpoint

Development

npm install
npm run build
node bin/claw.js

Requirements

• Node.js >= 18

License

MIT - Copyright 2026 ClawApps