---
read_when:
    - Ви запускаєте openclaw без команди й хочете зрозуміти, що таке Crestodian
    - Вам потрібен безпечний безконфігураційний спосіб перевірити або відновити OpenClaw
    - Ви проєктуєте або вмикаєте режим відновлення для каналів повідомлень
summary: Довідка CLI та модель безпеки для Crestodian, помічника для безпечного безконфігураційного налаштування й відновлення
title: Crestodian
x-i18n:
    generated_at: "2026-04-27T07:07:54Z"
    model: gpt-5.4
    provider: openai
    source_hash: e09331a5303120e9044ae147426ad17caeed35f092b316506ca8e4e3a1c55157
    source_path: cli/crestodian.md
    workflow: 15
---

# `openclaw crestodian`

Crestodian — це локальний помічник OpenClaw для налаштування, відновлення та конфігурації. Його
спроєктовано так, щоб він залишався доступним, коли звичайний шлях агента зламаний.

Запуск `openclaw` без команди відкриває Crestodian в інтерактивному терміналі.
Запуск `openclaw crestodian` явно запускає того самого помічника.

## Що показує Crestodian

Під час запуску інтерактивний Crestodian відкриває ту саму оболонку TUI, що й
`openclaw tui`, але з чат-бекендом Crestodian. Журнал чату починається з короткого
привітання:

- коли слід запускати Crestodian
- яку модель або який шлях детермінованого планувальника Crestodian фактично використовує
- валідність конфігурації та агента за замовчуванням
- доступність Gateway із першої перевірки під час запуску
- наступну дію для налагодження, яку Crestodian може виконати

Він не виводить секрети і не завантажує CLI-команди Plugin лише для запуску. TUI
усе ще надає звичайний заголовок, журнал чату, рядок стану, нижній колонтитул, автодоповнення
та елементи керування редактором.

Використовуйте `status` для детального переліку з шляхом до конфігурації, шляхами до docs/source,
локальними CLI-перевірками, наявністю API-ключів, агентами, моделлю та даними Gateway.

