openclaw setup

OpenClaw wordt geleverd met een ingebouwde systeemagent — die spreekt als "OpenClaw" — voor lokale installatie, reparatie en configuratie (voorheen Crestodian genoemd). Deze start pas nadat het effectieve standaardmodel een echte beurt heeft voltooid. Bij nieuwe installaties wordt eerst inferentie ingesteld; ongeldige configuratie blijft het klassieke doctor-pad volgen.

Wanneer deze start

Het uitvoeren van openclaw zonder subopdracht kiest een route op basis van de configuratiestatus:

• Configuratie ontbreekt of bevat geen door de gebruiker opgegeven instellingen (leeg of alleen $schema-/meta-sleutels): start begeleide onboarding met live AI-verificatie.
• Configuratie bestaat maar slaagt niet voor validatie: start klassieke onboarding, die de problemen meldt en je doorverwijst naar openclaw doctor.
• Configuratie bestaat en is geldig: opent de normale agent-TUI. Een bereikbare geconfigureerde Gateway waarvan de standaardagent een model heeft, gaat rechtstreeks naar die UI zonder onboarding of OpenClaw. Gebruik /openclaw in de TUI of voer openclaw setup rechtstreeks uit om OpenClaw later te openen.

Bij het uitvoeren van openclaw setup wordt eerst het geconfigureerde standaardmodel live getest. Na een geslaagde beurt start OpenClaw. Bij een interactieve fout wordt de begeleide inferentie-installatie geopend en wordt de besturing aan OpenClaw overgedragen nadat een kandidaat slaagt. Eenmalige, JSON- en andere niet-interactieve verzoeken mislukken met instructies om openclaw onboard uit te voeren wanneer inferentie niet beschikbaar is. openclaw --help en openclaw --version behouden hun normale snelle paden.

Niet-interactief kaal openclaw (zonder TTY) wordt afgesloten met een kort bericht in plaats van de hoofdhulp af te drukken: het verwijst naar niet-interactieve onboarding bij een nieuwe of ongeldige installatie, of naar openclaw agent --local ... wanneer de configuratie geldig is.

openclaw onboard --modern blijft een compatibiliteitsalias voor OpenClaw, maar gebruikt dezelfde inferentiepoort: werkende inferentie opent de chat, interactieve fouten starten de begeleide inferentie-installatie en niet-interactieve fouten worden afgesloten met onboardingbegeleiding. openclaw onboard --classic opent de volledige stapsgewijze wizard.

Wat OpenClaw toont

Interactieve OpenClaw opent dezelfde TUI-shell als openclaw tui, met een OpenClaw-chatbackend. De welkomsttekst bij het starten behandelt:

• de geldigheid van de configuratie en de standaardagent
• het geverifieerde model dat OpenClaw gebruikt
• de bereikbaarheid van de Gateway volgens de eerste controle bij het starten
• de volgende aanbevolen foutopsporingsactie

Er worden geen geheimen gedumpt en er worden niet alleen voor het starten CLI-opdrachten van plugins geladen.

Gebruik status voor de gedetailleerde inventaris: configuratiepad, documentatie-/bronpaden, lokale CLI-controles, aanwezigheid van sleutels/tokens, agents, model en Gateway-details.

OpenClaw gebruikt dezelfde referentiedetectie als reguliere agents: in een Git-checkout verwijst het naar lokale docs/ en de bronstructuur; in een npm-installatie gebruikt het meegeleverde documentatie en verwijst het naar https://github.com/openclaw/openclaw, met het advies de broncode te raadplegen wanneer de documentatie niet volstaat.

Voorbeelden

openclawopenclaw setupopenclaw setup --jsonopenclaw setup --message "modellen"openclaw setup --message "configuratie valideren"openclaw setup --message "werkruimte ~/Projects/work instellen" --yesopenclaw setup --message "standaardmodel instellen op openai/gpt-5.6" --yesopenclaw onboard --modern

In de OpenClaw-TUI:

