Zum Hauptinhalt springen

Documentation Index

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

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

​
openclaw crestodian

Crestodian ist OpenClaws lokaler Helfer für Einrichtung, Reparatur und Konfiguration. Er ist darauf ausgelegt, erreichbar zu bleiben, wenn der normale Agent-Pfad defekt ist. Wenn Sie openclaw ohne Befehl ausführen, startet Crestodian in einem interaktiven Terminal. Wenn Sie openclaw crestodian ausführen, startet derselbe Helfer explizit.

​
Was Crestodian anzeigt

Beim Start öffnet der interaktive Crestodian dieselbe TUI-Shell, die auch von openclaw tui verwendet wird, mit einem Crestodian-Chat-Backend. Das Chatprotokoll beginnt mit einer kurzen Begrüßung:
  • wann Crestodian gestartet werden sollte
  • welchen Modell- oder deterministischen Planner-Pfad Crestodian tatsächlich verwendet
  • Konfigurationsgültigkeit und den Standard-Agent
  • Gateway-Erreichbarkeit aus der ersten Startprüfung
  • die nächste Debug-Aktion, die Crestodian ausführen kann
Er gibt keine Geheimnisse aus und lädt keine Plugin-CLI-Befehle nur zum Starten. Die TUI stellt weiterhin den normalen Header, das Chatprotokoll, die Statuszeile, den Footer, Autovervollständigung und Editor-Steuerungen bereit. Verwenden Sie status für das detaillierte Inventar mit Konfigurationspfad, Docs-/Quellpfaden, lokalen CLI-Prüfungen, API-Key-Vorhandensein, Agenten, Modell- und Gateway-Details. Crestodian verwendet dieselbe OpenClaw-Referenzerkennung wie normale Agenten. In einem Git-Checkout verweist er auf lokale docs/ und den lokalen Quellbaum. Bei einer npm-Paketinstallation verwendet er die gebündelten Paketdokumente und verlinkt auf https://github.com/openclaw/openclaw, mit ausdrücklicher Empfehlung, den Quellcode zu prüfen, wenn die Dokumentation nicht ausreicht.

​
Beispiele

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
Innerhalb der Crestodian-TUI: 
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

​
Sicherer Start

Crestodians Startpfad ist bewusst klein gehalten. Er kann ausgeführt werden, wenn:
  • openclaw.json fehlt
  • openclaw.json ungültig ist
  • der Gateway nicht läuft
  • die Registrierung von Plugin-Befehlen nicht verfügbar ist
  • noch kein Agent konfiguriert wurde
openclaw --help und openclaw --version verwenden weiterhin die normalen schnellen Pfade. Nichtinteraktives openclaw wird mit einer kurzen Meldung beendet, statt die Root-Hilfe auszugeben, weil das Produkt ohne Befehl Crestodian ist.

​
Vorgänge und Genehmigung

Crestodian verwendet typisierte Vorgänge, statt die Konfiguration ad hoc zu bearbeiten. Schreibgeschützte Vorgänge können sofort ausgeführt werden:
  • Übersicht anzeigen
  • Agenten auflisten
  • installierte Plugins auflisten
  • ClawHub-Plugins suchen
  • Modell-/Backend-Status anzeigen
  • Status- oder Zustandsprüfungen ausführen
  • Gateway-Erreichbarkeit prüfen
  • Doctor ohne interaktive Korrekturen ausführen
  • Konfiguration validieren
  • Audit-Protokollpfad anzeigen
Dauerhafte Vorgänge erfordern im interaktiven Modus eine Genehmigung im Gespräch, es sei denn, Sie übergeben --yes für einen direkten Befehl:
  • Konfiguration schreiben
  • config set ausführen
  • unterstützte SecretRef-Werte über config set-ref setzen
  • Setup-/Onboarding-Bootstrap ausführen
  • Standardmodell ändern
  • Gateway starten, stoppen oder neu starten
  • Agenten erstellen
  • Plugins aus ClawHub oder npm installieren
  • Plugins deinstallieren
  • Doctor-Reparaturen ausführen, die Konfiguration oder Zustand neu schreiben
