openclaw crestodian

Conversational Crestodian is de lokale agent van OpenClaw voor installatie, reparatie en configuratie. 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-traject volgen.

Wanneer deze start

Wanneer openclaw zonder subopdracht wordt uitgevoerd, wordt de route bepaald op basis van de configuratiestatus:

• Configuratie ontbreekt of bestaat zonder door de gebruiker opgegeven instellingen (leeg of met alleen de sleutels $schema/meta): start begeleide onboarding met live AI-verificatie.
• Configuratie bestaat maar slaagt niet voor validatie: start klassieke onboarding, die de problemen meldt en u 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 gebruikersinterface zonder onboarding of Crestodian. Gebruik later /crestodian in de TUI of voer rechtstreeks openclaw crestodian uit om Crestodian te openen.

openclaw crestodian test eerst live het geconfigureerde standaardmodel. Na een geslaagde beurt start Crestodian. Bij een interactieve fout wordt de begeleide inferentieconfiguratie geopend en wordt na het slagen van een kandidaat overgeschakeld naar Crestodian. 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) sluit af met een kort bericht in plaats van de hoofdhulp weer te geven: 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 Crestodian, maar gebruikt dezelfde inferentiecontrole: werkende inferentie opent de chat, interactieve fouten starten begeleide inferentieconfiguratie en niet-interactieve fouten sluiten af met onboardinginstructies. openclaw onboard --classic opent de volledige stapsgewijze wizard.

Wat Crestodian toont

Interactieve Crestodian opent dezelfde TUI-shell als openclaw tui, met een Crestodian-chatbackend. De begroeting bij het opstarten behandelt:

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

Er worden geen geheimen gedumpt en er worden niet alleen voor het opstarten 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-gegevens.

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

Voorbeelden

openclawopenclaw crestodianopenclaw crestodian --jsonopenclaw crestodian --message "models"openclaw crestodian --message "validate config"openclaw crestodian --message "setup workspace ~/Projects/work" --yesopenclaw crestodian --message "set default model openai/gpt-5.6" --yesopenclaw onboard --modern

In de Crestodian-TUI:

statushealthdoctorvalidate configsetupsetup workspace ~/Projects/workconfig set gateway.port 19001config set-ref gateway.auth.token env OPENCLAW_GATEWAY_TOKENgateway statusrestart gatewayagentscreate agent work workspace ~/Projects/workmodelsconfigure model providerset default model openai/gpt-5.6channelschannel info slackconnect slackopen channel wizard for slackplugins listplugins search slackplugin install clawhub:openclaw-codex-app-servertalk to work agenttalk to agent for ~/Projects/workauditquit

Bewerkingen en goedkeuring

Crestodian 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-/statuscontroles uitvoeren, bereikbaarheid van de Gateway controleren, doctor zonder interactieve reparaties uitvoeren, configuratie valideren en het pad naar het auditlogboek tonen.

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

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

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

Nieuwe agents nemen de live geverifieerde standaardinferentieroute over. De agent-id crestodian is gereserveerd voor de bevoorrechte virtuele beheerder en kan niet als normale agent worden gemaakt.

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/-hulpmiddelen of tools.* in de hoofdstructuur. Onbewerkte schrijfbewerkingen onder env.*, secrets.*, plugins.* en $include worden ook geweigerd, omdat ze de verwerking van referenties of de activering van providers kunnen vervangen. Gateway- en kanaalauthenticatie blijven normale configuratieonderdelen. Gebruik getypeerde plugin-/kanaalworkflows en set default model <provider/model> voor een reeds geconfigureerde route; de route wordt live getest voordat deze wordt opgeslagen. Sluit Crestodian af en voer openclaw onboard uit om provider-/authenticatietoegang te configureren of te repareren.

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

U geeft goedkeuring in uw eigen woorden: ondubbelzinnige antwoorden ("ja", "zeker", "ga door", "nu niet") worden verwerkt aan de hand van een gesloten, deterministische lijst. Wanneer de geconfigureerde route een afzonderlijke voltooiingsaanroep ondersteunt, kunnen andere antwoorden uitsluitend op basis van uw 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 het gesprek vraagt het opnieuw.

Toegepaste schrijfbewerkingen worden vastgelegd in ~/.openclaw/audit/crestodian.jsonl. Detectie wordt niet gecontroleerd; alleen toegepaste bewerkingen en schrijfbewerkingen worden geregistreerd.

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

Overschakelen naar afgeschermde kanaalconfiguratie

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

open channel wizard for slackchannel info slack

open channel wizard for <channel> opent de 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 koppeling naar de documentatie.

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

Installatie-initialisatie

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

setupsetup workspace ~/Projects/work

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

Als inferentie ontbreekt of de live controle ervan mislukt, verlaat u Crestodian en voert u 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. Crestodian start onmiddellijk na die grens en kan vervolgens de werkruimte, Gateway, kanalen, agents, plugins en andere optionele functies configureren.

