Guides
CLI-automatisering
Gebruik --non-interactive om openclaw onboard te automatiseren.
Basisvoorbeeld voor niet-interactief gebruik
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
Voeg --json toe voor een machineleesbare samenvatting.
Gebruik --skip-bootstrap wanneer je automatisering workspace-bestanden vooraf aanmaakt en je niet wilt dat onboarding de standaard bootstrap-bestanden maakt.
Gebruik --secret-input-mode ref om door env ondersteunde refs in auth-profielen op te slaan in plaats van platte tekstwaarden.
Interactieve selectie tussen env-refs en geconfigureerde provider-refs (file of exec) is beschikbaar in de onboarding-flow.
In niet-interactieve ref-modus moeten provider-env-vars zijn ingesteld in de procesomgeving.
Het doorgeven van inline sleutelvlaggen zonder de bijbehorende env-var faalt nu direct.
Voorbeeld:
openclaw onboard --non-interactive \
--mode local \
--auth-choice openai-api-key \
--secret-input-mode ref \
--accept-risk
Providerspecifieke voorbeelden
Voorbeeld met Anthropic API-sleutel
openclaw onboard --non-interactive \
--mode local \
--auth-choice apiKey \
--anthropic-api-key "$ANTHROPIC_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
Gemini-voorbeeld
openclaw onboard --non-interactive \
--mode local \
--auth-choice gemini-api-key \
--gemini-api-key "$GEMINI_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
Z.AI-voorbeeld
openclaw onboard --non-interactive \
--mode local \
--auth-choice zai-api-key \
--zai-api-key "$ZAI_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
Voorbeeld met Vercel AI Gateway
openclaw onboard --non-interactive \
--mode local \
--auth-choice ai-gateway-api-key \
--ai-gateway-api-key "$AI_GATEWAY_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
Voorbeeld met Cloudflare AI Gateway
openclaw onboard --non-interactive \
--mode local \
--auth-choice cloudflare-ai-gateway-api-key \
--cloudflare-ai-gateway-account-id "your-account-id" \
--cloudflare-ai-gateway-gateway-id "your-gateway-id" \
--cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
Moonshot-voorbeeld
openclaw onboard --non-interactive \
--mode local \
--auth-choice moonshot-api-key \
--moonshot-api-key "$MOONSHOT_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
Mistral-voorbeeld
openclaw onboard --non-interactive \
--mode local \
--auth-choice mistral-api-key \
--mistral-api-key "$MISTRAL_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
Synthetic-voorbeeld
openclaw onboard --non-interactive \
--mode local \
--auth-choice synthetic-api-key \
--synthetic-api-key "$SYNTHETIC_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
OpenCode-voorbeeld
openclaw onboard --non-interactive \
--mode local \
--auth-choice opencode-zen \
--opencode-zen-api-key "$OPENCODE_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
Wissel naar --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" voor de Go-catalogus.
Ollama-voorbeeld
openclaw onboard --non-interactive \
--mode local \
--auth-choice ollama \
--custom-model-id "qwen3.5:27b" \
--accept-risk \
--gateway-port 18789 \
--gateway-bind loopback
Voorbeeld met aangepaste provider
openclaw onboard --non-interactive \
--mode local \
--auth-choice custom-api-key \
--custom-base-url "https://llm.example.com/v1" \
--custom-model-id "foo-large" \
--custom-api-key "$CUSTOM_API_KEY" \
--custom-provider-id "my-custom" \
--custom-compatibility anthropic \
--custom-image-input \
--gateway-port 18789 \
--gateway-bind loopback
--custom-api-key is optioneel. Als deze wordt weggelaten, controleert onboarding CUSTOM_API_KEY.
OpenClaw markeert algemene vision-model-ID's automatisch als geschikt voor afbeeldingsinvoer. Voeg --custom-image-input toe voor onbekende aangepaste vision-ID's, of --custom-text-input om metadata voor alleen tekst af te dwingen.
Variant voor ref-modus:
export CUSTOM_API_KEY="your-key"
openclaw onboard --non-interactive \
--mode local \
--auth-choice custom-api-key \
--custom-base-url "https://llm.example.com/v1" \
--custom-model-id "foo-large" \
--secret-input-mode ref \
--custom-provider-id "my-custom" \
--custom-compatibility anthropic \
--custom-image-input \
--gateway-port 18789 \
--gateway-bind loopback
In deze modus slaat onboarding apiKey op als { source: "env", provider: "default", id: "CUSTOM_API_KEY" }.
Anthropic setup-token blijft beschikbaar als ondersteund onboarding-tokenpad, maar OpenClaw geeft nu de voorkeur aan hergebruik van Claude CLI wanneer beschikbaar. Geef voor productie de voorkeur aan een Anthropic API-sleutel.
Nog een agent toevoegen
Gebruik openclaw agents add <name> om een aparte agent te maken met een eigen workspace,
sessies en auth-profielen. Uitvoeren zonder --workspace start de wizard.
openclaw agents add work \
--workspace ~/.openclaw/workspace-work \
--model openai/gpt-5.5 \
--bind whatsapp:biz \
--non-interactive \
--json
Wat dit instelt:
agents.list[].nameagents.list[].workspaceagents.list[].agentDir
Opmerkingen:
- Standaard-workspaces volgen
~/.openclaw/workspace-<agentId>. - Voeg
bindingstoe om inkomende berichten te routeren (de wizard kan dit doen). - Niet-interactieve vlaggen:
--model,--agent-dir,--bind,--non-interactive.
Gerelateerde docs
- Onboarding-hub: Onboarding (CLI)
- Volledige referentie: CLI-installatiereferentie
- Commandoreferentie:
openclaw onboard