CLI commands

Configureren

openclaw configure

Interactieve prompts voor gerichte wijzigingen aan een bestaande installatie: referenties, apparaten, standaardinstellingen voor agents, Gateway, kanalen, plugins, Skills en statuscontroles.

Gebruik openclaw onboard of openclaw setup voor het volledige begeleide traject bij de eerste uitvoering, openclaw setup --baseline alleen voor de basisconfiguratie/-werkruimte en openclaw channels add wanneer je alleen kanaalaccounts hoeft in te stellen.

Opties

--section <section>: herhaalbaar sectiefilter. Beschikbare secties:

workspace, model, web, gateway, daemon, channels, plugins, skills, health

bash
openclaw configureopenclaw configure --section webopenclaw configure --section model --section channelsopenclaw configure --section gateway --section daemon

Als je gateway, daemon of health selecteert (of de volledige wizard uitvoert zonder --section), wordt gevraagd waar de Gateway draait en wordt gateway.mode bijgewerkt. Sectiefilters die alle drie overslaan, gaan rechtstreeks naar de gevraagde configuratie zonder prompt voor de gatewaymodus. Als je de externe gatewaymodus kiest, wordt de externe configuratie weggeschreven en wordt de wizard onmiddellijk afgesloten; uitsluitend lokale stappen, zoals het installeren van plugins, worden niet uitgevoerd.

Modelsectie

Wanneer configure vanuit een keuze voor providerauthenticatie wordt gestart, geven de kiezers voor het standaardmodel en modelbeleid automatisch de voorkeur aan die provider. Voor gekoppelde providers zoals Volcengine en BytePlus geldt dezelfde voorkeur ook voor hun coding-planvarianten (volcengine-plan/*, byteplus-plan/*). Als het filter voor de voorkeursprovider een lege lijst zou opleveren, valt configure terug op de ongefilterde catalogus in plaats van een lege kiezer weer te geven.

Websectie

openclaw configure --section web selecteert een provider voor zoeken op het web en configureert de referenties daarvan. Sommige providers tonen providerspecifieke vervolgvragen:

  • Grok kan optionele configuratie voor x_search aanbieden met hetzelfde xAI OAuth-profiel of dezelfde API-sleutel, en je een x_search-model laten kiezen.
  • Kimi kan vragen naar de Moonshot API-regio (api.moonshot.ai tegenover api.moonshot.cn) en het standaardmodel van Kimi voor zoeken op het web.

Overige opmerkingen

  • Na lokale configuratiewijzigingen installeert configure geselecteerde downloadbare plugins wanneer dit voor het gekozen configuratietraject vereist is. Bij een externe Gateway-configuratie worden geen lokale pluginpakketten geïnstalleerd.
  • Kanaalgerichte services (Slack/Discord/Matrix/Microsoft Teams) vragen tijdens de configuratie om acceptatielijsten voor kanalen/ruimten. Je kunt namen of ID's invoeren; de wizard zet namen waar mogelijk om in ID's.
  • Als je de installatiestap voor de daemon uitvoert, vereist tokenauthenticatie een token. Als gateway.auth.token door SecretRef wordt beheerd, valideert configure de SecretRef, maar slaat het opgeloste token niet als leesbare tekst op in de omgevingsmetadata van de supervisorservice; als de SecretRef niet kan worden opgelost, blokkeert configure de installatie van de daemon met uitvoerbare herstelrichtlijnen.
  • Als zowel gateway.auth.token als gateway.auth.password zijn geconfigureerd en gateway.auth.mode niet is ingesteld, blokkeert configure de installatie van de daemon totdat je de modus expliciet instelt.

Gerelateerd

Was this useful?
On this page

On this page