Vai al contenuto principale

Documentation Index

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

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

​
openclaw crestodian

Crestodian è l’assistente locale di OpenClaw per configurazione iniziale, riparazione e configurazione. È progettato per restare raggiungibile quando il normale percorso dell’agente è interrotto. Eseguire openclaw senza comandi avvia Crestodian in un terminale interattivo. Eseguire openclaw crestodian avvia esplicitamente lo stesso assistente.

​
Cosa mostra Crestodian

All’avvio, Crestodian interattivo apre la stessa shell TUI usata da openclaw tui, con un backend di chat Crestodian. Il registro della chat inizia con un breve saluto:
  • quando avviare Crestodian
  • il modello o il percorso del pianificatore deterministico che Crestodian sta effettivamente usando
  • validità della configurazione e agente predefinito
  • raggiungibilità del Gateway dal primo probe di avvio
  • la prossima azione di debug che Crestodian può eseguire
Non mostra segreti né carica comandi CLI dei plugin solo per avviarsi. La TUI fornisce comunque intestazione, registro chat, riga di stato, piè di pagina, completamento automatico e controlli dell’editor normali. Usa status per l’inventario dettagliato con percorso della configurazione, percorsi docs/sorgenti, probe CLI locali, presenza di chiavi API, agenti, modello e dettagli del Gateway. Crestodian usa la stessa scoperta dei riferimenti di OpenClaw degli agenti normali. In un checkout Git, punta ai docs/ locali e all’albero sorgente locale. In un’installazione del pacchetto npm, usa la documentazione inclusa nel pacchetto e rimanda a https://github.com/openclaw/openclaw, con indicazioni esplicite a rivedere il sorgente quando la documentazione non basta.

​
Esempi

openclaw
openclaw crestodian
openclaw crestodian --json
openclaw crestodian --message "models"
openclaw crestodian --message "validate config"
openclaw crestodian --message "setup workspace ~/Projects/work model openai/gpt-5.5" --yes
openclaw crestodian --message "set default model openai/gpt-5.5" --yes
openclaw onboard --modern
Dentro la TUI di Crestodian: 
status
health
doctor
doctor fix
validate config
setup
setup workspace ~/Projects/work model openai/gpt-5.5
config set gateway.port 19001
config set-ref gateway.auth.token env OPENCLAW_GATEWAY_TOKEN
gateway status
restart gateway
agents
create agent work workspace ~/Projects/work
models
set default model openai/gpt-5.5
plugins list
plugins search slack
plugin install clawhub:openclaw-codex-app-server
plugin uninstall openclaw-codex-app-server
talk to work agent
talk to agent for ~/Projects/work
audit
quit

​
Avvio sicuro

Il percorso di avvio di Crestodian è volutamente ridotto. Può funzionare quando:
  • openclaw.json manca
  • openclaw.json non è valido
  • il Gateway non è attivo
  • la registrazione dei comandi dei plugin non è disponibile
  • non è stato ancora configurato alcun agente
openclaw --help e openclaw --version usano ancora i normali percorsi rapidi. openclaw non interattivo esce con un breve messaggio invece di stampare l’aiuto root, perché il prodotto senza comandi è Crestodian.

​
Operazioni e approvazione

Crestodian usa operazioni tipizzate invece di modificare la configurazione in modo ad hoc. Le operazioni in sola lettura possono essere eseguite immediatamente:
  • mostrare la panoramica
  • elencare gli agenti
  • elencare i plugin installati
  • cercare plugin ClawHub
  • mostrare lo stato di modello/backend
  • eseguire controlli di stato o salute
  • controllare la raggiungibilità del Gateway
  • eseguire doctor senza correzioni interattive
  • validare la configurazione
  • mostrare il percorso del registro di audit