statusgezondheiddoctorconfiguratie validereninstellenwerkruimte ~/Projects/work instellenconfiguratie gateway.port instellen op 19001configuratiereferentie gateway.auth.token instellen op env OPENCLAW_GATEWAY_TOKENgatewaystatusgateway herstartenagentsagent work maken met werkruimte ~/Projects/workmodellenmodelprovider configurerenstandaardmodel instellen op openai/gpt-5.6kanalenkanaalinformatie slackslack verbindenkanaalwizard voor slack openenplugins weergevenplugins zoeken slackplugin installeren clawhub:openclaw-codex-app-servermet werkagent pratenmet agent voor ~/Projects/work pratenauditafsluiten

Bewerkingen en goedkeuring

OpenClaw gebruikt getypeerde bewerkingen in plaats van de configuratie ad hoc te bewerken.

Alleen-lezenbewerkingen worden onmiddellijk uitgevoerd: overzicht tonen, agents weergeven, geïnstalleerde plugins weergeven, ClawHub-plugins zoeken, model-/backendstatus tonen, status-/gezondheidscontroles uitvoeren, bereikbaarheid van de Gateway controleren, doctor uitvoeren zonder interactieve reparaties, configuratie valideren en het pad naar het auditlogboek tonen.

Het starten van begeleide kanaalconfiguratie (connect telegram) wordt ook onmiddellijk uitgevoerd. De wizard verzamelt expliciete antwoorden en beheert de daaruit voortvloeiende schrijfbewerkingen.

Permanente bewerkingen vereisen goedkeuring in het gesprek (of --yes voor een directe opdracht): configuratie schrijven, config set, config set-ref, bootstrap voor installatie/onboarding, het standaardmodel wijzigen, de Gateway starten/stoppen/herstarten, agents maken en plugins installeren.

Doctor-reparaties zijn niet beschikbaar in OpenClaw, omdat ze de provider, authenticatie of inferentieroute van de standaardagent waarop de sessie draait, kunnen herschrijven. Sluit OpenClaw af en voer openclaw doctor --fix uit in een terminal. Alleen-lezen doctor blijft beschikbaar in OpenClaw.

Nieuwe agents nemen de live geverifieerde standaardinferentieroute over. De agent-id's openclaw en crestodian zijn gereserveerd voor de systeemagent en kunnen niet als normale agents worden gemaakt. De buiten gebruik gestelde id blijft geblokkeerd, zodat een oude configuratie deze niet kan claimen.

config set en config set-ref kunnen de status van de inferentieroute niet wijzigen, waaronder referenties van de inferentieprovider, auth.* op het hoogste niveau, modelcatalogi, CLI-backends, standaard-/agentspecifieke modelroutes, agentparameters/-tools of hoofd-tools.*. Onbewerkte schrijfbewerkingen onder env.*, secrets.*, plugins.* en $include worden eveneens geweigerd omdat ze de oplossing van referenties of activering van providers kunnen vervangen. Gateway- en kanaalauthenticatie blijven normale configuratieoppervlakken. Gebruik getypeerde plugin-/kanaalworkflows en set default model <provider/model> voor een reeds geconfigureerde route; de route wordt live getest voordat deze wordt opgeslagen. Om provider-/authenticatietoegang te configureren of te repareren, sluit je OpenClaw af en voer je openclaw onboard uit.

Het verwijderen van plugins wordt in OpenClaw geweigerd, omdat het verwijderen van een providerplugin de inferentieroute waarop de sessie draait kan uitschakelen. Sluit OpenClaw af en voer openclaw plugins uninstall <id> uit vanuit een terminal.

Goedkeuring geef je in je eigen woorden: ondubbelzinnige antwoorden ("ja", "zeker", "ga je gang", "nu niet") worden herkend aan de hand van een gesloten deterministische lijst. Wanneer de geconfigureerde route een afzonderlijke voltooiingsaanroep ondersteunt, kunnen andere antwoorden uitsluitend op basis van jouw bericht en het openstaande voorstel worden geclassificeerd — nooit door het gespreksmodel zelf, dat zichzelf niet kan goedkeuren. Niet-geclassificeerde of dubbelzinnige antwoorden laten het voorstel openstaan en in het gesprek wordt opnieuw om antwoord gevraagd.

