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ń. Zaprojektowano go tak, aby pozostawał dostępny, gdy zwykła ścieżka agenta jest uszkodzona. Uruchomienie openclaw bez polecenia uruchamia Crestodian w interaktywnym terminalu. Uruchomienie openclaw crestodian jawnie uruchamia tego samego pomocnika.

​
Co pokazuje Crestodian

Podczas startu interaktywny Crestodian otwiera tę samą powłokę TUI, której używa openclaw tui, z backendem czatu Crestodian. Dziennik czatu zaczyna się krótkim powitaniem:
  • kiedy uruchomić Crestodian
  • model lub deterministyczna ścieżka planisty, której Crestodian faktycznie używa
  • poprawność konfiguracji i domyślny agent
  • osiągalność Gateway z pierwszej sondy startowej
  • następna czynność debugowania, którą Crestodian może wykonać
Nie zrzuca sekretów ani nie ładuje poleceń CLI Plugin tylko po to, aby wystartować. TUI nadal udostępnia normalny nagłówek, dziennik czatu, wiersz stanu, stopkę, autouzupełnianie i kontrolki edytora. Użyj status, aby uzyskać szczegółowy inwentarz ze ścieżką konfiguracji, ścieżkami dokumentacji/źródeł, lokalnymi sondami CLI, obecnością kluczy API, agentami, modelem i szczegółami Gateway. Crestodian używa tego samego wykrywania referencji OpenClaw co zwykli agenci. W kopii 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 przejrzeć ź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
W 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 nie działa
  • rejestracja poleceń Plugin 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 wypisywać 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 agentów
  • wyświetl zainstalowane Plugin
  • wyszukaj Plugin ClawHub
  • pokaż status modelu/backendu
  • uruchom kontrole statusu lub kondycji
  • sprawdź osiągalność Gateway
  • uruchom doctor bez interaktywnych napraw
  • 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 Plugin z ClawHub lub npm
  • odinstaluj Plugin
  • uruchom naprawy doctor, które przepisują konfigurację lub stan
Zastosowane zapisy są rejestrowane w: 
~/.openclaw/audit/crestodian.jsonl
Wykrywanie nie jest audytowane. Rejestrowane 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 onboardingowy bootstrap skoncentrowany na czacie. Zapisuje wyłącznie 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.

​
Planista Wspomagany Modelem

Crestodian zawsze startuje w trybie deterministycznym. Dla nieprecyzyjnych poleceń, których deterministyczny parser nie rozumie, lokalny Crestodian może wykonać jedną ograniczoną turę planisty przez normalne ścieżki uruchomieniowe OpenClaw. Najpierw używa skonfigurowanego modelu OpenClaw. Jeśli żaden skonfigurowany model nie jest jeszcze użyteczny, może wrócić do lokalnych środowisk uruchomieniowych już obecnych na komputerze:
  • Claude Code CLI: claude-cli/claude-opus-4-7
  • harness serwera aplikacji Codex: openai/gpt-5.5
  • Codex CLI: codex-cli/gpt-5.5
Planista wspomagany modelem nie może bezpośrednio mutować konfiguracji. Musi przetłumaczyć żądanie na jedno z typowanych poleceń Crestodian, a następnie stosowane są normalne reguły zatwierdzania i audytu. Crestodian wypisuje model, którego użył, oraz zinterpretowane polecenie, zanim cokolwiek uruchomi. Tury awaryjnego planisty 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 planisty wspomaganego modelem. Zdalny tryb ratunkowy pozostaje deterministyczny, aby uszkodzona lub przejęta normalna ścieżka agenta nie mogła zostać 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 informujący, że /crestodian jest dostępne.

​
Tryb ratunkowy wiadomości

Tryb ratunkowy wiadomości to punkt wejścia kanału wiadomości dla Crestodian. Jest przeznaczony na przypadek, 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 także zakolejkować 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 to powierzchnia administracyjna. Należy traktować go jak zdalną naprawę konfiguracji, a nie jak zwykły czat. Kontrakt bezpieczeństwa dla zdalnego trybu ratunkowego:
  • Wyłączony, gdy aktywne jest sandboxing. Jeśli agent/sesja działa w sandboxie, Crestodian musi odmówić zdalnego trybu ratunkowego i wyjaśnić, że wymagana jest lokalna naprawa CLI.
  • Domyślny stan efektywny to auto: zezwalaj na zdalny tryb ratunkowy tylko w zaufanej pracy YOLO, gdzie runtime ma już niesandboxowane uprawnienia lokalne.
  • Wymagaj jawnej tożsamości właściciela. Tryb ratunkowy nie może akceptować reguł nadawcy z wildcardami, otwartej polityki grupowej, nieuwierzytelnionych webhooków ani anonimowych kanałów.
  • Domyślnie tylko DM właściciela. Tryb ratunkowy w grupie/kanale wymaga jawnego opt-in.
  • Wyszukiwanie i lista Plugin są tylko do odczytu. Instalacja Plugin jest domyślnie tylko lokalna, ponieważ pobiera wykonywalny kod. Odinstalowanie Plugin 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ę trybu ratunkowego. Tryb ratunkowy kanału wiadomości rejestruje kanał, konto, nadawcę i metadane adresu źródłowego. Operacje mutujące konfigurację rejestrują także hashe konfiguracji przed i po.
  • Nigdy nie wypisuj sekretów. Inspekcja SecretRef powinna raportować dostępność, nie wartości.
  • Jeśli Gateway działa, preferuj typowane operacje Gateway. Jeśli Gateway nie działa, używaj 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 zezwól na tryb ratunkowy, gdy kontrole właściciela/kanału przejdą. To nadal nie może omijać odmowy z powodu sandboxingu.
Domyślna postawa YOLO "auto" to:
  • tryb sandbox 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
Lokalny awaryjny planista bez konfiguracji jest objęty przez: 
pnpm test:docker:crestodian-planner
Opcjonalny smoke test powierzchni poleceń kanału live sprawdza /crestodian status oraz trwały obieg zatwierdzenia przez handler trybu ratunkowego: 
pnpm test:live:crestodian-rescue-channel
Świeża konfiguracja bez istniejącej konfiguracji przez Crestodian jest objęta przez: 
pnpm test:docker:crestodian-first-run
Ta ścieżka zaczyna od pustego katalogu stanu, kieruje gołe openclaw do Crestodian, ustawia domyślny model, tworzy dodatkowego agenta, konfiguruje Discord przez włączenie Plugin oraz SecretRef tokenu, weryfikuje 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