Le operazioni persistenti richiedono approvazione conversazionale in modalità interattiva, a meno che tu non passi --yes per un comando diretto:
  • scrivere la configurazione
  • eseguire config set
  • impostare valori SecretRef supportati tramite config set-ref
  • eseguire il bootstrap di setup/onboarding
  • cambiare il modello predefinito
  • avviare, arrestare o riavviare il Gateway
  • creare agenti
  • installare plugin da ClawHub o npm
  • disinstallare plugin
  • eseguire riparazioni doctor che riscrivono configurazione o stato
Le scritture applicate sono registrate in: 
~/.openclaw/audit/crestodian.jsonl
La scoperta non viene sottoposta ad audit. Vengono registrate solo le operazioni applicate e le scritture. openclaw onboard --modern avvia Crestodian come anteprima dell’onboarding moderno. openclaw onboard semplice esegue ancora l’onboarding classico.

​
Bootstrap di setup

setup è il bootstrap di onboarding incentrato sulla chat. Scrive solo tramite operazioni di configurazione tipizzate e chiede prima l’approvazione. 
setup
setup workspace ~/Projects/work
setup workspace ~/Projects/work model openai/gpt-5.5
Quando non è configurato alcun modello, setup seleziona il primo backend utilizzabile in questo ordine e ti dice cosa ha scelto:
  • modello esplicito esistente, se già configurato
  • OPENAI_API_KEY -> openai/gpt-5.5
  • ANTHROPIC_API_KEY -> anthropic/claude-opus-4-7
  • Claude Code CLI -> claude-cli/claude-opus-4-7
  • Codex CLI -> codex-cli/gpt-5.5
Se nessuno è disponibile, setup scrive comunque il workspace predefinito e lascia il modello non impostato. Installa o accedi a Codex/Claude Code, oppure esponi OPENAI_API_KEY/ANTHROPIC_API_KEY, quindi esegui di nuovo setup.

​
Pianificatore assistito da modello

Crestodian si avvia sempre in modalità deterministica. Per comandi approssimativi che il parser deterministico non capisce, Crestodian locale può effettuare un singolo turno limitato del pianificatore tramite i normali percorsi runtime di OpenClaw. Usa prima il modello OpenClaw configurato. Se nessun modello configurato è ancora utilizzabile, può ripiegare su runtime locali già presenti sulla macchina:
  • Claude Code CLI: claude-cli/claude-opus-4-7
  • harness app-server Codex: openai/gpt-5.5
  • Codex CLI: codex-cli/gpt-5.5
Il pianificatore assistito da modello non può modificare direttamente la configurazione. Deve tradurre la richiesta in uno dei comandi tipizzati di Crestodian, poi si applicano le normali regole di approvazione e audit. Crestodian stampa il modello usato e il comando interpretato prima di eseguire qualsiasi cosa. I turni del pianificatore di fallback senza configurazione sono temporanei, con strumenti disabilitati dove il runtime lo supporta, e usano un workspace/sessione temporanei. La modalità di soccorso del canale messaggi non usa il pianificatore assistito da modello. Il soccorso remoto resta deterministico, così un percorso normale dell’agente interrotto o compromesso non può essere usato come editor della configurazione.

​
Passare a un agente

Usa un selettore in linguaggio naturale per lasciare Crestodian e aprire la TUI normale: 
talk to agent
talk to work agent
switch to main agent
openclaw tui, openclaw chat e openclaw terminal aprono ancora direttamente la TUI normale dell’agente. Non avviano Crestodian. Dopo il passaggio alla TUI normale, usa /crestodian per tornare a Crestodian. Puoi includere una richiesta successiva: 
/crestodian
/crestodian restart gateway
I cambi di agente dentro la TUI lasciano un’indicazione che /crestodian è disponibile.

​
Modalità di soccorso messaggi

La modalità di soccorso messaggi è l’entrypoint del canale messaggi per Crestodian. Serve per il caso in cui il tuo agente normale è inattivo, ma un canale attendibile come WhatsApp riceve ancora comandi. Comando di testo supportato:
  • /crestodian <request>
