Przejdź do głównej treści

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 to lokalny pomocnik OpenClaw do konfiguracji, naprawy i ustawień. Został zaprojektowany tak, aby pozostawał dostępny, gdy normalna ścieżka agenta jest uszkodzona. Uruchomienie openclaw bez polecenia startuje Crestodian w interaktywnym terminalu. Uruchomienie openclaw crestodian startuje tego samego pomocnika jawnie.

​
Co pokazuje Crestodian

Przy starcie interaktywny Crestodian otwiera tę samą powłokę TUI używaną przez openclaw tui, z backendem czatu Crestodian. Dziennik czatu zaczyna się krótkim powitaniem:
  • kiedy uruchomić Crestodian
  • model lub deterministyczna ścieżka planera, z której Crestodian faktycznie korzysta
  • poprawność konfiguracji i domyślny agent
  • osiągalność Gateway z pierwszej próby startowej
  • następna akcja debugowania, którą Crestodian może wykonać
Nie zrzuca sekretów ani nie ładuje poleceń CLI pluginów tylko po to, aby wystartować. TUI nadal zapewnia zwykły nagłówek, dziennik czatu, wiersz statusu, stopkę, autouzupełnianie i kontrolki edytora. Użyj status, aby uzyskać szczegółowy spis ze ścieżką konfiguracji, ścieżkami dokumentacji/źródeł, lokalnymi próbami CLI, obecnością kluczy API, agentami, modelem i szczegółami Gateway. Crestodian używa tego samego wykrywania referencji OpenClaw co zwykli agenci. W checkoutcie Git wskazuje lokalne docs/ i lokalne drzewo źródeł. W instalacji pakietu npm używa dokumentacji dołączonej do pakietu i linkuje do https://github.com/openclaw/openclaw, z wyraźną wskazówką, aby sprawdzić źródła, gdy dokumentacja nie wystarcza.

​
Przykłady

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
Wewnątrz 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

​
Bezpieczny start

Ścieżka startowa Crestodian jest celowo mała. Może działać, gdy:
  • brakuje openclaw.json
  • openclaw.json jest nieprawidłowy
  • Gateway jest wyłączony
  • rejestracja poleceń pluginów jest niedostępna
  • żaden agent nie został jeszcze skonfigurowany
openclaw --help i openclaw --version nadal używają normalnych szybkich ścieżek. Nieinteraktywne openclaw kończy działanie krótkim komunikatem zamiast drukować główną pomoc, ponieważ produktem bez polecenia jest Crestodian.

​
Operacje i zatwierdzanie

Crestodian używa typowanych operacji zamiast doraźnego edytowania konfiguracji. Operacje tylko do odczytu mogą działać natychmiast:
  • pokaż przegląd
  • wyświetl listę agentów
  • wyświetl listę zainstalowanych pluginów
  • wyszukaj pluginy ClawHub
  • pokaż status modelu/backendu
  • uruchom kontrole statusu lub kondycji
  • sprawdź osiągalność Gateway
  • uruchom doctor bez interaktywnych poprawek
  • zweryfikuj konfigurację
  • pokaż ścieżkę dziennika audytu
Operacje trwałe wymagają zatwierdzenia w rozmowie w trybie interaktywnym, chyba że przekażesz --yes dla bezpośredniego polecenia:
  • zapisz konfigurację
  • uruchom config set
  • ustaw obsługiwane wartości SecretRef przez config set-ref
  • uruchom bootstrap konfiguracji/onboardingu
  • zmień domyślny model
  • uruchom, zatrzymaj lub zrestartuj Gateway
  • utwórz agentów
  • zainstaluj pluginy z ClawHub lub npm
  • odinstaluj pluginy
  • uruchom naprawy doctor, które przepisują konfigurację lub stan
Zastosowane zapisy są rejestrowane w: 
~/.openclaw/audit/crestodian.jsonl
Wykrywanie nie jest audytowane. Logowane są tylko zastosowane operacje i zapisy. openclaw onboard --modern uruchamia Crestodian jako nowoczesny podgląd onboardingu. Zwykłe openclaw onboard nadal uruchamia klasyczny onboarding.

