Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
openclaw onboard

Interactieve onboarding voor lokale of externe Gateway-configuratie.

​
Gerelateerde handleidingen

CLI-onboardinghub

Doorloop van de interactieve CLI-stroom.

Onboardingoverzicht

Hoe OpenClaw-onboarding samenhangt.

Referentie voor CLI-configuratie

Uitvoer, interne werking en gedrag per stap.

CLI-automatisering

Niet-interactieve vlaggen en gescripte configuraties.

Onboarding voor de macOS-app

Onboardingstroom voor de macOS-menubalkapp.

​
Voorbeelden

openclaw onboard
openclaw onboard --modern
openclaw onboard --flow quickstart
openclaw onboard --flow manual
openclaw onboard --flow import
openclaw onboard --import-from hermes --import-source ~/.hermes
openclaw onboard --skip-bootstrap
openclaw onboard --mode remote --remote-url wss://gateway-host:18789
--flow import gebruikt door plugins beheerde migratieproviders zoals Hermes. Het draait alleen op een nieuwe OpenClaw-configuratie; als bestaande config, referenties, sessies of werkruimtegeheugen-/identiteitsbestanden aanwezig zijn, reset dan of kies een nieuwe configuratie voordat je importeert. --modern start de preview van de conversationele Crestodian-onboarding. Zonder --modern behoudt openclaw onboard de klassieke onboardingstroom. Voor platte-tekst private-network ws://-doelen (alleen vertrouwde netwerken), stel je OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 in de procesomgeving van onboarding in. Er is geen openclaw.json-equivalent voor deze client-side transport- noodoplossing. Niet-interactieve aangepaste provider: 
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 \
  --custom-image-input
--custom-api-key is optioneel in niet-interactieve modus. Als deze wordt weggelaten, controleert onboarding CUSTOM_API_KEY. OpenClaw markeert veelvoorkomende vision-model-ID’s automatisch als geschikt voor afbeeldingen. Geef --custom-image-input door voor onbekende aangepaste vision-ID’s, of --custom-text-input om metadata voor alleen tekst af te dwingen. LM Studio ondersteunt ook een providerspecifieke sleutelvlag in niet-interactieve modus: 
openclaw onboard --non-interactive \
  --auth-choice lmstudio \
  --custom-base-url "http://localhost:1234/v1" \
  --custom-model-id "qwen/qwen3.5-9b" \
  --lmstudio-api-key "$LM_API_TOKEN" \
  --accept-risk
Niet-interactieve Ollama: 
openclaw onboard --non-interactive \
  --auth-choice ollama \
  --custom-base-url "http://ollama-host:11434" \
  --custom-model-id "qwen3.5:27b" \
  --accept-risk
--custom-base-url gebruikt standaard http://127.0.0.1:11434. --custom-model-id is optioneel; als deze wordt weggelaten, gebruikt onboarding de voorgestelde standaardwaarden van Ollama. Cloudmodel-ID’s zoals kimi-k2.5:cloud werken hier ook. Sla providersleutels op als refs in plaats van platte tekst: 
openclaw onboard --non-interactive \
  --auth-choice openai-api-key \
  --secret-input-mode ref \
  --accept-risk
Met --secret-input-mode ref schrijft onboarding env-ondersteunde refs in plaats van sleutelwaarden in platte tekst. Voor providers met auth-profielen schrijft dit keyRef-vermeldingen; voor aangepaste providers schrijft dit models.providers.<id>.apiKey als een env-ref (bijvoorbeeld { source: "env", provider: "default", id: "CUSTOM_API_KEY" }). Contract voor niet-interactieve ref-modus:
  • Stel de provider-env-var in de procesomgeving van onboarding in (bijvoorbeeld OPENAI_API_KEY).
  • Geef geen inline sleutelvlaggen door (bijvoorbeeld --openai-api-key), tenzij die env-var ook is ingesteld.
  • Als een inline sleutelvlag wordt doorgegeven zonder de vereiste env-var, faalt onboarding snel met begeleiding.
Gateway-tokenopties in niet-interactieve modus:
  • --gateway-auth token --gateway-token <token> slaat een token in platte tekst op.
  • --gateway-auth token --gateway-token-ref-env <name> slaat gateway.auth.token op als een env SecretRef.
  • --gateway-token en --gateway-token-ref-env sluiten elkaar uit.
  • --gateway-token-ref-env vereist een niet-lege env-var in de procesomgeving van onboarding.
  • Met --install-daemon, wanneer tokenauthenticatie een token vereist, worden door SecretRef beheerde Gateway-tokens gevalideerd maar niet als opgeloste platte tekst bewaard in metadata van de supervisorserviceomgeving.
  • Met --install-daemon, als tokenmodus een token vereist en de geconfigureerde token-SecretRef niet kan worden opgelost, faalt onboarding gesloten met herstelbegeleiding.
  • Met --install-daemon, als zowel gateway.auth.token als gateway.auth.password zijn geconfigureerd en gateway.auth.mode niet is ingesteld, blokkeert onboarding de installatie totdat de modus expliciet is ingesteld.
  • Lokale onboarding schrijft gateway.mode="local" naar de config. Als in een later configbestand gateway.mode ontbreekt, behandel dat dan als configschade of een onvolledige handmatige bewerking, niet als een geldige snelkoppeling voor lokale modus.
  • --allow-unconfigured is een afzonderlijke escape hatch voor de Gateway-runtime. Het betekent niet dat onboarding gateway.mode mag weglaten.
