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
docker run -d \
--name profclaw \
-p 3000:3000 \
-v profclaw-data:/data \
profclaw/profclaw:latest
services:
profclaw:
image: profclaw/profclaw:latest
ports:
- "3000:3000"
volumes:
- profclaw-data:/data
environment:
- PROFCLAW_MODE=mini
- PORT=3000
volumes:
profclaw-data:
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
http://localhost:3000. Post-Install Setup
After installation, run the interactive setup wizard:
profclaw init
profclaw onboard
- 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
