Crestodian

`openclaw crestodian`

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

L’exécution de openclaw sans commande lance d’abord l’onboarding classique lorsque le fichier de configuration actif est manquant ou ne contient pas de paramètres authored (vide ou métadonnées uniquement). Une fois qu’un fichier de configuration contient des paramètres authored, l’exécution de openclaw sans commande lance Crestodian dans un terminal interactif. L’exécution de openclaw crestodian lance explicitement le même assistant.

Ce que montre 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 démarrer Crestodian
le modèle ou le chemin du planificateur déterministe que Crestodian utilise réellement
validité de la configuration et l’agent par défaut
accessibilité du Gateway à partir de la première sonde de démarrage
la prochaine action de débogage que Crestodian peut entreprendre

Il ne vide pas les secrets ni ne charge les commandes CLI des plugins juste pour démarrer. La TUI fournit toujours l’en-tête normal, le journal de discussion, 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 locales CLI, la présence de clé API, les agents, le model et les détails du Gateway.

Crestodian utilise la même découverte de référence OpenClaw que les agents réguliers. Dans un checkout Git, il se pointe vers le docs/ local et l’arborescence source locale. Dans une installation de paquet npm, il utilise les docs du paquet groupé et des liens vers https://github.com/openclaw/openclaw, avec des conseils explicites pour consulter la source chaque fois que les docs ne suffisent pas.

Exemples

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 la TUI 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

Démarrage sécurisé

Le chemin de démarrage de Crestodian est délibérément petit. Il peut fonctionner lorsque :

openclaw.json est manquant
openclaw.json est invalide
le Gateway est en panne
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. Le openclaw nu non interactif se termine avec un court message au lieu d’imprimer l’aide racine. Sur une installation fraîche, le message pointe vers l’onboarding non interactif ; après la configuration, il pointe vers les commandes Crestodian ponctuelles.

Opérations et approbation

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

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

afficher l’aperçu
lister les agents
list installed plugins
rechercher des plugins ClawHub
afficher le statut du modèle/backend
exécuter des vérifications de statut ou de santé
vérifier l’accessibilité de la Gateway
exécuter le 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
run config set
définir les valeurs SecretRef prises en charge via config set-ref
exécuter l’amorçage (bootstrap) de la configuration/onboarding
changer le modèle par défaut
démarrer, arrêter ou redémarrer la Gateway
créer des agents
installer des plugins depuis ClawHub ou npm
désinstaller des plugins
exécuter des réparations du docteur qui réécrivent la configuration ou l’état

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

~/.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 en tant qu’aperçu de l’onboarding moderne. Le openclaw onboard simple exécute toujours l’onboarding classique.

Amorçage de la configuration

setup est le bootstrap d’onboarding centré sur le chat. Il n’écrit qu’à travers des opérations de configuration typées et demande d’abord l’approbation.

setup
setup workspace ~/Projects/work
setup workspace ~/Projects/work model openai/gpt-5.5

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

model explicite existant, si déjà configuré
OPENAI_API_KEY -> openai/gpt-5.5
ANTHROPIC_API_KEY -> anthropic/claude-opus-4-8
Claude Code CLI -> CLIclaude-cli/claude-opus-4-8
Codex -> openai/gpt-5.5 via le harnais de serveur d’application Codex

Si aucun n’est disponible, l’configuration écrit toujours 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 réexécutez l’installation.

Planificateur assisté par model

Crestodian démarre toujours en mode déterministe. Pour les commandes floues que l’analyseur déterministe ne comprend pas, le Crestodian local peut effectuer un tour de planification 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 revenir aux runtimes locaux déjà présents sur la machine :

Claude Code CLI : CLIclaude-cli/claude-opus-4-8
Harnais de serveur d’application Codex : openai/gpt-5.5

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

Le mode de secours message-channel n’utilise pas le planificateur assisté par modèle. Le secours à distance reste déterministe pour qu’un chemin d’agent normal cassé ou compromis ne puisse pas être utilisé comme éditeur de configuration.

Passer à un agent

Utilisez un sélecteur en langage naturel pour quitter Crestodian et ouvrir la TUI normale :

