# WristClaw

> Talk to your OpenClaw AI agent from your wrist. Voice in, voice out, visual thumbnails. Standalone Apple Watch app over a zero-trust encrypted relay.

WristClaw is a standalone Apple Watch + iPhone companion that lets you converse with an [OpenClaw](https://openclaw.ai) AI agent without your phone present. The Watch connects directly through a stateless relay over WSS; messages are end-to-end encrypted (X25519 ECDH + ChaCha20-Poly1305) so the relay sees only ciphertext. Pairing is one-time via QR code; sessions persist autonomously thereafter.

Repository layout:
- `relay/` — Go reverse-proxy / message router (Docker-packaged)
- `ios/` — Xcode project, two targets (`WristClaw` iPhone companion, `WristClaw Watch App` standalone)
- `openclaw/` — Python channel adapter that bridges relay traffic into an OpenClaw agent
- `web/` — this landing page
- `bin/deploy.sh` — one-shot deploy to the production host

## Architecture

- [README](https://github.com/gado-ships-it/WristClaw/blob/main/README.md): full architecture, message types, encryption details, requirements
- [Relay protocol](https://wristclaw.app/protocol.txt): message-frame layout, JOIN frame, type codes
- [Privacy & security notes](https://wristclaw.app/security.txt): trust boundaries, what the relay can and cannot see

## API surface

- `wss://wristclaw.app/ws` — relay WebSocket endpoint. First frame is a 17-byte JOIN (16 bytes session UUID + 1 byte role: 0=host, 1=watch). All subsequent frames are forwarded verbatim to the peer in the same session. Header: `[16 session_id | 1 type | 4 seq | 4 len | 12 nonce | ciphertext]`.
- `https://wristclaw.app/health` — liveness check. Returns plain-text `ok` (200) when the relay container is healthy.
- `https://wristclaw.app/mcp` — Model Context Protocol endpoint (Streamable HTTP). Read-only resources for protocol spec, README, security notes; status tool for relay health.

## Optional

- [Source on GitHub](https://github.com/gado-ships-it/WristClaw): private repo; collaborators only
- [llmstxt.org](https://llmstxt.org/): about this file format
- [OpenClaw](https://openclaw.ai): the agent platform WristClaw connects to