docs/cli/setup.md

metadata

summary: CLI reference for `openclaw setup` (initialize config + workspace)
read_when:
  - You’re doing first-run setup without the full onboarding wizard
  - You want to set the default workspace path
title: setup

openclaw setup

Initialize ~/.openclaw/openclaw.json and the agent workspace.

Related:

• Getting started: Getting started
• Wizard: Onboarding

Examples

openclaw setup
openclaw setup --workspace ~/.openclaw/workspace

To run the wizard via setup:

openclaw setup --wizard