De macOS-app slaat dit traject volledig over wanneer deze een geconfigureerde Gateway bereikt waarvan de standaardagent al een geconfigureerd model heeft; de normale agentgebruikersinterface wordt geopend. Voor een nieuwe of onvolledige Gateway doorloopt de app het inferentietraject via de Gateway-methoden crestodian.setup.detect en crestodian.setup.activate: detectie geeft elke gevonden kandidaat-backend weer, activering test één kandidaat live (een echte voltooiing met "reply with OK") en slaat pas nadat de test is geslaagd het model, de referentie en de provider-/runtimestatus op die voor die route nodig zijn. De standaardwaarden voor werkruimte en Gateway blijven bestemd voor Crestodian. Een niet-geslaagde kandidaat wijzigt de configuratie nooit; de app doorloopt automatisch de rest van het traject en biedt uiteindelijk een handmatige sleutel-/tokenstap aan, ingevuld op basis van de actieve plugins voor tekstinferentieproviders van de Gateway. De geselecteerde provider beheert het eigen startmodel en de eigen configuratie, en de referentie wordt op dezelfde manier geverifieerd voordat deze wordt opgeslagen.

Codex-supervisie en andere optionele pluginfuncties vallen buiten deze transactie voor inferentieactivering. Configureer ze pas nadat inferentie werkt en Crestodian is gestart; bestaand pluginbeleid en expliciete uitschakelingen van supervisie blijven tijdens de inferentieconfiguratie ongewijzigd.

AI-gesprek

Het vrije gesprek van interactieve Crestodian verloopt via dezelfde agentlus als gewone OpenClaw-agents, beperkt tot één OpenClaw-bevoegdheidshulpmiddel op ring nul, crestodian, dat de getypeerde bewerkingen omvat. Leesacties worden vrij uitgevoerd, mutaties vereisen uw goedkeuring in het gesprek voor precies die bewerking (zie Bewerkingen en goedkeuring) en elke toegepaste schrijfbewerking wordt geregistreerd en opnieuw gevalideerd. De agentsessie blijft bestaan, waardoor Crestodian echt geheugen over meerdere beurten heeft. Als de geverifieerde inferentieroute later niet meer werkt, keert u terug naar openclaw onboard en repareert u deze voordat u verdergaat.

De host ontleedt verzoeken in natuurlijke taal niet tot 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 het hulpmiddel crestodian aan een getypeerde bewerking kan koppelen.

Wanneer een mutatie openstaat, worden alleen ondubbelzinnige goedkeurings- of afwijzingszinnen uit een gesloten lijst zonder inferentie verwerkt. Dubbelzinnige toestemming gaat naar een afzonderlijke geconfigureerde voltooiingsaanroep en wordt anders veilig geweigerd. Gestructureerde wizardvelden en exacte hostnavigatie zijn bedieningselementen van de gebruikersinterface, geen verwerking van bewerkingen in natuurlijke taal. Eén uitzondering voor geheimhygiëne 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 reddingsmodus voor berichtkanalen gebruikt nooit de modelondersteunde planner. Redding op afstand blijft deterministisch, zodat een defect of gecompromitteerd normaal agentpad niet als configuratie-editor kan worden gebruikt.

Vertrouwensmodel voor de CLI-harnas

Ingebedde runtimes en de Codex-app-serverharnas dwingen de beperking tot ring nul rechtstreeks af: de uitvoering bevat een OpenClaw-toelatingslijst voor hulpmiddelen met alleen het hulpmiddel crestodian. Voor Codex schakelt OpenClaw ook omgevingen, native uitvoering, meerdere agents, doel-, app-/plugin-, skill-/MCP-, webzoek- en request_user_input-onderdelen uit voor die uitvoering. Codex injecteert nog steeds het inerte, ingebouwde hulpprogramma update_plan; dit kan de tijdelijke controlelijst van het model bijwerken, maar geen bestanden of OpenClaw-configuratie schrijven. CLI-harnassen gebruiken de toelatingslijst van OpenClaw niet, dus Crestodian staat alleen backends toe waarvan het eigen contract voor hulpmiddelselectie dezelfde beperking kan aantonen:

• Selecteerbare backends, waaronder Claude Code, worden gestart met een lege selectie van systeemeigen tools en één MCP-tool, crestodian. De gegenereerde MCP-configuratie van Claude wordt toegepast met --strict-mcp-config, zodat geen andere MCP-servers worden geladen.
• Backends die geen systeemeigen tools declareren, krijgen dezelfde speciale Crestodian MCP-server.
• Altijd actieve of onbekende backends met systeemeigen tools worden vóór inferentie gesloten bij fouten; ze kunnen geen Crestodian-sessie hosten.

Alleen Crestodian-sessies krijgen de crestodian MCP-server; normale agentuitvoeringen zien deze tool nooit. Selecteerbare CLI-backends zonder systeemeigen tools en modellen met API-sleutels dwingen daarom de letterlijke lus met één tool af. Codex-app-servermodellen dwingen één OpenClaw-bevoegdheidstool af, plus het inactieve systeemeigen planningshulpmiddel. In alle drie de gevallen blijven schrijfbewerkingen tijdens de installatie beperkt tot het gecontroleerde goedkeuringscontract van Crestodian.