​
Bootstrap konfiguracji

setup to bootstrap onboardingu zorientowany na czat. Zapisuje tylko przez typowane operacje konfiguracji i najpierw prosi o zatwierdzenie. 
setup
setup workspace ~/Projects/work
setup workspace ~/Projects/work model openai/gpt-5.5
Gdy żaden model nie jest skonfigurowany, setup wybiera pierwszy użyteczny backend w tej kolejności i informuje, co wybrał:
  • istniejący jawny model, jeśli jest już skonfigurowany
  • 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
Jeśli żaden nie jest dostępny, setup nadal zapisuje domyślny workspace i pozostawia model nieustawiony. Zainstaluj lub zaloguj się do Codex/Claude Code albo udostępnij OPENAI_API_KEY/ANTHROPIC_API_KEY, a następnie uruchom setup ponownie.

​
Planer wspomagany modelem

Crestodian zawsze startuje w trybie deterministycznym. Dla niejednoznacznych poleceń, których deterministyczny parser nie rozumie, lokalny Crestodian może wykonać jedną ograniczoną turę planera przez normalne ścieżki runtime OpenClaw. Najpierw używa skonfigurowanego modelu OpenClaw. Jeśli żaden skonfigurowany model nie jest jeszcze użyteczny, może wrócić do lokalnych runtime’ów już obecnych na maszynie:
  • Claude Code CLI: claude-cli/claude-opus-4-7
  • Codex app-server harness: openai/gpt-5.5 z agentRuntime.id: "codex"
  • Codex CLI: codex-cli/gpt-5.5
Planer wspomagany modelem nie może bezpośrednio modyfikować konfiguracji. Musi przetłumaczyć żądanie na jedno z typowanych poleceń Crestodian, a następnie obowiązują normalne zasady zatwierdzania i audytu. Crestodian drukuje model, którego użył, oraz zinterpretowane polecenie, zanim cokolwiek uruchomi. Awaryjne tury planera bez konfiguracji są tymczasowe, z wyłączonymi narzędziami tam, gdzie runtime to obsługuje, i używają tymczasowego workspace/sesji. Tryb ratunkowy kanału wiadomości nie używa planera wspomaganego modelem. Zdalny tryb ratunkowy pozostaje deterministyczny, aby uszkodzona lub przejęta normalna ścieżka agenta nie mogła być użyta jako edytor konfiguracji.

​
Przełączanie do agenta

Użyj selektora w języku naturalnym, aby opuścić Crestodian i otworzyć normalne TUI: 
talk to agent
talk to work agent
switch to main agent
openclaw tui, openclaw chat i openclaw terminal nadal otwierają bezpośrednio normalne TUI agenta. Nie uruchamiają Crestodian. Po przełączeniu do normalnego TUI użyj /crestodian, aby wrócić do Crestodian. Możesz dołączyć kolejne żądanie: 
/crestodian
/crestodian restart gateway
Przełączenia agentów wewnątrz TUI zostawiają ślad, że /crestodian jest dostępny.

​
Tryb ratunkowy wiadomości

Tryb ratunkowy wiadomości to punkt wejścia kanału wiadomości dla Crestodian. Jest przeznaczony dla przypadku, gdy normalny agent nie działa, ale zaufany kanał, taki jak WhatsApp, nadal odbiera polecenia. Obsługiwane polecenie tekstowe:
  • /crestodian <request>
