anyclaw-web

v0.1.0

Published

3 days ago

AnyClaw — Access your local AI agent from anywhere

Downloads

0High
0Medium
0Low

AnyClaw is a lightweight web frontend that connects to your local AI agent through a secure cloud relay. No port forwarding, no VPN, no complex setup — just a key.

curl -sL anyclaw.sh | bash

How It Works

  Browser (anyclaw.sh / anyclaw.dev)
           │
           ▼
     Cloud Relay (ClawKey auth)
           │
           ▼
     anyclaw-bridge (sidecar)
           │
           ▼
     Local Agent (0claw / paeanclaw / zeroclaw / openclaw / any OpenAI-compatible)

Get a ClawKey — generate a guest key instantly or sign in for a persistent one.
Run the bridge — the bridge connects your local agent to the relay with zero changes to the agent itself.
Open anyclaw.sh — you're connected from any device.

Quick Install

The one-line installer detects your local agent, installs the bridge, generates a key, and opens the web UI:

curl -sL anyclaw.sh | bash

What it does:

Detects running agents (0claw, paeanclaw, zeroclaw, openclaw, OpenAI-compatible)
Installs anyclaw-bridge via npm
Generates a guest ClawKey (24h TTL)
Starts the bridge in background
Opens anyclaw.sh?claw_key=<your-key> in the browser

Manual Setup

1. Start your local agent

0claw              # default port 3007 — minimal Rust runtime
# or
paeanclaw          # default port 3007 — Node.js/Bun runtime
# or
zeroclaw           # default port 42617 — full Rust agent platform
# or any OpenAI-compatible server

2. Get a ClawKey

Visit anyclaw.sh and type /guest in the terminal, or use the web UI to generate one.

3. Run the bridge

npx anyclaw-bridge -g http://localhost:3007 -k ck_g_your_key_here

Bridge options:

| Flag | Description | Default | |------|-------------|---------| | -g, --gateway | Local agent URL | http://localhost:3007 | | -t, --type | Gateway type: claw, openai | claw | | -k, --key | ClawKey for relay auth | (required) | | -s, --service | Relay service URL | https://api.paean.ai |

Environment variables: CLAW_KEY, GATEWAY_URL, ANYCLAW_SERVICE_URL.

Two Modes

| Mode | URL | Description | |------|-----|-------------| | Shell | anyclaw.sh | Terminal-style interface. Dark, monospace, retro. | | Dev | anyclaw.dev | Modern chat interface. Light/dark theme, rich rendering. |

Override during development: http://localhost:5173?mode=shell or ?mode=dev.

ClawKey

ClawKeys authenticate and route messages between the web UI and your local agent.

| Type | Prefix | TTL | Auth Required | |------|--------|-----|---------------| | Guest | ck_g_ | 24h | No | | Persistent | ck_p_ | None | Google / Apple / Paean |

Cross-Device Access

Share your ClawKey across devices:

Copy key — reveal the full key in the web UI and copy it.
Share URL — generate a link like anyclaw.sh?claw_key=ck_... that auto-connects.
QR code — scan from your phone to connect instantly (generated client-side, keys never leave your device).
Account sync — sign in for persistent keys that sync across all devices.

Shell Commands

All system commands use a / prefix. When connected, text without / is sent as chat.

/guest             Generate a temporary guest key
/connect [key]     Connect using a ClawKey
/disconnect        Disconnect from local agent
/refresh           Regenerate key (persistent keys, requires auth)
/share             Show share URL for cross-device access
/qr                Show QR code for mobile app to scan
/install           Show one-line install command
/status            Show connection status
/key               Show current ClawKey
/gateways          List all gateways with status
/switch <name>     Switch active gateway
/clear             Clear terminal
/help              Show all commands

Supported Agents

AnyClaw works with any local AI agent that speaks one of two protocols:

Claw Protocol (`POST /api/chat` → SSE)

| Agent | Language | Install | Default Port | Description | |-------|----------|---------|--------------|-------------| | 0claw | Rust | curl -fsSL https://0.works/install.sh \| bash | 3007 | The absolute core. ~500 lines, single binary, MCP tools, SQLite. | | PaeanClaw | TypeScript | npm install -g paeanclaw | 3007 | Ultra-minimal (~365 lines). MCP tools, web PWA, Telegram. | | ZeroClaw | Rust | cargo install zeroclaw | 42617 | Full agent platform. 50+ tools, 20+ channels, hardware support. | | OpenClaw | Python | pip install openclaw | 3007 | Feature-rich. 60+ tools, voice mode, 16+ platforms. | | NanoClaw | Docker | docker pull nanoclaw/nanoclaw | 3007 | Container-isolated. Docker/Apple Container sandboxing. |

All claw agents share the same SSE streaming API:

POST /api/chat with {"message": "...", "conversationId": "..."}
Returns SSE events: start, content, tool_call, tool_result, done, error

OpenAI Protocol (`POST /v1/chat/completions` → SSE)

Any OpenAI-compatible server also works:

| Server | Default Port | |--------|-------------| | LM Studio | 1234 | | vLLM | 8080 | | Ollama | 11434 |

Use --type openai when starting the bridge for these servers.

Architecture

┌─────────────────────────────────────────────────────────┐
│  anyclaw (web frontend)                                 │
│  React 19 · Vite · Tailwind v4 · TypeScript             │
│                                                         │
│  ┌─────────────┐  ┌──────────────┐                      │
│  │ ShellPage   │  │ DevPage      │                      │
│  │ (terminal)  │  │ (chat UI)    │                      │
│  └──────┬──────┘  └──────┬───────┘                      │
│         └────────┬───────┘                              │
│                  ▼                                       │
│          lib/api.ts (REST + SSE)                        │
└──────────────────┬──────────────────────────────────────┘
                   │ X-Claw-Key
                   ▼
          Cloud Relay (zero-api)
                   │
                   ▼
┌──────────────────────────────────────────────────────────┐
│  anyclaw-bridge (Node.js sidecar)                        │
│                                                          │
│  Polls relay → Claims requests → Forwards to gateway     │
│  Pushes SSE events back → Completes requests             │
│                                                          │
│  Adapters: claw (0claw/paeanclaw/zeroclaw), openai        │
└──────────────────┬───────────────────────────────────────┘
                   │
                   ▼
          Local AI Agent (any port, any framework)

Development

# Install dependencies
npm install

# Start dev server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

Bridge Development

cd bridge
npm install
npm run build   # compiles src/ → dist/
npm run dev     # build + run

Configuration

| Variable | Description | Default | |----------|-------------|---------| | VITE_API_URL | Relay API endpoint | http://localhost:4777 |

Local Testing

For full end-to-end testing:

# Terminal 1: Start your local agent
paeanclaw

# Terminal 2: Start the web frontend
npm run dev

# Terminal 3: Run the bridge (connects to https://api.paean.ai by default)
cd bridge && node dist/index.js -k <your-key>

Or simply:

ANYCLAW_SERVICE_URL=http://localhost:4777 ANYCLAW_WEB_URL=http://localhost:5173 bash public/install.sh

Security

ClawKey routing — keys contain a routing ID that directs traffic to your bridge instance. The relay never sees your agent's internal state.
No agent modification — the bridge is a standalone sidecar. Your agent code is untouched.
Guest key expiry — guest keys auto-expire after 24 hours.
Rate limiting — relay enforces per-key rate limits (20 req/min, 3 concurrent).
QR codes — generated entirely client-side. Keys never leave your browser.
HTTPS — all relay communication is over TLS.

Tech Stack

License

MIT