docs/cli/setup.md
openclaw setupInitialize the baseline config and agent workspace. With any onboarding flag present, also runs the wizard.
<Note> `openclaw setup` is for mutable config installs. In Nix mode (`OPENCLAW_NIX_MODE=1`) OpenClaw refuses setup writes because the config file is managed by Nix. Use the first-party [nix-openclaw Quick Start](https://github.com/openclaw/nix-openclaw#quick-start) or the equivalent source config for another Nix package. </Note>| Flag | Description |
|---|---|
--workspace <dir> | Agent workspace directory (default ~/.openclaw/workspace; stored as agents.defaults.workspace). |
--wizard | Run interactive onboarding. |
--non-interactive | Run onboarding without prompts. |
--mode <mode> | Onboarding mode: local or remote. |
--import-from <provider> | Migration provider to run during onboarding. |
--import-source <path> | Source agent home for --import-from. |
--import-secrets | Import supported secrets during onboarding migration. |
--remote-url <url> | Remote Gateway WebSocket URL. |
--remote-token <token> | Remote Gateway token (optional). |
openclaw setup runs the wizard when any of these flags are explicitly present, even without --wizard:
--wizard, --non-interactive, --mode, --import-from, --import-source, --import-secrets, --remote-url, --remote-token.
openclaw setup
openclaw setup --workspace ~/.openclaw/workspace
openclaw setup --wizard
openclaw setup --wizard --import-from hermes --import-source ~/.hermes
openclaw setup --non-interactive --mode remote --remote-url wss://gateway-host:18789 --remote-token <token>
openclaw setup initializes config and workspace without running the full onboarding flow.openclaw onboard for the full guided journey, openclaw configure for targeted changes, or openclaw channels add to add channel accounts.