Voorbeeld: 
export OPENCLAW_GATEWAY_TOKEN="your-token"
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice skip \
  --gateway-auth token \
  --gateway-token-ref-env OPENCLAW_GATEWAY_TOKEN \
  --accept-risk
Niet-interactieve gezondheid van lokale Gateway:
  • Tenzij je --skip-health doorgeeft, wacht onboarding op een bereikbare lokale Gateway voordat het succesvol afsluit.
  • --install-daemon start eerst het beheerde Gateway-installatiepad. Zonder deze optie moet er al een lokale Gateway draaien, bijvoorbeeld openclaw gateway run.
  • Als je in automatisering alleen config-/werkruimte-/bootstrap-schrijfacties wilt, gebruik dan --skip-health.
  • Als je werkruimtebestanden zelf beheert, geef dan --skip-bootstrap door om agents.defaults.skipBootstrap: true in te stellen en het maken van AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md en BOOTSTRAP.md over te slaan.
  • Op native Windows probeert --install-daemon eerst Scheduled Tasks en valt terug op een loginitem in de Startup-map per gebruiker als taakcreatie wordt geweigerd.
Gedrag van interactieve onboarding met referentiemodus:
  • Kies Geheime referentie gebruiken wanneer daarom wordt gevraagd.
  • Kies daarna een van beide:
    • Omgevingsvariabele
    • Geconfigureerde geheime provider (file of exec)
  • Onboarding voert een snelle preflightvalidatie uit voordat de ref wordt opgeslagen.
    • Als de validatie mislukt, toont onboarding de fout en kun je het opnieuw proberen.

​
Niet-interactieve Z.AI-eindpuntkeuzes

--auth-choice zai-api-key detecteert automatisch het beste Z.AI-eindpunt voor je sleutel (geeft de voorkeur aan de algemene API met zai/glm-5.1). Als je specifiek de GLM Coding Plan-eindpunten wilt, kies dan zai-coding-global of zai-coding-cn.
# Promptless endpoint selection
openclaw onboard --non-interactive \
  --auth-choice zai-coding-global \
  --zai-api-key "$ZAI_API_KEY"

# Other Z.AI endpoint choices:
# --auth-choice zai-coding-cn
# --auth-choice zai-global
# --auth-choice zai-cn
Niet-interactief Mistral-voorbeeld: 
openclaw onboard --non-interactive \
  --auth-choice mistral-api-key \
  --mistral-api-key "$MISTRAL_API_KEY"

​
Stroomnotities

  • quickstart: minimale prompts, genereert automatisch een Gateway-token.
  • manual: volledige prompts voor poort, bind en auth (alias van advanced).
  • import: voert een gedetecteerde migratieprovider uit, toont een preview van het plan en past dit daarna toe na bevestiging.
Wanneer een auth-keuze een voorkeursprovider impliceert, filtert onboarding de standaardmodel- en allowlist-kiezers vooraf op die provider. Voor Volcengine en BytePlus komt dit ook overeen met de coding-plan-varianten (volcengine-plan/*, byteplus-plan/*).Als het voorkeursproviderfilter nog geen geladen modellen oplevert, valt onboarding terug op de ongefilterde catalogus in plaats van de kiezer leeg te laten.
Sommige webzoekproviders activeren providerspecifieke vervolgprompts:
  • Grok kan optionele x_search-configuratie aanbieden met dezelfde XAI_API_KEY en een x_search-modelkeuze.
  • Kimi kan vragen naar de Moonshot API-regio (api.moonshot.ai versus api.moonshot.cn) en het standaard Kimi-webzoekmodel.
  • DM-scopegedrag bij lokale onboarding: Referentie voor CLI-configuratie.
  • Snelste eerste chat: openclaw dashboard (Control UI, geen kanaalconfiguratie).
  • Aangepaste provider: verbind elk OpenAI- of Anthropic-compatibel eindpunt, inclusief gehoste providers die niet worden vermeld. Gebruik Unknown voor automatische detectie.
  • Als Hermes-status wordt gedetecteerd, biedt onboarding een migratiestroom aan. Gebruik Migreren voor dry-run-plannen, overschrijfmodus, rapporten en exacte toewijzingen.

​
Veelvoorkomende vervolgopdrachten

openclaw configure
openclaw agents add <name>
--json impliceert geen niet-interactieve modus. Gebruik --non-interactive voor scripts.