Przepływ operatora: 
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.
Tworzenie agenta można również kolejkować z lokalnego promptu lub trybu ratunkowego: 
create agent work workspace ~/Projects/work model openai/gpt-5.5
/crestodian create agent work workspace ~/Projects/work
Zdalny tryb ratunkowy jest powierzchnią administracyjną. Musi być traktowany jak zdalna naprawa konfiguracji, a nie jak zwykły czat. Kontrakt bezpieczeństwa dla zdalnego trybu ratunkowego:
  • Wyłączony, gdy sandboxing jest aktywny. Jeśli agent/sesja jest w sandboxie, Crestodian musi odmówić zdalnego trybu ratunkowego i wyjaśnić, że wymagana jest lokalna naprawa przez CLI.
  • Domyślny efektywny stan to auto: zezwalaj na zdalny tryb ratunkowy tylko w zaufanej operacji YOLO, gdzie runtime ma już niesandboxowane lokalne uprawnienia.
  • Wymagaj jawnej tożsamości właściciela. Tryb ratunkowy nie może akceptować wildcardowych reguł nadawcy, otwartej polityki grupowej, nieuwierzytelnionych webhooków ani anonimowych kanałów.
  • Domyślnie tylko wiadomości DM właściciela. Tryb ratunkowy grupy/kanału wymaga jawnego opt-in.
  • Wyszukiwanie i lista pluginów są tylko do odczytu. Instalacja pluginu jest domyślnie tylko lokalna, ponieważ pobiera kod wykonywalny. Odinstalowanie pluginu może być dozwolone jako zatwierdzona operacja naprawcza, gdy polityka trybu ratunkowego pozwala na trwałe zapisy.
  • Zdalny tryb ratunkowy nie może otworzyć lokalnego TUI ani przełączyć się do interaktywnej sesji agenta. Użyj lokalnego openclaw do przekazania do agenta.
  • Trwałe zapisy nadal wymagają zatwierdzenia, nawet w trybie ratunkowym.
  • Audytuj każdą zastosowaną operację ratunkową. Tryb ratunkowy kanału wiadomości zapisuje kanał, konto, nadawcę i metadane adresu źródłowego. Operacje modyfikujące konfigurację zapisują także hashe konfiguracji przed i po.
  • Nigdy nie echo sekretów. Inspekcja SecretRef powinna raportować dostępność, nie wartości.
  • Jeśli Gateway działa, preferuj typowane operacje Gateway. Jeśli Gateway jest wyłączony, użyj tylko minimalnej lokalnej powierzchni naprawczej, która nie zależy od normalnej pętli agenta.
Kształt konfiguracji: 
{
  "crestodian": {
    "rescue": {
      "enabled": "auto",
      "ownerDmOnly": true,
    },
  },
}
enabled powinno akceptować:
  • "auto": domyślne. Zezwalaj tylko wtedy, gdy efektywny runtime to YOLO, a sandboxing jest wyłączony.
  • false: nigdy nie zezwalaj na tryb ratunkowy kanału wiadomości.
  • true: jawnie zezwalaj na tryb ratunkowy, gdy kontrole właściciela/kanału przejdą. To nadal nie może omijać odmowy sandboxingu.
Domyślna postawa YOLO "auto" to:
  • tryb sandboxa rozwiązuje się do off
  • tools.exec.security rozwiązuje się do full
  • tools.exec.ask rozwiązuje się do off
Zdalny tryb ratunkowy jest objęty ścieżką Docker: 
pnpm test:docker:crestodian-rescue
Awaryjny lokalny planer bez konfiguracji jest objęty przez: 
pnpm test:docker:crestodian-planner
Opt-in smoke powierzchni poleceń kanału live sprawdza /crestodian status oraz trwały roundtrip zatwierdzenia przez handler trybu ratunkowego: 
pnpm test:live:crestodian-rescue-channel
Świeża konfiguracja bez configu przez Crestodian jest objęta przez: 
pnpm test:docker:crestodian-first-run
Ta ścieżka startuje z pustym katalogiem stanu, kieruje gołe openclaw do Crestodian, ustawia domyślny model, tworzy dodatkowego agenta, konfiguruje Discord przez włączenie pluginu oraz token SecretRef, waliduje konfigurację i sprawdza dziennik audytu. QA Lab ma także scenariusz oparty na repozytorium dla tego samego przepływu Ring 0: 
pnpm openclaw qa suite --scenario crestodian-ring-zero-setup

​
Powiązane