Configuration

OpenClaw reads an optional JSON5 config from ~/.openclaw/openclaw.json.

If the file is missing, OpenClaw uses safe defaults.

Recommended flow

  1. Run onboarding once: openclaw onboard --install-daemon
  2. Validate before changing things blindly: openclaw doctor

Edit options

  • Wizard: openclaw configure
  • CLI one-liners: openclaw config get|set|unset …
  • Control UI: run openclaw dashboard, then open http://localhost:18789/ and use the Config tab

When config fails validation

  • The Gateway may refuse to start until config matches the schema.
  • Apply repairs/migrations with openclaw doctor --fix (or --yes).

Related