talk to agent
talk to work agent
switch to main agent

openclaw tui, openclaw chat et openclaw terminalTUI ouvrent toujours directement le TUI de l’agent normal. Ils ne lancent pas Crestodian.

Après être passé au TUI normal, utilisez TUI/crestodian pour revenir à Crestodian. Vous pouvez inclure une demande de suivi :

/crestodian
/crestodian restart gateway

Les changements d’agent dans le TUI laissent une trace indiquant que TUI/crestodian est disponible.

Mode de secours de message

Le mode de secours de message est le point d’entrée message-channel pour Crestodian. Il est destiné au cas où votre agent normal est mort, mais qu’un canal de confiance tel que WhatsApp reçoit toujours les commandes.

Commande texte prise en charge :

/crestodian <request>

Flux de l’opérateur :

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 également être mise en file d’attente depuis l’invite locale ou le mode de secours :

create agent work workspace ~/Projects/work model openai/gpt-5.5
/crestodian create agent work workspace ~/Projects/work

Le mode de secours à distance est une surface d’administration. Il doit être traité comme une réparation de configuration à distance, et non comme une discussion normale.

Contrat de sécurité pour le secours à distance :

Désactivé lorsque le bac à sable est actif. Si un agent/session est dans un bac à sable, Crestodian doit refuser la sauvegarde à distance et expliquer qu’une réparation CLI locale est requise.
L’état effectif par défaut est auto : autoriser le secours à distance uniquement dans l’opération YOLO de confiance, où le runtime a déjà une autorité locale non sandboxée.
Nécessite une identité de propriétaire explicite. La sauvegarde ne doit pas accepter les règles d’expéditeur génériques, la stratégie de groupe ouvert, les webhooks non authentifiés ou les canaux anonymes.
DMs du propriétaire uniquement par défaut. La sauvegarde de groupe/canal nécessite une acceptation explicite.
La recherche et la liste de plugins sont en lecture seule. L’installation de plugins est locale uniquement par défaut car elle télécharge du code exécutable. La désinstallation de plugins peut être autorisée en tant qu’opération de réparation approuvée lorsque la stratégie de sauvegarde autorise les écritures persistantes.
Le secours à distance ne peut pas ouvrir le TUI local ni passer à une session interactive d’agent. Utilisez TUIopenclaw en local pour le transfert vers l’agent.
Les écritures persistantes nécessitent toujours une approbation, même en mode de sauvegarde.
Auditez chaque opération de sauvegarde appliquée. La sauvegarde de canal de message enregistre les métadonnées du canal, du compte, de l’expéditeur et de l’adresse source. Les opérations de modification de configuration enregistrent également les hachages de configuration avant et après.
N’échoyez jamais les secrets. L’inspection de SecretRef doit signaler la disponibilité, et non les valeurs.
Si le Gateway est actif, préférez les opérations typées Gateway. Si le Gateway est mort, utilisez uniquement la surface de réparation locale minimale qui ne dépend pas de la boucle d’agent normale.

Forme de la configuration :

{
  "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 : n’autoriser jamais le secours via le channel de messages.
true : autoriser explicitement le secours lorsque les vérifications du propriétaire/channel réussissent. Cela ne doit toujours pas contourner le refus du sandboxing.

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

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

La secours à distance est couverte par la voie Docker :

pnpm test:docker:crestodian-rescue

Le repli du planificateur local sans configuration est couvert par :

pnpm test:docker:crestodian-planner

Une surface de commande de channel en temps réel optionnelle qui effectue des tests de fumée /crestodian status ainsi qu’un aller-retour d’approbation persistant via le gestionnaire de secours :

pnpm test:live:crestodian-rescue-channel

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

pnpm test:docker:crestodian-first-run

Ce chemin commence par un répertoire d’état vide, vérifie le point d’entrée Crestodian d’intégration moderne, définit le modèle par défaut, crée un agent supplémentaire, configure Discord via l’activation d’un plugin plus un SecretRef de jeton, valide la configuration et vérifie le journal d’audit. QA Lab dispose également d’un scénario sauvegardé par repo pour le même flux Ring 0 :

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