System Requirements Requirement Minimum Recommended Node.js 22+ 22 LTS RAM 512MB (pico) 2GB+ (mini/pro) Disk 500MB 2GB+ Redis Optional Required for pro mode
Node.js 22 or later is required. Check your version with node --version. Install or upgrade via nodejs.org or a version manager like nvm. Install Methods npm
pnpm
Docker
Docker (Pico)
From Source
Pull the latest image: docker pull profclaw/profclaw:latest
Run with default settings: docker run -d \ --name profclaw \ -p 3000:3000 \ -v profclaw-data:/data \ profclaw/profclaw:latest
Or use Docker Compose for a full stack with Redis: services : profclaw : image : profclaw/profclaw:latest ports : - "3000:3000" volumes : - profclaw-data:/data environment : - PROFCLAW_MODE=mini - PORT=3000 volumes : profclaw-data :
See the Docker Deployment guide for a production-ready setup with Redis, Nginx, and health checks. Optimized image for resource-constrained environments (Raspberry Pi, edge devices): docker pull profclaw/profclaw:pico
docker run -d \ --name profclaw \ -p 3000:3000 \ --memory=512m \ profclaw/profclaw:pico
Clone and build from source for development or contributions: git clone https://github.com/profclaw/profclaw.git cd profclaw pnpm install pnpm build pnpm dev
The dev server starts with hot reload at http://localhost:3000. Post-Install Setup After installation, run the interactive setup wizard:
profclaw init profclaw onboard
This will:
Create a .profclaw/ configuration directory
Detect your environment (Docker, VPS, local machine)
Recommend a deployment mode (pico/mini/pro)
Set up your first AI provider
Configure optional chat channels
See Onboarding for a step-by-step walkthrough of the wizard.
Verify the Installation Run the health check to confirm everything is configured correctly:
Expected output:
profClaw Doctor v2.x.x -------------------------- ✓ Node.js 22.x detected ✓ Configuration valid ✓ AI Provider: Anthropic connected ✓ Chat: Webchat ready on :3000 ✓ Security: Standard mode active ✓ Storage: SQLite initialized -------------------------- All checks passed!
If any checks fail, the doctor command prints the specific issue and a remediation hint. Common issues: missing API keys, port conflicts, or an outdated Node.js version.
Next Steps
Onboarding Wizard Step-by-step walkthrough of the interactive setup wizard.
First Run Start the server and send your first message to the agent.
Deployment Modes Compare pico, mini, and pro modes to pick the right one for your hardware.
Docker Deployment Production-ready Docker setup with Redis and persistent storage.
