Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw crestodian
Crestodian — це локальний помічник OpenClaw для налаштування, відновлення й конфігурації. Він
спроєктований так, щоб залишатися доступним, коли звичайний шлях агента зламаний.
Запуск openclaw без команди запускає Crestodian в інтерактивному терміналі.
Запуск openclaw crestodian явно запускає того самого помічника.
Що показує Crestodian
Під час запуску інтерактивний Crestodian відкриває ту саму оболонку TUI, яку використовуєopenclaw tui, з чат-бекендом Crestodian. Журнал чату починається з короткого
привітання:
- коли запускати Crestodian
- модель або шлях детермінованого планувальника, який Crestodian фактично використовує
- чинність конфігурації та типовий агент
- досяжність Gateway з першої перевірки під час запуску
- наступна дія налагодження, яку може виконати Crestodian
status для докладного інвентаря зі шляхом конфігурації, шляхами docs/source,
локальними перевірками CLI, наявністю API-ключів, агентами, моделлю та деталями Gateway.
Crestodian використовує те саме виявлення довідкових матеріалів OpenClaw, що й звичайні агенти. У Git checkout
він вказує на локальні docs/ і локальне дерево вихідного коду. В інсталяції npm-пакета він
використовує документацію, що входить до пакета, і посилається на
https://github.com/openclaw/openclaw, з явною
рекомендацією переглядати вихідний код, коли документації недостатньо.
Приклади
Безпечний запуск
Шлях запуску Crestodian навмисно малий. Він може працювати, коли:openclaw.jsonвідсутнійopenclaw.jsonнедійсний- Gateway не працює
- реєстрація команд Plugin недоступна
- ще не налаштовано жодного агента
openclaw --help і openclaw --version і надалі використовують звичайні швидкі шляхи.
Неінтерактивний openclaw завершує роботу з коротким повідомленням замість друку кореневої
довідки, тому що продукт без команди — це Crestodian.
Операції та схвалення
Crestodian використовує типізовані операції замість довільного редагування конфігурації. Операції лише для читання можуть виконуватися негайно:- показати огляд
- перелічити агентів
- перелічити встановлені plugins
- шукати plugins у ClawHub
- показати стан моделі/бекенду
- виконати перевірки стану або працездатності
- перевірити досяжність Gateway
- запустити doctor без інтерактивних виправлень
- перевірити конфігурацію
- показати шлях до журналу аудиту
--yes для прямої команди:
- записати конфігурацію
- виконати
config set - встановити підтримувані значення SecretRef через
config set-ref - виконати bootstrap налаштування/онбордингу
- змінити типову модель
- запустити, зупинити або перезапустити Gateway
- створити агентів
- встановити plugins із ClawHub або npm
- видалити plugins
- виконати виправлення doctor, які перезаписують конфігурацію або стан
openclaw onboard --modern запускає Crestodian як попередній перегляд сучасного онбордингу.
Звичайний openclaw onboard і надалі запускає класичний онбординг.
Bootstrap налаштування
setup — це chat-first bootstrap онбордингу. Він записує лише через типізовані
операції конфігурації та спершу запитує схвалення.
- наявна явно задана модель, якщо її вже налаштовано
OPENAI_API_KEY->openai/gpt-5.5ANTHROPIC_API_KEY->anthropic/claude-opus-4-7- Claude Code CLI ->
claude-cli/claude-opus-4-7 - Codex CLI ->
codex-cli/gpt-5.5
OPENAI_API_KEY/ANTHROPIC_API_KEY, потім запустіть setup знову.
Планувальник за допомогою моделі
Crestodian завжди запускається в детермінованому режимі. Для нечітких команд, які детермінований парсер не розуміє, локальний Crestodian може виконати один обмежений хід планувальника через звичайні runtime-шляхи OpenClaw. Спершу він використовує налаштовану модель OpenClaw. Якщо жодна налаштована модель ще не придатна, він може повернутися до локальних runtime, які вже наявні на машині:- Claude Code CLI:
claude-cli/claude-opus-4-7 - harness Codex app-server:
openai/gpt-5.5 - Codex CLI:
codex-cli/gpt-5.5
Перемикання на агента
Використовуйте селектор природною мовою, щоб залишити Crestodian і відкрити звичайний TUI:openclaw tui, openclaw chat і openclaw terminal і надалі відкривають звичайний
TUI агента напряму. Вони не запускають Crestodian.
Після перемикання у звичайний TUI використовуйте /crestodian, щоб повернутися до Crestodian.
Можна додати подальший запит:
/crestodian доступний.
Режим аварійного відновлення через повідомлення
Режим аварійного відновлення через повідомлення — це точка входу Crestodian через канал повідомлень. Він призначений для випадку, коли ваш звичайний агент не працює, але довірений канал, як-от WhatsApp, усе ще приймає команди. Підтримувана текстова команда:/crestodian <request>
- Вимкнено, коли sandboxing активний. Якщо агент/session працює в sandbox, Crestodian має відмовити у віддаленому відновленні та пояснити, що потрібне локальне виправлення через CLI.
- Типовий ефективний стан —
auto: дозволяти віддалене відновлення лише в довіреній YOLO операції, де runtime вже має локальні повноваження без sandbox. - Потрібна явна ідентичність власника. Відновлення не має приймати wildcard-правила відправника, відкриту групову політику, неавтентифіковані webhooks або анонімні канали.
- За замовчуванням лише DM власника. Відновлення в групах/каналах потребує явного opt-in.
- Пошук і список Plugin є лише для читання. Встановлення Plugin за замовчуванням лише локальне, оскільки воно завантажує виконуваний код. Видалення Plugin можна дозволити як схвалену операцію відновлення, коли політика rescue дозволяє постійні записи.
- Віддалене відновлення не може відкрити локальний TUI або перемкнутися в інтерактивну
session агента. Використовуйте локальний
openclawдля передачі керування агенту. - Постійні записи все одно потребують схвалення, навіть у режимі rescue.
- Аудитуйте кожну застосовану операцію відновлення. Відновлення через канал повідомлень записує метадані каналу, облікового запису, відправника та вихідної адреси. Операції, що змінюють конфігурацію, також записують хеші конфігурації до і після.
- Ніколи не повторюйте секрети. Перевірка SecretRef має повідомляти про наявність, а не значення.
- Якщо Gateway живий, надавайте перевагу типізованим операціям Gateway. Якщо Gateway не працює, використовуйте лише мінімальну локальну поверхню відновлення, яка не залежить від звичайного циклу агента.
enabled має приймати:
"auto": типово. Дозволяти лише тоді, коли ефективний runtime є YOLO і sandboxing вимкнено.false: ніколи не дозволяти відновлення через канал повідомлень.true: явно дозволити відновлення, коли перевірки власника/каналу проходять. Це все одно не має обходити відмову через sandboxing.
"auto":
- sandbox mode resolves to
off tools.exec.securityresolves tofulltools.exec.askresolves tooff
/crestodian status плюс
постійний roundtrip схвалення через обробник rescue:
openclaw до Crestodian,
встановлює типову модель, створює додаткового агента, налаштовує Discord через
увімкнення Plugin плюс SecretRef токена, перевіряє конфігурацію та перевіряє журнал аудиту.
QA Lab також має сценарій на основі репозиторію для того самого потоку Ring 0: