> ## 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.

# Crestodian

# `openclaw crestodian`

Crestodian est l’assistant local de configuration, de réparation et de paramétrage d’OpenClaw. Il est
conçu pour rester accessible lorsque le chemin d’agent normal est rompu.

Exécuter `openclaw` sans commande lance d’abord l’onboarding classique lorsque le
fichier de configuration actif est absent ou ne contient aucun paramètre rédigé (vide ou
uniquement des métadonnées). Après qu’un fichier de configuration contient des paramètres rédigés, exécuter `openclaw`
sans commande lance Crestodian dans un terminal interactif. Exécuter
`openclaw crestodian` lance explicitement le même assistant.

## Ce qu’affiche Crestodian

Au démarrage, Crestodian interactif ouvre le même shell TUI que celui utilisé par
`openclaw tui`, avec un backend de chat Crestodian. Le journal de chat commence par une courte
salutation :

* quand lancer Crestodian
* le modèle ou le chemin de planificateur déterministe réellement utilisé par Crestodian
* la validité de la configuration et l’agent par défaut
* l’accessibilité du Gateway depuis la première sonde de démarrage
* la prochaine action de débogage que Crestodian peut effectuer

Il ne vide pas les secrets et ne charge pas les commandes CLI de plugin uniquement pour démarrer. Le TUI
fournit toujours l’en-tête normal, le journal de chat, la ligne d’état, le pied de page, l’autocomplétion
et les contrôles de l’éditeur.

Utilisez `status` pour l’inventaire détaillé avec le chemin de configuration, les chemins docs/source,
les sondes CLI locales, la présence de clés API, les agents, le modèle et les détails du Gateway.

