What is VClaw Agent?
VClaw Agent is the client app distribution of the VClaw ecosystem — a complete, self-hosted AI agent stack that runs on your own hardware. Built on pi.dev's Pi Agent harness and controlled through PI WEB, it gives you a persistent, browser-accessible agent workspace you can reach from any device. Unlike cloud-only assistants, VClaw Agent lives on your infrastructure — NanoPi, Raspberry Pi, or a mini PC — with skills for web search, PDF reading, text-to-speech, image generation, and video production.
Architecture
A split-process architecture: browser UI → PI WEB → Session Daemon → Pi Agent + Skills
Platform Support
VClaw Agent runs across three platform families — deploy on what you have, scale as you grow.
NanoPi
- Pi Agent + PI WEB
- CPU-only skills
- Tailscale tailnet
- Auto-update
Raspberry Pi
- Pi Agent + PI WEB
- CPU-only skills
- HDMI display optional
- Hyperframes (RPi 5)
x86-64 Mini PC
- Full stack + GPU
- Ollama / local LLM
- Docker + PostgreSQL
- NATS JetStream
@vchatemail/agent — Unified Agent SDK
All VClawOS npm packages have been converged into one unified package. Install @vchatemail/agent to build custom agents that register with the VClaw NATS fabric, serve prompts, and become first-class members of your agent fleet.
@vchatemail/agentAll-in-one SDK: agent lifecycle, NATS connectivity, LLM-callable tools, CLI manager, and browser plugin for PI WEB fleet discovery.