Angewendete Schreibvorgänge werden aufgezeichnet in: 
~/.openclaw/audit/crestodian.jsonl
Discovery wird nicht auditiert. Nur angewendete Vorgänge und Schreibvorgänge werden protokolliert. openclaw onboard --modern startet Crestodian als moderne Onboarding-Vorschau. Einfaches openclaw onboard führt weiterhin das klassische Onboarding aus.

​
Setup-Bootstrap

setup ist der chatorientierte Onboarding-Bootstrap. Er schreibt ausschließlich über typisierte Konfigurationsvorgänge und fragt zuerst nach Genehmigung. 
setup
setup workspace ~/Projects/work
setup workspace ~/Projects/work model openai/gpt-5.5
Wenn kein Modell konfiguriert ist, wählt setup das erste nutzbare Backend in dieser Reihenfolge aus und teilt Ihnen mit, was ausgewählt wurde:
  • vorhandenes explizites Modell, falls bereits konfiguriert
  • 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
Wenn keines verfügbar ist, schreibt setup trotzdem den Standard-Workspace und lässt das Modell ungesetzt. Installieren Sie Codex/Claude Code oder melden Sie sich dort an, oder stellen Sie OPENAI_API_KEY/ANTHROPIC_API_KEY bereit, und führen Sie setup dann erneut aus.

​
Modellgestützter Planner

Crestodian startet immer im deterministischen Modus. Für unscharfe Befehle, die der deterministische Parser nicht versteht, kann der lokale Crestodian einen begrenzten Planner-Durchlauf über OpenClaws normale Laufzeitpfade ausführen. Er verwendet zuerst das konfigurierte OpenClaw-Modell. Wenn noch kein konfiguriertes Modell verwendbar ist, kann er auf lokale Laufzeiten zurückfallen, die bereits auf dem Rechner vorhanden sind:
  • Claude Code CLI: claude-cli/claude-opus-4-7
  • Codex app-server harness: openai/gpt-5.5
  • Codex CLI: codex-cli/gpt-5.5
Der modellgestützte Planner kann die Konfiguration nicht direkt verändern. Er muss die Anfrage in einen der typisierten Befehle von Crestodian übersetzen; anschließend gelten die normalen Genehmigungs- und Audit-Regeln. Crestodian gibt das verwendete Modell und den interpretierten Befehl aus, bevor irgendetwas ausgeführt wird. Planner-Durchläufe als konfigurationsloser Fallback sind temporär, werkzeugdeaktiviert, sofern die Laufzeit dies unterstützt, und verwenden einen temporären Workspace/eine temporäre Sitzung. Der Rettungsmodus für Nachrichtenkanäle verwendet den modellgestützten Planner nicht. Remote- Rettung bleibt deterministisch, damit ein defekter oder kompromittierter normaler Agent-Pfad nicht als Konfigurationseditor verwendet werden kann.

​
Zu einem Agent wechseln

Verwenden Sie einen natürlichsprachlichen Selektor, um Crestodian zu verlassen und die normale TUI zu öffnen: 
talk to agent
talk to work agent
switch to main agent
openclaw tui, openclaw chat und openclaw terminal öffnen weiterhin direkt die normale Agent-TUI. Sie starten Crestodian nicht. Nachdem Sie in die normale TUI gewechselt sind, verwenden Sie /crestodian, um zu Crestodian zurückzukehren. Sie können eine Folgeanfrage einschließen: 
/crestodian
/crestodian restart gateway
Agent-Wechsel innerhalb der TUI hinterlassen einen Hinweis, dass /crestodian verfügbar ist.

​
Rettungsmodus über Nachrichten

Der Rettungsmodus über Nachrichten ist der Nachrichtenkanal-Einstiegspunkt für Crestodian. Er ist für den Fall gedacht, dass Ihr normaler Agent ausgefallen ist, ein vertrauenswürdiger Kanal wie WhatsApp aber weiterhin Befehle empfängt. Unterstützter Textbefehl:
  • /crestodian <request>
