2026-01-15 06:12:54 +00:00
|
|
|
|
---
|
2026-03-16 05:50:48 +00:00
|
|
|
|
summary: "CLI reference for `openclaw setup` (initialize config + workspace)"
|
2026-01-15 06:12:54 +00:00
|
|
|
|
read_when:
|
2026-03-16 05:50:48 +00:00
|
|
|
|
- You’re doing first-run setup without the full setup wizard
|
2026-01-15 06:12:54 +00:00
|
|
|
|
- You want to set the default workspace path
|
2026-01-31 16:04:03 -05:00
|
|
|
|
title: "setup"
|
2026-01-15 06:12:54 +00:00
|
|
|
|
---
|
|
|
|
|
|
|
2026-01-30 03:15:10 +01:00
|
|
|
|
# `openclaw setup`
|
2026-01-15 06:12:54 +00:00
|
|
|
|
|
2026-03-16 05:50:48 +00:00
|
|
|
|
Initialize `~/.openclaw/openclaw.json` and the agent workspace.
|
2026-01-15 06:12:54 +00:00
|
|
|
|
|
|
|
|
|
|
Related:
|
2026-01-31 21:13:13 +09:00
|
|
|
|
|
2026-01-15 06:12:54 +00:00
|
|
|
|
- Getting started: [Getting started](/start/getting-started)
|
2026-03-16 05:50:48 +00:00
|
|
|
|
- Wizard: [Onboarding](/start/onboarding)
|
2026-01-15 06:12:54 +00:00
|
|
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
2026-01-30 03:15:10 +01:00
|
|
|
|
openclaw setup
|
|
|
|
|
|
openclaw setup --workspace ~/.openclaw/workspace
|
2026-01-15 06:12:54 +00:00
|
|
|
|
```
|
|
|
|
|
|
|
2026-03-16 05:50:48 +00:00
|
|
|
|
To run the wizard via setup:
|
2026-03-15 22:00:13 -07:00
|
|
|
|
|
2026-03-16 05:50:48 +00:00
|
|
|
|
```bash
|
|
|
|
|
|
openclaw setup --wizard
|
|
|
|
|
|
```
|
