openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh uk translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-25 12:21:33 +00:00
parent 8c58346a39
commit f30bc980c3
2 changed files with 502 additions and 492 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

188
docs/uk/cli/crestodian.md
View File

@ -1,15 +1,15 @@
---
read_when:
- Ви запускаєте openclaw без команди й хочете зрозуміти Crestodian
- Вам потрібен безпечний спосіб без конфігурації, щоб перевірити або відновити OpenClaw
- Ви проєктуєте або вмикаєте режим відновлення каналу повідомлень
summary: Довідник CLI та модель безпеки для Crestodian, помічника з налаштування й відновлення без конфігурації та з безпечними значеннями за замовчуванням
- Ви запускаєте openclaw без команди та хочете зрозуміти, що таке Crestodian
- Вам потрібен безконфігураційно-безпечний спосіб перевірити або відновити OpenClaw
- Ви проєктуєте або вмикаєте режим відновлення для каналу повідомлень
summary: Довідка CLI та модель безпеки для Crestodian, безконфігураційно-безпечного інструмента налаштування та відновлення
title: Crestodian
x-i18n:
generated_at: "2026-04-25T11:56:36Z"
generated_at: "2026-04-25T12:18:26Z"
model: gpt-5.4
provider: openai
source_hash: 4857fccfc3d5c35c0a05c47d8c2276b828484b9a0a2030447a31072c2a13b4f5
source_hash: ebcd6a72f78134fa572a85acc6c2f0381747a27fd6be84269c273390300bb533
source_path: cli/crestodian.md
workflow: 15
---
@ -17,35 +17,35 @@ x-i18n:
# `openclaw crestodian`
Crestodian — це локальний помічник OpenClaw для налаштування, відновлення та конфігурації. Його
спроєктовано так, щоб він залишався доступним, коли звичайний шлях агента зламаний.
спроєктовано так, щоб він залишався доступним, коли звичайний шлях агента зламано.
Запуск `openclaw` без команди запускає Crestodian в інтерактивному терміналі.
Запуск `openclaw` без команди відкриває Crestodian в інтерактивному терміналі.
Запуск `openclaw crestodian` явно запускає того самого помічника.
## Що показує Crestodian
Під час запуску інтерактивний Crestodian відкриває ту саму оболонку TUI, що й
Під час запуску інтерактивний Crestodian відкриває ту саму оболонку TUI, що використовується в
`openclaw tui`, але з чат-бекендом Crestodian. Журнал чату починається з короткого
привітання:
- коли слід запускати Crestodian
- яку модель або який шлях детермінованого планувальника Crestodian фактично використовує
- яку модель або шлях детерміністичного планувальника Crestodian фактично використовує
- валідність конфігурації та агента за замовчуванням
- доступність Gateway з першої перевірки під час запуску
- доступність Gateway із першої перевірки під час запуску
- наступну дію з налагодження, яку Crestodian може виконати
Він не виводить секрети та не завантажує команди CLI Plugin лише для запуску. TUI
усе одно надає звичайний заголовок, журнал чату, рядок стану, нижній колонтитул, автодоповнення
Він не виводить секрети й не завантажує CLI-команди Plugin лише для запуску. TUI
усе ще надає звичайний заголовок, журнал чату, рядок стану, нижній колонтитул, автодоповнення
та елементи керування редактором.
Використовуйте `status` для детального переліку з шляхом до конфігурації, шляхами до docs/source,
локальними перевірками CLI, наявністю API-ключів, агентами, моделлю та відомостями про Gateway.
локальними CLI-перевірками, наявністю API-ключів, агентами, моделлю та відомостями про Gateway.
Crestodian використовує те саме виявлення довідкових матеріалів OpenClaw, що й звичайні агенти. У Git checkout
він спрямовує себе на локальний `docs/` і локальне дерево source. В установленому npm package він
використовує docs із комплекту package і посилається на
Crestodian використовує той самий механізм виявлення довідкових матеріалів OpenClaw, що й звичайні агенти. У Git checkout
він спрямовує себе на локальні `docs/` і локальне дерево вихідного коду. У разі встановлення npm package він
використовує docs із комплекту пакета та посилається на
[https://github.com/openclaw/openclaw](https://github.com/openclaw/openclaw), з явною
рекомендацією переглядати source, коли docs недостатньо.
рекомендацією переглянути вихідний код, якщо docs недостатньо.
## Приклади
@ -90,13 +90,13 @@ quit
- `openclaw.json` відсутній
- `openclaw.json` невалідний
- Gateway недоступний
- Gateway не працює
- реєстрація команд Plugin недоступна
- ще не налаштовано жодного агента
`openclaw --help` і `openclaw --version` як і раніше використовують звичайні швидкі шляхи.
Неінтерактивний `openclaw` завершує роботу з коротким повідомленням замість виведення кореневої
довідки, оскільки продукт без команди — це Crestodian.
`openclaw --help` і `openclaw --version` усе ще використовують звичайні швидкі шляхи.
Неінтерактивний `openclaw` завершується коротким повідомленням замість виведення довідки
верхнього рівня, оскільки продуктом без команди є Crestodian.
## Операції та підтвердження
@ -107,23 +107,23 @@ Crestodian використовує типізовані операції зам
- показати огляд
- перелічити агентів
- показати стан моделі/бекенда
- виконати перевірки `status` або `health`
- запустити перевірки status або health
- перевірити доступність Gateway
- запустити `doctor` без інтерактивних виправлень
- перевірити конфігурацію
- запустити doctor без інтерактивних виправлень
- validate config
- показати шлях до журналу аудиту
Операції зі збереженням змін вимагають підтвердження в розмові в інтерактивному режимі, якщо
Постійні операції потребують підтвердження в розмові в інтерактивному режимі, якщо
ви не передасте `--yes` для прямої команди:
- записати конфігурацію
- виконати `config set`
- встановити підтримувані значення SecretRef через `config set-ref`
- запустити bootstrap налаштування/онбордингу
- запустити `config set`
- задати підтримувані значення SecretRef через `config set-ref`
- запустити bootstrap налаштування/onboarding
- змінити модель за замовчуванням
- запустити, зупинити або перезапустити Gateway
- створити агентів
- виконати виправлення doctor, які переписують конфігурацію або стан
- запустити виправлення doctor, які переписують конфігурацію або стан
Застосовані записи фіксуються в:
@ -131,14 +131,14 @@ Crestodian використовує типізовані операції зам
~/.openclaw/audit/crestodian.jsonl
```
Виявлення не аудитується. У журнал потрапляють лише застосовані операції та записи.
Виявлення не аудитується. Журналюються лише застосовані операції та записи.
`openclaw onboard --modern` запускає Crestodian як modern preview онбордингу.
Звичайний `openclaw onboard` як і раніше запускає classic onboarding.
`openclaw onboard --modern` запускає Crestodian як modern preview для onboarding.
Звичайний `openclaw onboard` усе ще запускає classic onboarding.
## Bootstrap налаштування
`setup` — це bootstrap онбордингу з пріоритетом чату. Він записує зміни лише через типізовані
`setup` — це bootstrap onboarding у стилі чату. Він записує дані лише через типізовані
операції конфігурації та спочатку запитує підтвердження.
```text
@ -147,43 +147,43 @@ setup workspace ~/Projects/work
setup workspace ~/Projects/work model openai/gpt-5.5
```
Коли модель не налаштована, setup вибирає перший придатний бекенд у такому
порядку та повідомляє, що саме він вибрав:
Якщо модель не налаштована, 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.
Якщо жоден варіант недоступний, setup усе одно записує workspace за замовчуванням і залишає
модель незаданою. Установіть або виконайте вхід у Codex/Claude Code, або зробіть
`OPENAI_API_KEY`/`ANTHROPIC_API_KEY` доступними, а потім знову запустіть setup.
## Model-Assisted Planner
## Планувальник із підтримкою моделі
Crestodian завжди запускається в детермінованому режимі. Для нечітких команд, які
детермінований парсер не розуміє, локальний Crestodian може виконати один обмежений
хід планувальника через звичайні runtime-шляхи OpenClaw. Спочатку він використовує
Crestodian завжди запускається в детерміністичному режимі. Для нечітких команд, які
детерміністичний парсер не розуміє, локальний Crestodian може виконати один обмежений
хід планувальника через звичайні шляхи виконання OpenClaw. Спочатку він використовує
налаштовану модель OpenClaw. Якщо жодна налаштована модель ще не придатна до використання,
він може перейти до локальних runtime, уже наявних на машині:
він може повернутися до локальних середовищ виконання, які вже наявні на машині:
- Claude Code CLI: `claude-cli/claude-opus-4-7`
- harness app-server Codex: `openai/gpt-5.5` з `embeddedHarness.runtime: "codex"`
- Codex app-server harness: `openai/gpt-5.5` з `embeddedHarness.runtime: "codex"`
- Codex CLI: `codex-cli/gpt-5.5`
Model-Assisted Planner не може безпосередньо змінювати конфігурацію. Він має перетворити
запит на одну з типізованих команд Crestodian, після чого застосовуються звичайні правила
підтвердження й аудиту. Crestodian виводить модель, яку він використав, і інтерпретовану
команду перед виконанням будь-яких дій. Резервні ходи планувальника без конфігурації є
тимчасовими, виконуються без інструментів там, де це підтримує runtime, і використовують
тимчасовий робочий простір/сеанс.
Планувальник із підтримкою моделі не може безпосередньо змінювати конфігурацію. Він має
перекласти запит в одну з типізованих команд Crestodian, після чого застосовуються
звичайні правила підтвердження й аудиту. Crestodian виводить модель, яку він використав,
і інтерпретовану команду перед виконанням будь-яких дій. Резервні ходи планувальника
в безконфігураційному режимі є тимчасовими, без інструментів там, де це підтримує середовище виконання,
і використовують тимчасовий workspace/session.
Режим відновлення каналу повідомлень не використовує Model-Assisted Planner. Віддалене
відновлення залишається детермінованим, щоб зламаний або скомпрометований звичайний шлях агента
Режим відновлення каналу повідомлень не використовує планувальник із підтримкою моделі. Віддалене
відновлення залишається детерміністичним, щоб зламаний або скомпрометований звичайний шлях агента
не можна було використати як редактор конфігурації.
## Перемикання до агента
## Перемикання на агента
Використовуйте селектор природною мовою, щоб вийти з Crestodian і відкрити звичайний TUI:
@ -193,30 +193,30 @@ talk to work agent
switch to main agent
```
`openclaw tui`, `openclaw chat` і `openclaw terminal` як і раніше безпосередньо відкривають
звичайний TUI агента. Вони не запускають Crestodian.
`openclaw tui`, `openclaw chat` і `openclaw terminal` усе ще безпосередньо відкривають звичайний
TUI агента. Вони не запускають Crestodian.
Після переходу до звичайного TUI використовуйте `/crestodian`, щоб повернутися до Crestodian.
Ви можете додати подальший запит:
Після перемикання до звичайного TUI використайте `/crestodian`, щоб повернутися до Crestodian.
Ви можете додати наступний запит:
```text
/crestodian
/crestodian restart gateway
```
Перемикання агента в межах TUI залишає підказку, що `/crestodian` доступний.
Перемикання агентів у межах TUI залишає підказку, що `/crestodian` доступний.
## Режим відновлення повідомлень
Режим відновлення повідомлень — це точка входу Crestodian для каналу повідомлень. Він призначений
для випадків, коли ваш звичайний агент недоступний, але довірений канал, такий як WhatsApp,
усе ще приймає команди.
Режим відновлення повідомлень — це точка входу до Crestodian через канал повідомлень. Він призначений для
випадку, коли ваш звичайний агент не працює, але довірений канал, такий як WhatsApp,
усе ще отримує команди.
Підтримувана текстова команда:
- `/crestodian <request>`
Потік дій оператора:
Потік для оператора:
```text
You, in a trusted owner DM: /crestodian status
@ -234,28 +234,29 @@ create agent work workspace ~/Projects/work model openai/gpt-5.5
/crestodian create agent work workspace ~/Projects/work
```
Віддалений режим відновлення — це адміністративна поверхня. До нього слід ставитися як до
Віддалений режим відновлення — це поверхня адміністрування. До нього слід ставитися як до
віддаленого відновлення конфігурації, а не як до звичайного чату.
Контракт безпеки для віддаленого відновлення:
- Вимкнено, коли активне sandboxing. Якщо агент/сеанс працює в sandbox,
Crestodian має відмовити у віддаленому відновленні та пояснити, що потрібне локальне відновлення через CLI.
- Вимкнено, коли активне sandboxing. Якщо агент/session працює в sandbox,
Crestodian має відмовити у віддаленому відновленні й пояснити, що потрібне локальне відновлення через CLI.
- Ефективний стан за замовчуванням — `auto`: дозволяти віддалене відновлення лише в довіреному режимі YOLO,
де runtime вже має локальні повноваження без sandbox.
- Вимагати явної ідентичності власника. Відновлення не повинно приймати правила відправника з wildcard,
відкриту політику груп, неавтентифіковані Webhook або анонімні канали.
- За замовчуванням — лише owner DM. Відновлення в групі/каналі вимагає явного opt-in і
все одно має спрямовувати запити на підтвердження до owner DM.
- Віддалене відновлення не може відкрити локальний TUI або перемкнутися в інтерактивний сеанс агента.
Для передачі керування агенту використовуйте локальний `openclaw`.
- Зміни, що зберігаються, як і раніше потребують підтвердження, навіть у режимі відновлення.
- Аудитуйте кожну застосовану операцію відновлення, включно з каналом, обліковим записом, відправником,
ключем сеансу, операцією, хешем конфігурації до та хешем конфігурації після.
- Ніколи не віддзеркалюйте секрети. Перевірка SecretRef має повідомляти про доступність, а не про значення.
- Якщо Gateway працює, віддавайте перевагу типізованим операціям Gateway. Якщо Gateway
недоступний, використовуйте лише мінімальну локальну поверхню відновлення, яка не залежить від
звичайного циклу агента.
де середовище виконання вже має локальні повноваження без sandbox.
- Вимагати явної identity власника. Відновлення не повинно приймати правила відправника з wildcard, відкриту політику group,
неавтентифіковані Webhook або анонімні канали.
- Лише owner DM за замовчуванням. Відновлення в group/channel потребує явного opt-in і
все одно має маршрутизувати запити на підтвердження до owner DM.
- Віддалене відновлення не може відкрити локальний TUI або перемкнутися в інтерактивну сесію агента.
Для передачі агенту використовуйте локальний `openclaw`.
- Постійні записи все одно потребують підтвердження, навіть у режимі відновлення.
- Аудитуйте кожну застосовану операцію відновлення, включно з channel, account, sender,
ключем session, операцією, хешем конфігурації до та хешем конфігурації після.
- Ніколи не віддзеркалюйте секрети. Перевірка SecretRef має повідомляти про доступність, а не
про значення.
- Якщо Gateway працює, надавайте перевагу типізованим операціям Gateway. Якщо Gateway
не працює, використовуйте лише мінімальну локальну поверхню відновлення, яка не залежить
від звичайного циклу агента.
Форма конфігурації:
@ -272,11 +273,11 @@ create agent work workspace ~/Projects/work model openai/gpt-5.5
`enabled` має приймати:
- `"auto"`: за замовчуванням. Дозволяти лише тоді, коли ефективний runtime — YOLO, а
- `"auto"`: значення за замовчуванням. Дозволяти лише тоді, коли ефективне середовище виконання — YOLO, а
sandboxing вимкнено.
- `false`: ніколи не дозволяти відновлення через канал повідомлень.
- `true`: явно дозволяти відновлення, коли перевірки owner/channel пройдено. Це
все одно не повинно обходити відмову через sandboxing.
все одно не повинно обходити заборону sandboxing.
Поведінка YOLO за замовчуванням для `"auto"`:
@ -290,32 +291,37 @@ create agent work workspace ~/Projects/work model openai/gpt-5.5
pnpm test:docker:crestodian-rescue
```
Резервний локальний planner без конфігурації покривається:
Резервний локальний планувальник у безконфігураційному режимі покривається:
```bash
pnpm test:docker:crestodian-planner
```
Опціональна live smoke-перевірка поверхні команд каналу перевіряє `/crestodian status` плюс
повний цикл підтвердження змін, що зберігаються, через обробник відновлення:
Opt-in live smoke-перевірка поверхні команд каналу перевіряє `/crestodian status`, а також
цикл постійного підтвердження через обробник відновлення:
```bash
pnpm test:live:crestodian-rescue-channel
```
Налаштування без конфігурації з нуля через Crestodian покривається:
Нове безконфігураційне налаштування через Crestodian покривається:
```bash
pnpm test:docker:crestodian-first-run
```
Ця lane починається з порожнього каталогу стану, спрямовує `openclaw` без команди до Crestodian,
встановлює модель за замовчуванням, створює додаткового агента, налаштовує Discord через
SecretRef токена, перевіряє конфігурацію та перевіряє журнал аудиту.
Ця lane починається з порожнього каталогу стану, спрямовує `openclaw` без аргументів до Crestodian,
установлює модель за замовчуванням, створює додаткового агента, налаштовує Discord через
увімкнення Plugin та token SecretRef, виконує validate config і перевіряє журнал
аудиту. QA Lab також має сценарій із підтримкою repo для того самого потоку Ring 0:
```bash
pnpm openclaw qa suite --scenario crestodian-ring-zero-setup
```
## Пов’язане
- [Довідник CLI](/uk/cli)
- [Довідка CLI](/uk/cli)
- [Doctor](/uk/cli/doctor)
- [TUI](/uk/cli/tui)
- [Sandbox](/uk/cli/sandbox)

806
docs/uk/help/testing.md
View File

File diff suppressed because it is too large Load Diff