Toegepaste schrijfbewerkingen worden vastgelegd in ~/.openclaw/audit/system-agent.jsonl. Detectie wordt niet geaudit; alleen toegepaste bewerkingen en schrijfbewerkingen worden dat.

Kanaalconfiguratie kan als een gehost gesprek worden uitgevoerd totdat een geheim nodig is. De lokale OpenClaw-TUI accepteert geen gevoelige wizardantwoorden, omdat chatinvoer in de terminal zichtbaar is. Deze biedt onmiddellijk open channel wizard aan, waarbij het geselecteerde kanaal wordt doorgegeven aan de afgeschermde terminalwizard; je kunt openclaw channels add --channel <channel> ook later uitvoeren.

Overschakelen naar afgeschermde kanaalconfiguratie

De lokale chat kan de besturing overdragen aan de afgeschermde kanaalwizard:

kanaalwizard voor slack openenkanaalinformatie slack

open channel wizard for <channel> opent afgeschermde kanaalconfiguratie nadat de chat-TUI is gesloten. Gebruik eerst channel info <channel> voor het kanaallabel, de configuratiestatus, een samenvatting van de vereisten en een link naar de documentatie.

OpenClaw wijzigt nooit provider-/authenticatietoegang vanuit zijn eigen sessie: de sessie is al afhankelijk van die inferentieroute. Voor installatie of reparatie van de modelprovider retourneert configure model provider begeleiding voor afsluiten/onboarding zonder een wizard te starten of configuratie te schrijven. Sluit OpenClaw af en voer openclaw onboard uit; onboarding bereidt de referenties voor en slaat alleen een route op die een echte live beurt voltooit. Start OpenClaw opnieuw nadat onboarding is geslaagd.

Installatiebootstrap

setup configureert de resterende werkruimte- en Gateway-status nadat begeleide onboarding de inferentie al heeft ingesteld. Deze schrijft alleen via getypeerde configuratiebewerkingen en vraagt eerst om goedkeuring.

instellenwerkruimte ~/Projects/work instellen

setup behoudt het geverifieerde effectieve model. Deze configureert of vervangt de inferentie niet.

Als inferentie ontbreekt of de live controle mislukt, sluit je OpenClaw af en voer je openclaw onboard uit. Begeleide onboarding detecteert geconfigureerde modellen, API-sleutels en geauthenticeerde lokale CLI's, vraagt elke kandidaat om een echt antwoord en slaat alleen een geslaagde route permanent op. OpenClaw start onmiddellijk na die grens en kan vervolgens de werkruimte, Gateway, kanalen, agents, plugins en andere optionele functies configureren.

De macOS-app slaat deze reeks volledig over wanneer deze een geconfigureerde Gateway bereikt waarvan de standaardagent al een geconfigureerd model heeft; de normale agent-UI wordt geopend. Voor een nieuwe of onvolledige Gateway doorloopt de app de inferentiereeks via de Gateway-methoden openclaw.setup.detect en openclaw.setup.activate: detecteren vermeldt elke gevonden kandidaat-backend, activeren test één kandidaat live (een echte voltooiing met "antwoord met OK") en slaat pas nadat de test slaagt alleen het model, de referentie en de provider-/runtimestatus op die voor die route nodig zijn. De standaardwaarden voor werkruimte en Gateway blijven voor OpenClaw. Een niet-geslaagde kandidaat wijzigt de configuratie nooit; de app doorloopt automatisch de reeks en biedt uiteindelijk een handmatige sleutel-/tokenstap aan die wordt ingevuld vanuit de actieve tekstinferentieproviderplugins van de Gateway. De geselecteerde provider beheert zijn startmodel en configuratie, en de referentie wordt op dezelfde manier geverifieerd voordat deze wordt opgeslagen.

Codex-supervisie en andere optionele pluginfuncties blijven buiten deze inferentieactiveringstransactie. Configureer ze pas nadat inferentie werkt en OpenClaw is gestart; bestaand pluginbeleid en expliciete uitsluitingen van supervisie blijven tijdens de inferentie-installatie ongewijzigd.

AI-gesprek

Het vrije gesprek van interactieve OpenClaw loopt via dezelfde agentlus als reguliere OpenClaw-agents, beperkt tot één OpenClaw-bevoegdheidstool van ring nul, openclaw, die de getypeerde bewerkingen omvat. Leesacties worden vrij uitgevoerd, mutaties vereisen jouw goedkeuring in het gesprek voor precies die bewerking (zie Bewerkingen en goedkeuring), en elke toegepaste schrijfbewerking wordt geaudit en opnieuw gevalideerd. De agentsessie blijft behouden, zodat OpenClaw echt geheugen over meerdere beurten heeft. Als de geverifieerde inferentieroute later niet meer werkt, keer je terug naar openclaw onboard en repareer je deze voordat je doorgaat.

De host zet verzoeken in natuurlijke taal niet om in bewerkingen. Vrije berichten — waaronder tekst die op opdrachten lijkt en vragen zoals "waarom is mijn gateway gestopt?" — gaan naar de AI, die het verzoek via de tool openclaw aan een getypeerde bewerking kan koppelen.

Wanneer een mutatie openstaat, worden alleen ondubbelzinnige goedkeurings- of afwijzingszinnen uit een gesloten lijst zonder inferentie verwerkt. Dubbelzinnige instemming gaat naar een afzonderlijke geconfigureerde voltooiingsaanroep en wordt anders veilig geweigerd. Gestructureerde wizardvelden en exacte hostnavigatie zijn UI-bedieningselementen, geen verwerking van bewerkingen in natuurlijke taal. Eén uitzondering voor de hygiëne van geheimen is bijzonder belangrijk: een exacte config set op een gevoelig pad (tokens, sleutels, wachtwoorden) bereikt nooit een model. De host maakt een geredigeerd voorstel en de waarde wordt afgeschermd in de voor de AI zichtbare geschiedenis. Geef voor geheimen de voorkeur aan config set-ref <path> env &lt;ENV_VAR&gt;.

De herstelmodus voor berichtkanalen gebruikt nooit de modelondersteunde planner. Herstel op afstand blijft deterministisch, zodat een defect of gecompromitteerd normaal agentpad niet als configuratie-editor kan worden gebruikt.

Vertrouwensmodel van het CLI-harnas

Ingebedde runtimes en de Codex-appserverharness dwingen de ring-zero- beperking rechtstreeks af: de uitvoering bevat een OpenClaw-toegestane-toolslijst met alleen de tool openclaw. Voor Codex schakelt OpenClaw voor die uitvoering ook omgevingen, native uitvoering, multi-agent, doelen, apps/plugins, Skills/MCP, zoeken op het web en request_user_input-oppervlakken uit. Codex injecteert nog steeds zijn inerte native hulpprogramma update_plan; dit kan de tijdelijke checklist van het model bijwerken, maar kan geen bestanden of OpenClaw-configuratie schrijven. CLI-harnassen gebruiken de toegestane-toolslijst van OpenClaw niet, dus OpenClaw staat alleen backends toe waarvan het eigen contract voor toolselectie dezelfde beperking kan bewijzen:

• Selecteerbare backends, waaronder Claude Code, starten met een lege selectie van native tools en één MCP-tool, openclaw. De gegenereerde MCP-configuratie van Claude wordt toegepast met --strict-mcp-config, zodat geen andere MCP-servers worden geladen.
• Backends die geen native tools declareren, krijgen dezelfde afzonderlijke OpenClaw- MCP-server.
• Backends met altijd actieve of onbekende native tools worden vóór inferentie veilig geweigerd; ze kunnen geen OpenClaw-sessie hosten.

Alleen OpenClaw-sessies krijgen de openclaw-MCP-server; normale agentuitvoeringen zien deze tool nooit. Selecteerbare CLI-backends zonder native tools en modellen met API-sleutels dwingen daarom de letterlijke lus met één tool af. Codex-appservermodellen dwingen één OpenClaw-bevoegdheidstool plus het inerte native planningshulpprogramma af. In alle drie gevallen blijven schrijfbewerkingen tijdens de installatie beperkt tot het gecontroleerde goedkeuringscontract van OpenClaw.

Gemini CLI blijft beschikbaar voor normale agents, maar kan de toolvrije probe die de inferentiegate vereist niet afdwingen en kan daarom OpenClaw niet hosten.

Overschakelen naar een agent

Gebruik een selector in natuurlijke taal om OpenClaw te verlaten en de normale TUI te openen:

praat met agentpraat met werkagentschakel over naar hoofdagent

openclaw tui, openclaw chat en openclaw terminal openen de normale agent-TUI rechtstreeks; ze starten OpenClaw niet. Nadat je naar de normale TUI bent overgeschakeld, keer je met /openclaw terug naar OpenClaw, eventueel met een vervolgverzoek:

/openclaw/openclaw restart gateway

Berichtreddingsmodus

De berichtreddingsmodus is het toegangspunt voor OpenClaw via berichtkanalen: gebruik deze wanneer je normale agent niet meer werkt, maar een vertrouwd kanaal (bijvoorbeeld WhatsApp) nog steeds opdrachten ontvangt.

Dit is een deterministische noodhandler voor opdrachten, niet de conversationele OpenClaw-agent. Deze initialiseert geen nieuwe installatie en versoepelt de inferentiegate voor OpenClaw-chat niet.

Ondersteunde opdracht: /openclaw <request>. Redding accepteert uitsluitend de exact getypte opdrachtsyntaxis — natuurlijke taal wordt met een aanwijzing afgewezen, nooit als een bewerking geïnterpreteerd, en er wordt nooit een model geraadpleegd.

Jij, in een vertrouwd privébericht van de eigenaar: /openclaw statusOpenClaw: OpenClaw-reddingsmodus. Gateway bereikbaar: nee. Configuratie geldig: nee.Jij: /openclaw restart gatewayOpenClaw: Plan: de Gateway opnieuw starten. Antwoord /openclaw yes om toe te passen.Jij: /openclaw yesOpenClaw: Toegepast. Auditvermelding geschreven.

Het maken van een agent kan ook lokaal of via redding in de wachtrij worden geplaatst:

create agent work workspace ~/Projects/work model openai/gpt-5.6-sol/openclaw create agent work workspace ~/Projects/work

Bij het maken van een agent mag alleen het huidige live geverifieerde standaardmodel worden genoemd. Laat het model weg om die route over te nemen.

Redding op afstand is een beheerdersoppervlak en moet worden behandeld als configuratieherstel op afstand, niet als normale chat.

Beveiligingscontract voor redding op afstand:

• Uitgeschakeld wanneer sandboxing actief is voor de agent/sessie; OpenClaw weigert redding op afstand en verwijst naar lokaal herstel via de CLI.
• De standaard effectieve status is auto: sta redding op afstand alleen toe bij vertrouwde YOLO-uitvoering, waarbij de runtime al lokale bevoegdheid zonder sandbox heeft (tools.exec.security wordt omgezet in full en tools.exec.ask wordt omgezet in off, met sandboxmodus off).
• Vereist een expliciete eigenaarsidentiteit; geen jokerregels voor afzenders, open groepsbeleid, niet-geverifieerde webhooks of anonieme kanalen.
• Standaard alleen privéberichten van de eigenaar; redding via groepen/kanalen vereist expliciete inschakeling.
• Plugin zoeken en weergeven zijn alleen-lezen. Plugininstallatie is altijd uitsluitend lokaal (geblokkeerd in de reddingsmodus, zelfs wanneer deze anders is ingeschakeld), omdat hiermee uitvoerbare code wordt gedownload. Het verwijderen van een Plugin wordt zowel in lokale OpenClaw als in de reddingsmodus geweigerd; voer openclaw plugins uninstall <id> uit vanuit een terminal.
• Redding op afstand kan de lokale TUI niet openen of overschakelen naar een interactieve agentsessie; gebruik lokaal openclaw voor overdracht aan een agent.
• Permanente schrijfbewerkingen vereisen nog steeds goedkeuring, ook in de reddingsmodus.
• Openstaande goedkeuringen zijn eenmalig. Elke nieuwere reddingsopdracht voor hetzelfde account, kanaal en dezelfde afzender trekt het oudere plan in; een mislukte uitvoering verbruikt de goedkeuring ook, dus verzend de opdracht opnieuw om het opnieuw te proberen.
• Elke toegepaste reddingsbewerking wordt gecontroleerd. Redding via berichtkanalen registreert metadata over kanaal, account, afzender en bronadres; bewerkingen die de configuratie wijzigen, registreren ook configuratiehashes van vóór en na de wijziging.
• Geheimen worden nooit weergegeven. SecretRef-inspectie rapporteert beschikbaarheid, niet de waarden.
• Als de Gateway actief is, geeft redding de voorkeur aan getypeerde Gateway-bewerkingen; als deze niet actief is, gebruikt redding alleen het minimale lokale hersteloppervlak dat niet afhankelijk is van de normale agentlus.

Configuratiestructuur:

{  "systemAgent": {    "rescue": {      "enabled": "auto",      "ownerDmOnly": true,      "pendingTtlMinutes": 15,    },  },}

• enabled: "auto" (standaard) staat redding alleen toe wanneer de effectieve runtime YOLO is en sandboxing uitstaat; false staat redding via berichtkanalen nooit toe; true staat redding expliciet toe wanneer de controles van eigenaar/kanaal slagen (nog steeds onderworpen aan de weigering wegens sandboxing).
• ownerDmOnly: beperk redding tot rechtstreekse privéberichten van de eigenaar. Standaard true.
• pendingTtlMinutes: hoelang een openstaande schrijfbewerking voor redding beschikbaar blijft voor goedkeuring via /openclaw yes voordat deze verloopt. Standaard 15.

openclaw doctor --fix migreert het verouderde configuratieblok crestodian naar systemAgent. De runtime leest alleen het canonieke blok.

Redding op afstand wordt gedekt door de Docker-lane:

pnpm test:docker:system-agent-rescue

Een optionele live smoke-test van het opdrachtoppervlak van het kanaal controleert /openclaw status plus een permanente goedkeuringsrondgang via de reddingshandler:

pnpm test:live:system-agent-rescue-channel

Door inferentie begrensde verpakte eenmalige installatie wordt gedekt door:

pnpm test:docker:system-agent-first-run

Die lane voor de verpakte CLI begint met een lege statusmap en bewijst dat OpenClaw zonder inferentie veilig weigert. Vervolgens test en activeert deze een nagebootste Claude via de verpakte activeringsmodule. Pas daarna bereikt een vaag verzoek de planner en wordt het omgezet in een getypeerde installatie, gevolgd door eenmalige opdrachten die een extra agent maken, Discord configureren via het inschakelen van een Plugin plus een SecretRef voor het token, de configuratie valideren en het auditlogboek controleren. Deze lane levert ondersteunend bewijs voor de gate/bewerkingen; deze test geen interactieve onboarding of het gesprek tussen de OpenClaw-agent, tools en goedkeuringen. Het onderstaande QA Lab-scenario verwijst naar dezelfde Docker-lane:

pnpm openclaw qa suite --scenario system-agent-ring-zero-setup

Gerelateerd

• CLI-referentie
• Doctor
• TUI
• Sandbox
• Beveiliging