Flusso operatore: 
You, in a trusted owner DM: /crestodian status
OpenClaw: Crestodian rescue mode. Gateway reachable: no. Config valid: no.
You: /crestodian restart gateway
OpenClaw: Plan: restart the Gateway. Reply /crestodian yes to apply.
You: /crestodian yes
OpenClaw: Applied. Audit entry written.
La creazione di agenti può anche essere accodata dal prompt locale o dalla modalità di soccorso: 
create agent work workspace ~/Projects/work model openai/gpt-5.5
/crestodian create agent work workspace ~/Projects/work
La modalità di soccorso remoto è una superficie amministrativa. Deve essere trattata come riparazione remota della configurazione, non come chat normale. Contratto di sicurezza per il soccorso remoto:
  • Disabilitato quando il sandboxing è attivo. Se un agente/sessione è in sandbox, Crestodian deve rifiutare il soccorso remoto e spiegare che è richiesta una riparazione CLI locale.
  • Lo stato effettivo predefinito è auto: consentire il soccorso remoto solo in operazione YOLO attendibile, dove il runtime ha già autorità locale senza sandbox.
  • Richiedere un’identità proprietario esplicita. Il soccorso non deve accettare regole mittente wildcard, policy di gruppo aperte, webhook non autenticati o canali anonimi.
  • Solo DM del proprietario per impostazione predefinita. Il soccorso in gruppo/canale richiede opt-in esplicito.
  • Ricerca ed elenco dei plugin sono in sola lettura. L’installazione dei plugin è solo locale per impostazione predefinita perché scarica codice eseguibile. La disinstallazione dei plugin può essere consentita come operazione di riparazione approvata quando la policy di soccorso permette scritture persistenti.
  • Il soccorso remoto non può aprire la TUI locale né passare a una sessione agente interattiva. Usa openclaw locale per il passaggio all’agente.
  • Le scritture persistenti richiedono comunque approvazione, anche in modalità di soccorso.
  • Sottoporre ad audit ogni operazione di soccorso applicata. Il soccorso tramite canale messaggi registra metadati di canale, account, mittente e indirizzo sorgente. Le operazioni che modificano la configurazione registrano anche gli hash della configurazione prima e dopo.
  • Non ripetere mai segreti. L’ispezione SecretRef deve riportare la disponibilità, non i valori.
  • Se il Gateway è attivo, preferire operazioni tipizzate del Gateway. Se il Gateway è inattivo, usare solo la superficie minima di riparazione locale che non dipende dal normale loop dell’agente.
Forma della configurazione: 
{
  "crestodian": {
    "rescue": {
      "enabled": "auto",
      "ownerDmOnly": true,
    },
  },
}
enabled deve accettare:
  • "auto": predefinito. Consenti solo quando il runtime effettivo è YOLO e il sandboxing è disattivato.
  • false: non consentire mai il soccorso tramite canale messaggi.
  • true: consenti esplicitamente il soccorso quando i controlli proprietario/canale passano. Questo non deve comunque aggirare il rifiuto del sandboxing.
La postura YOLO "auto" predefinita è:
  • la modalità sandbox si risolve in off
  • tools.exec.security si risolve in full
  • tools.exec.ask si risolve in off
Il soccorso remoto è coperto dalla lane Docker: 
pnpm test:docker:crestodian-rescue
Il fallback del pianificatore locale senza configurazione è coperto da: 
pnpm test:docker:crestodian-planner
Uno smoke opt-in della superficie comandi del canale live controlla /crestodian status più un roundtrip di approvazione persistente tramite l’handler di soccorso: 
pnpm test:live:crestodian-rescue-channel
Il setup nuovo senza configurazione tramite Crestodian è coperto da: 
pnpm test:docker:crestodian-first-run
Quella lane parte con una directory di stato vuota, instrada openclaw nudo a Crestodian, imposta il modello predefinito, crea un agente aggiuntivo, configura Discord tramite l’abilitazione di un plugin più un SecretRef del token, valida la configurazione e controlla il registro di audit. QA Lab ha anche uno scenario basato su repo per lo stesso flusso Ring 0: 
pnpm openclaw qa suite --scenario crestodian-ring-zero-setup

​
Correlati