Gemini CLI blijft beschikbaar voor normale agents, maar kan de toolvrije controle die de inferentiepoort vereist niet afdwingen en kan daarom geen Crestodian hosten.

Overschakelen naar een agent

Gebruik een selector in natuurlijke taal om Crestodian 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 Crestodian niet. Nadat u naar de normale TUI bent overgeschakeld, keert /crestodian terug naar Crestodian, eventueel met een vervolgverzoek:

/crestodian/crestodian herstart gateway

Berichtherstelmodus

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

Dit is een deterministische noodopdrachtafhandelaar, niet de conversationele Crestodian-agent. Deze initialiseert geen nieuwe installatie en versoepelt de inferentiepoort voor Crestodian-chat niet.

Ondersteunde opdracht: /crestodian <verzoek>. Herstel accepteert uitsluitend de exact getypte opdrachtsyntaxis — natuurlijke taal wordt afgewezen met een aanwijzing, nooit geraden als een bewerking, en er wordt nooit een model geraadpleegd.

U, in een vertrouwd privébericht van de eigenaar: /crestodian statusOpenClaw: Crestodian-herstelmodus. Gateway bereikbaar: nee. Configuratie geldig: nee.U: /crestodian herstart gatewayOpenClaw: Plan: herstart de Gateway. Antwoord /crestodian yes om toe te passen.U: /crestodian yesOpenClaw: Toegepast. Auditvermelding geschreven.

Het maken van agents kan ook lokaal of via herstel in de wachtrij worden geplaatst:

create agent work workspace ~/Projects/work model openai/gpt-5.6-sol/crestodian 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.

Extern herstel is een beheerdersoppervlak en moet worden behandeld als externe configuratiereparatie, niet als normale chat.

Beveiligingscontract voor extern herstel:

• Uitgeschakeld wanneer sandboxing actief is voor de agent/sessie; Crestodian weigert extern herstel en verwijst naar lokale reparatie via de CLI.
• De standaard effectieve status is auto: extern herstel alleen toestaan bij vertrouwde YOLO-werking, waarbij de runtime al lokale bevoegdheid zonder sandbox heeft (tools.exec.security wordt omgezet naar full en tools.exec.ask naar 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; herstel via groepen/kanalen vereist expliciete aanmelding.
• Het zoeken en weergeven van Plugins is alleen-lezen. Plugin-installatie is altijd uitsluitend lokaal (geblokkeerd tijdens herstel, zelfs wanneer deze anders is ingeschakeld), omdat daarbij uitvoerbare code wordt gedownload. Het verwijderen van Plugins wordt zowel in lokale Crestodian als tijdens herstel geweigerd; voer openclaw plugins uninstall <id> uit vanuit een terminal.
• Extern herstel kan de lokale TUI niet openen of overschakelen naar een interactieve agentsessie; gebruik lokaal openclaw voor de overdracht aan een agent.
• Permanente schrijfbewerkingen vereisen nog steeds goedkeuring, ook in de herstelmodus.
• Elke toegepaste herstelbewerking wordt gecontroleerd. Herstel via berichtkanalen registreert metagegevens van kanaal, account, afzender en bronadres; configuratiewijzigende bewerkingen registreren ook configuratiehashes van vóór en na de wijziging.
• Geheimen worden nooit weergegeven. Inspectie van SecretRef rapporteert beschikbaarheid, niet de waarden.
• Als de Gateway actief is, geeft herstel de voorkeur aan getypeerde Gateway-bewerkingen; als deze niet actief is, gebruikt herstel alleen het minimale lokale reparatieoppervlak dat niet afhankelijk is van de normale agentlus.

Configuratiestructuur:

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

• enabled: "auto" (standaard) staat herstel alleen toe wanneer de effectieve runtime YOLO is en sandboxing is uitgeschakeld; false staat herstel via berichtkanalen nooit toe; true staat herstel expliciet toe wanneer de controles van eigenaar en kanaal slagen (nog steeds onderhevig aan de weigering wegens sandboxing).
• ownerDmOnly: beperkt herstel tot directe berichten van de eigenaar. Standaard true.
• pendingTtlMinutes: hoe lang een wachtende herstelschrijfbewerking openblijft voor goedkeuring met /crestodian yes voordat deze verloopt. Standaard 15.

Extern herstel wordt gedekt door de Docker-lane:

pnpm test:docker:crestodian-rescue

Een optionele live-rooktest van het opdrachtoppervlak van het kanaal controleert /crestodian status plus een volledige permanente goedkeuringscyclus via de herstelafhandelaar:

pnpm test:live:crestodian-rescue-channel

Een verpakte eenmalige installatie met inferentiepoort wordt gedekt door:

pnpm test:docker:crestodian-first-run

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

pnpm openclaw qa suite --scenario crestodian-ring-zero-setup

Gerelateerd

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