Operator-Ablauf: 
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.
Die Agent-Erstellung kann ebenfalls über den lokalen Prompt oder den Rettungsmodus eingereiht werden: 
create agent work workspace ~/Projects/work model openai/gpt-5.5
/crestodian create agent work workspace ~/Projects/work
Der Remote-Rettungsmodus ist eine Admin-Oberfläche. Er muss wie eine Remote- Konfigurationsreparatur behandelt werden, nicht wie normaler Chat. Sicherheitsvertrag für Remote-Rettung:
  • Deaktiviert, wenn Sandboxing aktiv ist. Wenn ein Agent/eine Sitzung in einer Sandbox läuft, muss Crestodian die Remote-Rettung verweigern und erklären, dass eine lokale CLI-Reparatur erforderlich ist.
  • Der standardmäßige effektive Zustand ist auto: Remote-Rettung nur im vertrauenswürdigen YOLO- Betrieb erlauben, bei dem die Laufzeit bereits über unsandboxed lokale Autorität verfügt.
  • Eine explizite Eigentümeridentität ist erforderlich. Rescue darf keine Wildcard-Absenderregeln, offene Gruppenrichtlinien, nicht authentifizierten Webhooks oder anonymen Kanäle akzeptieren.
  • Standardmäßig nur Eigentümer-DMs. Gruppen-/Kanal-Rettung erfordert explizites Opt-in.
  • Plugin-Suche und -Liste sind schreibgeschützt. Plugin-Installation ist standardmäßig nur lokal, weil dabei ausführbarer Code heruntergeladen wird. Plugin-Deinstallation kann als genehmigter Reparaturvorgang erlaubt werden, wenn die Rescue-Richtlinie dauerhafte Schreibvorgänge zulässt.
  • Remote-Rettung kann die lokale TUI nicht öffnen oder in eine interaktive Agent- Sitzung wechseln. Verwenden Sie lokales openclaw für die Agent-Übergabe.
  • Dauerhafte Schreibvorgänge erfordern weiterhin Genehmigung, auch im Rettungsmodus.
  • Jeden angewendeten Rettungsvorgang auditieren. Rettung über Nachrichtenkanäle zeichnet Kanal, Konto, Absender und Metadaten zur Quelladresse auf. Konfigurationsändernde Vorgänge zeichnen außerdem Konfigurations-Hashes vor und nach der Änderung auf.
  • Niemals Geheimnisse ausgeben. SecretRef-Inspektion sollte Verfügbarkeit melden, nicht Werte.
  • Wenn der Gateway aktiv ist, bevorzugen Sie typisierte Gateway-Vorgänge. Wenn der Gateway ausgefallen ist, verwenden Sie nur die minimale lokale Reparaturoberfläche, die nicht vom normalen Agent-Loop abhängt.
Konfigurationsform: 
{
  "crestodian": {
    "rescue": {
      "enabled": "auto",
      "ownerDmOnly": true,
    },
  },
}
enabled sollte akzeptieren:
  • "auto": Standard. Nur erlauben, wenn die effektive Laufzeit YOLO ist und Sandboxing aus ist.
  • false: Rettung über Nachrichtenkanäle niemals erlauben.
  • true: Rettung explizit erlauben, wenn die Eigentümer-/Kanalprüfungen bestehen. Dies darf die Sandboxing-Verweigerung weiterhin nicht umgehen.
Die standardmäßige "auto"-YOLO-Haltung ist:
  • Sandbox-Modus wird zu off aufgelöst
  • tools.exec.security wird zu full aufgelöst
  • tools.exec.ask wird zu off aufgelöst
Remote-Rettung wird durch die Docker-Lane abgedeckt: 
pnpm test:docker:crestodian-rescue
Der konfigurationslose lokale Planner-Fallback wird abgedeckt durch: 
pnpm test:docker:crestodian-planner
Ein Opt-in-Live-Smoke für die Befehlsschnittstelle des Kanals prüft /crestodian status sowie einen dauerhaften Genehmigungs-Roundtrip durch den Rescue-Handler: 
pnpm test:live:crestodian-rescue-channel
Frisches konfigurationsloses Setup über Crestodian wird abgedeckt durch: 
pnpm test:docker:crestodian-first-run
Diese Lane beginnt mit einem leeren Zustandsverzeichnis, leitet reines openclaw an Crestodian weiter, setzt das Standardmodell, erstellt einen zusätzlichen Agent, konfiguriert Discord über eine Plugin-Aktivierung plus Token-SecretRef, validiert die Konfiguration und prüft das Audit- Protokoll. QA Lab hat außerdem ein repo-gestütztes Szenario für denselben Ring-0-Ablauf: 
pnpm openclaw qa suite --scenario crestodian-ring-zero-setup

​
Verwandte Themen