Crestodian використовує той самий механізм виявлення довідкових матеріалів OpenClaw, що й звичайні агенти. У Git checkout
він вказує на локальні `docs/` і локальне дерево вихідного коду. У встановленні з npm package він
використовує docs із комплекту пакета та посилається на
[https://github.com/openclaw/openclaw](https://github.com/openclaw/openclaw), з явною
рекомендацією переглядати вихідний код, коли docs недостатньо.

## Приклади

```bash
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
```

Усередині Crestodian TUI:

```text
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
talk to work agent
talk to agent for ~/Projects/work
audit
quit
```

## Безпечний запуск

Шлях запуску Crestodian навмисно мінімальний. Він може працювати, коли:

- `openclaw.json` відсутній
- `openclaw.json` невалідний
- Gateway недоступний
- реєстрація команд Plugin недоступна
- ще не налаштовано жодного агента

`openclaw --help` і `openclaw --version` як і раніше використовують звичайні швидкі шляхи.
Неінтерактивний `openclaw` завершується коротким повідомленням замість виведення кореневої
довідки, тому що продукт без команди — це Crestodian.

## Операції та підтвердження

Crestodian використовує типізовані операції замість довільного редагування конфігурації.

Операції лише для читання можуть виконуватися одразу:

- показати огляд
- перелічити агентів
- показати стан моделі/бекенда
- виконати перевірки status або health
- перевірити доступність Gateway
- запустити doctor без інтерактивних виправлень
- перевірити конфігурацію
- показати шлях до журналу аудиту

Операції зі збереженням змін вимагають підтвердження в діалозі в інтерактивному режимі, якщо
ви не передасте `--yes` для прямої команди:

- записати конфігурацію
- виконати `config set`
- встановити підтримувані значення SecretRef через `config set-ref`
- запустити початкове налаштування/onboarding bootstrap
- змінити модель за замовчуванням
- запустити, зупинити або перезапустити Gateway
- створити агентів
- виконати відновлення doctor, які переписують конфігурацію або стан

Застосовані записи фіксуються в:

```text
~/.openclaw/audit/crestodian.jsonl
```

Виявлення не аудититься. У журнал потрапляють лише застосовані операції та записи.

`openclaw onboard --modern` запускає Crestodian як сучасний попередній перегляд onboarding.
Звичайний `openclaw onboard` і далі запускає класичний onboarding.

## Bootstrap налаштування

`setup` — це bootstrap onboarding із чат-інтерфейсом. Він записує зміни лише через типізовані
операції конфігурації та спочатку запитує підтвердження.

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

Коли модель не налаштована, setup вибирає перший придатний бекенд у такому
порядку та повідомляє, що саме було вибрано:

- наявна явно вказана модель, якщо вона вже налаштована
- `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`

Якщо нічого з цього недоступне, setup усе одно записує робочу область за замовчуванням і залишає
модель невстановленою. Установіть або виконайте вхід у Codex/Claude Code, або надайте
`OPENAI_API_KEY`/`ANTHROPIC_API_KEY`, а потім знову запустіть setup.

## Планувальник із підтримкою моделі

Crestodian завжди запускається в детермінованому режимі. Для нечітких команд, які
детермінований парсер не розуміє, локальний Crestodian може виконати один обмежений
хід планувальника через звичайні шляхи виконання OpenClaw. Спочатку він використовує
налаштовану модель OpenClaw. Якщо жодна налаштована модель ще непридатна, він може
перейти до локальних середовищ виконання, які вже є на машині:

- Claude Code CLI: `claude-cli/claude-opus-4-7`
- harness сервера застосунку Codex: `openai/gpt-5.5` з `agentRuntime.id: "codex"`
- Codex CLI: `codex-cli/gpt-5.5`

Планувальник із підтримкою моделі не може безпосередньо змінювати конфігурацію. Він
має перетворити запит на одну з типізованих команд Crestodian, після чого
застосовуються звичайні правила підтвердження й аудиту. Crestodian виводить модель,
яку він використав, і інтерпретовану команду, перш ніж щось виконувати. Резервні ходи
безконфігураційного планувальника є тимчасовими, виконуються без інструментів там, де це підтримує середовище виконання,
і використовують тимчасову робочу область/сеанс.

Режим відновлення для каналів повідомлень не використовує планувальник із підтримкою моделі. Віддалене
відновлення залишається детермінованим, щоб зламаний або скомпрометований звичайний шлях агента
не можна було використати як редактор конфігурації.

## Перемикання на агента

Використовуйте селектор природною мовою, щоб вийти з Crestodian і відкрити звичайний TUI:

```text
talk to agent
talk to work agent
switch to main agent
```

`openclaw tui`, `openclaw chat` і `openclaw terminal` як і раніше відкривають звичайний
TUI агента безпосередньо. Вони не запускають Crestodian.

Після переходу у звичайний TUI використовуйте `/crestodian`, щоб повернутися до Crestodian.
Можна додати подальший запит:

```text
/crestodian
/crestodian restart gateway
```

Перемикання агента всередині TUI залишає підказку, що `/crestodian` доступний.

## Режим відновлення повідомлень

Режим відновлення повідомлень — це точка входу в Crestodian для каналів повідомлень. Він
призначений для випадків, коли ваш звичайний агент недоступний, але довірений канал, наприклад WhatsApp,
усе ще приймає команди.

Підтримувана текстова команда:

- `/crestodian <request>`

Потік оператора:

```text
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.
```

Створення агента також можна поставити в чергу з локального запиту або з режиму відновлення:

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

Віддалений режим відновлення — це адміністративна поверхня. До нього слід ставитися як до віддаленого
відновлення конфігурації, а не як до звичайного чату.

Контракт безпеки для віддаленого відновлення:

- Вимкнено, коли активне sandboxing. Якщо агент/сеанс працює в sandbox, Crestodian
  має відмовити у віддаленому відновленні й пояснити, що потрібне локальне відновлення через CLI.
- Ефективний стан за замовчуванням — `auto`: дозволяти віддалене відновлення лише в довіреному режимі YOLO,
  де середовище виконання вже має несандбоксовані локальні повноваження.
- Вимагати явної ідентифікації власника. Відновлення не повинно приймати правила
  відправника з wildcard, політику відкритої групи, неавтентифіковані Webhook або анонімні канали.
- За замовчуванням лише DM власника. Відновлення в групі/каналі потребує явного opt-in.
- Віддалене відновлення не може відкрити локальний TUI або перемкнутися в інтерактивний сеанс агента.
  Для передавання керування агенту використовуйте локальний `openclaw`.
- Записи, що зберігають зміни, як і раніше потребують підтвердження, навіть у режимі відновлення.
- Аудитуйте кожну застосовану операцію відновлення. Відновлення через канал повідомлень записує канал,
  обліковий запис, відправника та метадані вихідної адреси. Операції, що змінюють конфігурацію,
  також записують хеші конфігурації до і після.
- Ніколи не виводьте секрети. Перевірка SecretRef має повідомляти про доступність, а не значення.
- Якщо Gateway працює, віддавайте перевагу типізованим операціям Gateway. Якщо Gateway
  недоступний, використовуйте лише мінімальну локальну поверхню відновлення, яка не залежить
  від звичайного циклу агента.

Форма конфігурації:

```jsonc
{
  "crestodian": {
    "rescue": {
      "enabled": "auto",
      "ownerDmOnly": true,
    },
  },
}
```

`enabled` має приймати:

- `"auto"`: за замовчуванням. Дозволяти лише тоді, коли ефективне середовище виконання — YOLO і
  sandboxing вимкнено.
- `false`: ніколи не дозволяти відновлення через канал повідомлень.
- `true`: явно дозволяти відновлення, якщо перевірки власника/каналу пройдено. Це
  все одно не повинно обходити заборону sandboxing.

Поза за замовчуванням `"auto"` для YOLO така:

- режим sandbox має значення `off`
- `tools.exec.security` має значення `full`
- `tools.exec.ask` має значення `off`

Віддалене відновлення покривається Docker lane:

```bash
pnpm test:docker:crestodian-rescue
```

Резервний безконфігураційний локальний планувальник покривається:

```bash
pnpm test:docker:crestodian-planner
```

Команда opt-in для live перевірки поверхні канальних команд перевіряє `/crestodian status` плюс
повний цикл підтвердження зі збереженням змін через обробник відновлення:

```bash
pnpm test:live:crestodian-rescue-channel
```

Нове безконфігураційне налаштування через Crestodian покривається:

```bash
pnpm test:docker:crestodian-first-run
```

Ця lane починається з порожнього каталогу стану, спрямовує `openclaw` без команди в Crestodian,
установлює модель за замовчуванням, створює додаткового агента, налаштовує Discord через
увімкнення Plugin та token SecretRef, перевіряє конфігурацію і перевіряє журнал аудиту. QA Lab також має сценарій із підтримкою репозиторію для того самого потоку Ring 0:

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

## Пов’язані матеріали

- [Довідка CLI](/uk/cli)
- [Doctor](/uk/cli/doctor)
- [TUI](/uk/cli/tui)
- [Sandbox](/uk/cli/sandbox)
- [Безпека](/uk/cli/security)
