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

openclawopenclaw crestodianopenclaw crestodian --jsonopenclaw crestodian --message "models"openclaw crestodian --message "validate config"openclaw crestodian --message "setup workspace ~/Projects/work model openai/gpt-5.5" --yesopenclaw crestodian --message "set default model openai/gpt-5.5" --yesopenclaw onboard --modern

W TUI Crestodian:

statushealthdoctordoctor fixvalidate configsetupsetup workspace ~/Projects/work model openai/gpt-5.5config set gateway.port 19001config set-ref gateway.auth.token env OPENCLAW_GATEWAY_TOKENgateway statusrestart gatewayagentscreate agent work workspace ~/Projects/workmodelsset default model openai/gpt-5.5plugins listplugins search slackplugin install clawhub:openclaw-codex-app-serverplugin uninstall openclaw-codex-app-servertalk to work agenttalk to agent for ~/Projects/workauditquit

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.

setupsetup workspace ~/Projects/worksetup 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 agenttalk to work agentswitch 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 statusOpenClaw: Crestodian rescue mode. Gateway reachable: no. Config valid: no.You: /crestodian restart gatewayOpenClaw: Plan: restart the Gateway. Reply /crestodian yes to apply.You: /crestodian yesOpenClaw: 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

• Referencja CLI
• Doctor
• TUI
• Sandbox
• Bezpieczeństwo