Crestodian utilise la même découverte de références OpenClaw que les agents classiques. Dans un checkout Git,
il pointe vers les `docs/` locales et l’arborescence source locale. Dans une installation de package npm, il
utilise la documentation embarquée du package et crée un lien vers
[https://github.com/openclaw/openclaw](https://github.com/openclaw/openclaw), avec des consignes explicites
de consulter le source lorsque la documentation ne suffit pas.

## Exemples

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```

Dans le TUI Crestodian :

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```

## Démarrage sûr

Le chemin de démarrage de Crestodian est volontairement réduit. Il peut s’exécuter lorsque :

* `openclaw.json` est absent
* `openclaw.json` est invalide
* le Gateway est arrêté
* l’enregistrement des commandes de plugin est indisponible
* aucun agent n’a encore été configuré

`openclaw --help` et `openclaw --version` utilisent toujours les chemins rapides normaux.
`openclaw` nu en mode non interactif quitte avec un court message au lieu d’imprimer
l’aide racine. Sur une nouvelle installation, le message pointe vers l’onboarding non interactif ;
après la configuration, il pointe vers les commandes ponctuelles Crestodian.

## Opérations et approbation

Crestodian utilise des opérations typées au lieu de modifier la configuration de manière ad hoc.

Les opérations en lecture seule peuvent s’exécuter immédiatement :

* afficher la vue d’ensemble
* lister les agents
* lister les plugins installés
* rechercher des plugins ClawHub
* afficher l’état du modèle/backend
* exécuter les vérifications d’état ou de santé
* vérifier l’accessibilité du Gateway
* exécuter doctor sans corrections interactives
* valider la configuration
* afficher le chemin du journal d’audit

Les opérations persistantes nécessitent une approbation conversationnelle en mode interactif, sauf si
vous passez `--yes` pour une commande directe :

* écrire la configuration
* exécuter `config set`
* définir les valeurs SecretRef prises en charge via `config set-ref`
* exécuter le bootstrap de configuration/onboarding
* changer le modèle par défaut
* démarrer, arrêter ou redémarrer le Gateway
* créer des agents
* installer des plugins depuis ClawHub ou npm
* désinstaller des plugins
* exécuter des réparations doctor qui réécrivent la configuration ou l’état

Les écritures appliquées sont enregistrées dans :

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
~/.openclaw/audit/crestodian.jsonl
```

La découverte n’est pas auditée. Seules les opérations appliquées et les écritures sont journalisées.

`openclaw onboard --modern` lance Crestodian comme aperçu de l’onboarding moderne.
`openclaw onboard` simple exécute toujours l’onboarding classique.

## Bootstrap de configuration

`setup` est le bootstrap d’onboarding centré sur le chat. Il écrit uniquement via des
opérations de configuration typées et demande d’abord l’approbation.

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
setup
setup workspace ~/Projects/work
setup workspace ~/Projects/work model openai/gpt-5.5
```

Lorsqu’aucun modèle n’est configuré, setup sélectionne le premier backend utilisable dans cet
ordre et vous indique ce qu’il a choisi :

* modèle explicite existant, s’il est déjà configuré
* `OPENAI_API_KEY` -> `openai/gpt-5.5`
* `ANTHROPIC_API_KEY` -> `anthropic/claude-opus-4-8`
* CLI Claude Code -> `claude-cli/claude-opus-4-8`
* Codex -> `openai/gpt-5.5` via le harness app-server Codex

Si aucun n’est disponible, setup écrit tout de même l’espace de travail par défaut et laisse le
modèle non défini. Installez ou connectez-vous à Codex/Claude Code, ou exposez
`OPENAI_API_KEY`/`ANTHROPIC_API_KEY`, puis relancez setup.

## Planificateur assisté par modèle

Crestodian démarre toujours en mode déterministe. Pour les commandes floues que
l’analyseur déterministe ne comprend pas, Crestodian local peut effectuer un tour de
planificateur borné via les chemins d’exécution normaux d’OpenClaw. Il utilise d’abord le
modèle OpenClaw configuré. Si aucun modèle configuré n’est encore utilisable, il peut se
rabattre sur les runtimes locaux déjà présents sur la machine :

* CLI Claude Code : `claude-cli/claude-opus-4-8`
* harness app-server Codex : `openai/gpt-5.5`

Le planificateur assisté par modèle ne peut pas modifier directement la configuration. Il doit traduire la
requête en l’une des commandes typées de Crestodian, puis les règles normales d’approbation et
d’audit s’appliquent. Crestodian imprime le modèle utilisé et la commande interprétée
avant d’exécuter quoi que ce soit. Les tours de planificateur de repli sans configuration sont
temporaires, sans outil lorsque le runtime le prend en charge, et utilisent un espace de travail/une session
temporaire.

Le mode de secours par canal de messages n’utilise pas le planificateur assisté par modèle. Le secours distant
reste déterministe afin qu’un chemin d’agent normal cassé ou compromis ne puisse pas
être utilisé comme éditeur de configuration.

## Basculer vers un agent

Utilisez un sélecteur en langage naturel pour quitter Crestodian et ouvrir le TUI normal :

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
talk to agent
talk to work agent
switch to main agent
```

`openclaw tui`, `openclaw chat` et `openclaw terminal` ouvrent toujours directement le TUI
d’agent normal. Ils ne lancent pas Crestodian.

Après avoir basculé dans le TUI normal, utilisez `/crestodian` pour revenir à Crestodian.
Vous pouvez inclure une requête de suivi :

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
/crestodian
/crestodian restart gateway
```

Les bascules d’agent dans le TUI laissent un fil d’Ariane indiquant que `/crestodian` est disponible.

## Mode de secours par messages

Le mode de secours par messages est le point d’entrée par canal de messages pour Crestodian. Il est destiné au
cas où votre agent normal est hors service, mais où un canal approuvé comme WhatsApp
reçoit encore les commandes.

Commande texte prise en charge :

* `/crestodian <request>`

Flux opérateur :

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 création d’agent peut aussi être mise en file depuis l’invite locale ou le mode de secours :

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
create agent work workspace ~/Projects/work model openai/gpt-5.5
/crestodian create agent work workspace ~/Projects/work
```

Le mode de secours distant est une surface d’administration. Il doit être traité comme une réparation de configuration
distante, pas comme un chat normal.

Contrat de sécurité pour le secours distant :

* Désactivé lorsque le sandboxing est actif. Si un agent/une session est en sandbox,
  Crestodian doit refuser le secours distant et expliquer qu’une réparation CLI locale est
  requise.
* L’état effectif par défaut est `auto` : autoriser le secours distant uniquement dans une opération YOLO
  approuvée, où le runtime dispose déjà d’une autorité locale non sandboxée.
* Exiger une identité propriétaire explicite. Le secours ne doit pas accepter de règles d’expéditeur
  génériques, de politique de groupe ouverte, de webhooks non authentifiés ni de canaux anonymes.
* DM propriétaires uniquement par défaut. Le secours de groupe/canal nécessite une adhésion explicite.
* La recherche et la liste des plugins sont en lecture seule. L’installation de plugin est locale uniquement par défaut
  parce qu’elle télécharge du code exécutable. La désinstallation de plugin peut être autorisée comme
  opération de réparation approuvée lorsque la politique de secours permet les écritures persistantes.
* Le secours distant ne peut pas ouvrir le TUI local ni basculer vers une session d’agent
  interactive. Utilisez `openclaw` local pour le transfert vers un agent.
* Les écritures persistantes nécessitent toujours une approbation, même en mode de secours.
* Auditer chaque opération de secours appliquée. Le secours par canal de messages enregistre le canal,
  le compte, l’expéditeur et les métadonnées d’adresse source. Les opérations qui modifient la configuration enregistrent aussi
  les hachages de configuration avant et après.
* Ne jamais renvoyer les secrets. L’inspection SecretRef doit signaler la disponibilité, pas
  les valeurs.
* Si le Gateway est vivant, privilégier les opérations typées du Gateway. Si le Gateway est
  mort, utiliser uniquement la surface minimale de réparation locale qui ne dépend pas de la
  boucle d’agent normale.

Forme de configuration :

```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "crestodian": {
    "rescue": {
      "enabled": "auto",
      "ownerDmOnly": true,
    },
  },
}
```

`enabled` doit accepter :

* `"auto"` : par défaut. Autoriser uniquement lorsque le runtime effectif est YOLO et que
  le sandboxing est désactivé.
* `false` : ne jamais autoriser le secours par canal de messages.
* `true` : autoriser explicitement le secours lorsque les vérifications propriétaire/canal réussissent. Cela
  ne doit toujours pas contourner le refus lié au sandboxing.

La posture YOLO `"auto"` par défaut est :

* le mode sandbox se résout en `off`
* `tools.exec.security` se résout en `full`
* `tools.exec.ask` se résout en `off`

Le secours distant est couvert par la lane Docker :

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm test:docker:crestodian-rescue
```

Le repli de planificateur local sans configuration est couvert par :

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm test:docker:crestodian-planner
```

Un smoke de surface de commande de canal live à adhésion vérifie `/crestodian status` plus un
aller-retour d’approbation persistante via le gestionnaire de secours :

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm test:live:crestodian-rescue-channel
```

La configuration sans configuration via des commandes Crestodian explicites est couverte par :

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm test:docker:crestodian-first-run
```

Cette lane démarre avec un répertoire d’état vide, vérifie le point d’entrée Crestodian d’onboarding moderne,
définit le modèle par défaut, crée un agent supplémentaire, configure
Discord via une activation de plugin plus un SecretRef de jeton, valide la configuration et
vérifie le journal d’audit. QA Lab dispose aussi d’un scénario adossé au dépôt pour le même flux Ring 0 :

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm openclaw qa suite --scenario crestodian-ring-zero-setup
```

## Connexe

* [Référence CLI](/fr/cli)
* [Doctor](/fr/cli/doctor)
* [TUI](/fr/cli/tui)
* [Sandbox](/fr/cli/sandbox)
* [Sécurité](/fr/cli/security)