Installation - profClaw

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

npm install -g profclaw

Verify the installation:

profclaw version

pnpm add -g profclaw

Verify the installation:

profclaw version

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:

profclaw doctor

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.

​System Requirements

​Install Methods

​Post-Install Setup

​Verify the Installation

​Next Steps

Onboarding Wizard

First Run

Deployment Modes

Docker Deployment

System Requirements

Install Methods

Post-Install Setup

Verify the Installation

Next Steps