Skip to main content

​
Configuration Sources

profClaw reads configuration from three sources, in order of priority (highest first):
  1. Environment variables - Override everything, ideal for Docker/CI
  2. settings.yml - File-based config in .profclaw/settings.yml
  3. Built-in defaults - Sensible defaults for mini mode

​
Quick Configuration

The fastest way to configure profClaw: 
# Set deployment mode
export PROFCLAW_MODE=mini

# Add an AI provider
export ANTHROPIC_API_KEY=sk-ant-your-key

# Start
profclaw serve

​
Configuration File

Create .profclaw/settings.yml for persistent configuration: 
mode: mini
port: 3000

providers:
  default: anthropic
  anthropic:
    apiKey: ${ANTHROPIC_API_KEY}
    model: claude-sonnet-4-6
  ollama:
    baseUrl: http://localhost:11434
    model: llama3.2

chat:
  defaultChannel: webchat
  maxHistoryLength: 100

security:
  mode: standard
  auditLog: true

queue:
  maxConcurrent: 25
  timeoutMs: 300000

​
Configuration via CLI

Use the profclaw config command for interactive configuration: 
# View current config
profclaw config show

# Set a value
profclaw config set providers.default anthropic

# Add a provider
profclaw config providers add openai

# Reset to defaults
profclaw config reset

​
Configuration Sections

Environment Variables

Complete reference of all 130+ environment variables with defaults and descriptions.

settings.yml

File-based configuration with YAML schema reference.

Security Config

Security modes, guards, audit settings, and device trust policies.

Deployment Modes

Mode-specific feature availability and resource limits.