OpenClaw Module 1: Setup & First Agent

Run:
openclaw setup
openclaw setup --workspace ~/.openclaw/workspace

Expected:

• ~/.openclaw/openclaw.json is created or updated.
• A default agent workspace exists under ~/.openclaw/workspace (or the path you specified).

Run the interactive wizard:
openclaw onboard --flow quickstart

If you already know you want a remote gateway, use:
openclaw onboard --flow manual --mode remote --remote-url wss://gateway-host:18789

During the wizard:

• Pick a provider/model (for example, OpenAI or a custom endpoint).
• Accept the suggested defaults unless your org requires custom ports or auth.

If you need a fully non-interactive run (for CI or automation), adapt one of the examples in the official docs, e.g.:
openclaw onboard --non-interactive --auth-choice custom-api-key \
--custom-base-url "https://llm.example.com/v1" \
--custom-model-id "foo-large" \
--custom-api-key "$CUSTOM_API_KEY" \
--secret-input-mode plaintext --custom-compatibility openai

Run:
openclaw doctor

If issues are reported, let the CLI apply safe fixes:
openclaw doctor --repair

When you want a deeper scan (sandbox, channels, cron, secrets):
openclaw doctor --deep

You should continue only when doctor reports healthy status or warns only about items you understand and accept.

List existing agents:
openclaw agents list

Create a new agent workspace:
openclaw agents add work --workspace ~/.openclaw/workspace-work

Inspect bindings (how channels map to agents):
openclaw agents bindings

If you already have a main workspace and just want to set identity:
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity