openclaw/docs/cli/setup.md

summary, read_when, title

summary	read_when	title
CLI reference for `openclaw setup` (initialize config/workspace or run the setup wizard)	You want first-run setup without the guided wizard You want the guided setup wizard via `openclaw setup --wizard` You want to set the default workspace path	setup

openclaw setup

Initialize ~/.openclaw/openclaw.json and the agent workspace, or run the guided setup wizard.

Related:

• Getting started: Getting started
• Setup wizard: Setup Wizard (CLI)
• macOS app onboarding: Onboarding

Examples

openclaw setup
openclaw setup --workspace ~/.openclaw/workspace
openclaw setup --wizard
openclaw setup --wizard --install-daemon

Without flags, openclaw setup only ensures config + workspace defaults. Use --wizard for the full guided flow.

Modes

• openclaw setup: initialize config/workspace defaults only
• openclaw setup --wizard: guided setup for auth, gateway, channels, and skills
• openclaw setup --wizard --non-interactive: scripted setup flow

Related guides

• Setup wizard guide: Setup Wizard (CLI)
• Setup wizard reference: CLI Setup Reference
• Setup wizard automation: CLI Automation
• Legacy alias: openclaw onboard