Anyclaw
Your Local Agent, Anywhere.
Install / Use
/learn @paean-ai/AnyclawREADME
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-bridgevia 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/chatwith{"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.
