Setup Wizard

> Built by GetAgentIQ — [getagentiq.ai](https://getagentiq.ai)

Complete first-run setup for OpenClaw. Goes from fresh install to working agent in one command.

Quick Start

# Full interactive setup
python3 scripts/setup-wizard.py

# Check what's already configured
python3 scripts/setup-wizard.py --check

# Run specific setup steps only
python3 scripts/setup-wizard.py --steps api,model,memory

# Non-interactive (use defaults / env vars)
python3 scripts/setup-wizard.py --auto

What It Configures

Step 1: Environment Check

• Verify OpenClaw is installed and accessible
• Check Node.js version (v18+ required)
• Detect existing configuration
• Identify workspace directory

Step 2: API Key Setup

• Prompt for provider API keys (Anthropic, OpenAI, Google)
• Validate each key with a test API call
• Store in openclaw.json (encrypted section)
• Support environment variable fallback

Step 3: Model Selection

• Present tier options: Budget / Standard / Premium
• Show cost estimates per tier
• Configure default model in openclaw.json
• Set up model fallback chain

Step 4: Messaging Channel (Optional)

• Choose: Telegram, Discord, Slack, or skip
• Walk through bot token setup
• Verify connection with test message
• Configure channel in openclaw.json

Step 5: Memory System

• Create MEMORY.md, USER.md, SOUL.md templates
• Set up memory/ directory with today's file
• Create HEARTBEAT.md with sensible defaults
• Initialize AGENTS.md with workspace conventions

Step 6: First Heartbeat

• Configure heartbeat interval (default: 30 min)
• Run a test heartbeat to verify everything works
• Show the agent's first response

Step 7: Summary

• Display final configuration
• Show estimated monthly cost
• List next steps and tips
• Offer to run a test conversation

Parameters

| Parameter | Default | Description |

|-----------|---------|-------------|

| --check | false | Only check current config, don't modify |

| --steps | all | Comma-separated steps: api,model,messaging,memory,heartbeat |

| --auto | false | Non-interactive, use env vars and defaults |

| --workspace | ~/.openclaw/workspace | Workspace directory |

| --provider | none | Pre-select API provider (anthropic/openai/google) |

| --format | text | Output format for --check: text, json |

Profiles

When run with --auto, the wizard applies sensible defaults based on detected use case:

• Developer: Sonnet default, GitHub integration, code-focused memory
• Business: Haiku default, email integration, cost-optimized
• Creator: Sonnet default, social media channels, content memory

Error Recovery

If setup fails at any step:

• Previous steps are preserved
• Run --steps to retry just that step
• --check shows what's configured vs missing
• All changes are logged to memory/setup-log.md