CLI automation

Use

to automate .

Baseline non-interactive example

bash
Copy
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --secret-input-mode plaintext \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --install-daemon \
  --daemon-runtime node \
  --skip-bootstrap \
  --skip-skills

Add

for a machine-readable summary.

Use

when your automation pre-seeds workspace files and does not want onboarding to create the default bootstrap files.

Use

to store env-backed refs in auth profiles instead of plaintext values. Interactive selection between env refs and configured provider refs ( or ) is available in the onboarding flow.

In non-interactive

mode, provider env vars must be set in the process environment. Passing inline key flags without the matching env var now fails fast.

Example:

bash
Copy
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice openai-api-key \
  --secret-input-mode ref \
  --accept-risk

Provider-specific examples

Anthropic API key example

Gemini example

Z.AI example

Vercel AI Gateway example

Cloudflare AI Gateway example

Moonshot example

Mistral example

Synthetic example

OpenCode example

Ollama example

Custom provider example

Anthropic setup-token remains available as a supported onboarding token path, but OpenClaw now prefers Claude CLI reuse when available. For production, prefer an Anthropic API key.

Add another agent

Use

to create a separate agent with its own workspace, sessions, and auth profiles. Running without launches the wizard.

bash
Copy
openclaw agents add work \
  --workspace ~/.openclaw/workspace-work \
  --model openai/gpt-5.5 \
  --bind whatsapp:biz \
  --non-interactive \
  --json

What it sets:

• text

  Copy

  agents.list[].name
• text

  Copy

  agents.list[].workspace
• text

  Copy

  agents.list[].agentDir

Notes:

• Default workspaces follow
  text

  Copy

  ~/.openclaw/workspace-<agentId>
  .
• Add
  text

  Copy

  bindings
  to route inbound messages (the wizard can do this).
• Non-interactive flags:
  text

  Copy

  --model
  ,
  text

  Copy

  --agent-dir
  ,
  text

  Copy

  --bind
  ,
  text

  Copy

  --non-interactive
  .

Related docs

• Onboarding hub: Onboarding (CLI)
• Full reference: CLI Setup Reference
• Command reference:
  text

  Copy

  openclaw onboard