Setup

text

Copy

openclaw setup

Initialize

and the agent workspace.

Related:

• Getting started: Getting started
• CLI onboarding: Onboarding (CLI)

Examples

bash
Copy
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>

Options

• text

  Copy

  --workspace <dir>
  : agent workspace directory (stored as
  text

  Copy

  agents.defaults.workspace
  )
• text

  Copy

  --wizard
  : run onboarding
• text

  Copy

  --non-interactive
  : run onboarding without prompts
• text

  Copy

  --mode <local|remote>
  : onboarding mode
• text

  Copy

  --import-from <provider>
  : migration provider to run during onboarding
• text

  Copy

  --import-source <path>
  : source agent home for
  text

  Copy

  --import-from
• text

  Copy

  --import-secrets
  : import supported secrets during onboarding migration
• text

  Copy

  --remote-url <url>
  : remote Gateway WebSocket URL
• text

  Copy

  --remote-token <token>
  : remote Gateway token

To run onboarding via setup:

bash
Copy
openclaw setup --wizard

Notes:

• Plain
  text

  Copy

  openclaw setup
  initializes config + workspace without the full onboarding flow.
• Onboarding auto-runs when any onboarding flags are present (
  text

  Copy

  --wizard
  ,
  text

  Copy

  --non-interactive
  ,
  text

  Copy

  --mode
  ,
  text

  Copy

  --import-from
  ,
  text

  Copy

  --import-source
  ,
  text

  Copy

  --import-secrets
  ,
  text

  Copy

  --remote-url
  ,
  text

  Copy

  --remote-token
  ).
• If Hermes state is detected, interactive onboarding can offer migration automatically. Import onboarding requires a fresh setup; use Migrate for dry-run plans, backups, and overwrite mode outside onboarding.

Related

• CLI reference
• Install overview