profclaw onboard

Synopsis

profclaw onboard [flags]

Description

onboard is the recommended first command to run after installing profClaw. It walks through a 6-step wizard:

Environment Detection - scans for Node.js, Redis, Ollama, Claude CLI, Git, Docker
Deployment Mode - recommends pico, mini, or pro based on available resources
AI Provider - configure Anthropic, OpenAI, or Ollama (or skip for later)
Configuration - generates .env and config/settings.yml
Setup - creates the admin account and database
Validation - verifies all required files were created

Flags

boolean

Run without prompts. Useful for Docker builds, CI pipelines, and automated deployments. Uses defaults or values from other flags.

string

Deployment mode to configure. One of pico, mini, or pro. If omitted in interactive mode, recommended based on detected resources.

string

AI provider to configure in non-interactive mode. One of anthropic, openai, ollama. API keys must already be set as environment variables.

string

default:"3000"

Server port to write into the generated .env file.

Examples

profclaw onboard

profclaw onboard --non-interactive --mode mini

ANTHROPIC_API_KEY=sk-ant-... profclaw onboard --non-interactive --mode mini --provider anthropic

REDIS_URL=redis://localhost:6379 profclaw onboard --non-interactive --mode pro

Deployment Modes

Mode	RAM	Use case
`pico`	~50 MB	Agent + tools only, IoT, edge devices, personal use
`mini`	~150 MB	Dashboard, cron, integrations - small teams and home servers
`pro`	~300 MB	Everything, requires Redis - production and enterprise

What Gets Created

After onboarding succeeds:

.env                     # Environment configuration
config/settings.yml      # Server settings
data/profclaw.db         # SQLite database

After Onboarding

profclaw serve           # Start the server
profclaw doctor          # Verify everything is healthy
profclaw chat            # Start an interactive chat session

profclaw init - Lightweight init without the wizard
profclaw doctor - Diagnose environment issues
profclaw serve - Start the HTTP server
profclaw config - Manage configuration

CLI Overview

Setup

Core

Tasks

Providers

Tools

Integrations

Security

System

Synopsis

Description

Flags

Examples

Deployment Modes

What Gets Created

After Onboarding

​Synopsis

​Description

​Flags

​Examples

​Deployment Modes

​What Gets Created

​After Onboarding

​Related

Synopsis

Description

Flags

Examples

Deployment Modes

What Gets Created

After Onboarding

Related