chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
88c74620e7
commit
8d9ff90c42
@ -1,13 +1,13 @@
|
||||
---
|
||||
read_when:
|
||||
- Ви хочете запустити один хід агента зі скриптів (за потреби доставити відповідь)
|
||||
- Ви хочете виконати один хід агента зі скриптів (за потреби доставити відповідь)
|
||||
summary: Довідка CLI для `openclaw agent` (надіслати один хід агента через Gateway)
|
||||
title: Агент
|
||||
x-i18n:
|
||||
generated_at: "2026-04-25T03:44:18Z"
|
||||
generated_at: "2026-04-25T08:04:05Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 292559e27907fff3cdeb3b4127e19638934fbb4af50fc5165f9559da62a6b11b
|
||||
source_hash: e06681ffbed56cb5be05c7758141e784eac8307ed3c6fc973f71534238b407e1
|
||||
source_path: cli/agent.md
|
||||
workflow: 15
|
||||
---
|
||||
@ -15,7 +15,7 @@ x-i18n:
|
||||
# `openclaw agent`
|
||||
|
||||
Запустіть хід агента через Gateway (використовуйте `--local` для вбудованого режиму).
|
||||
Використовуйте `--agent <id>`, щоб напряму націлитися на налаштованого агента.
|
||||
Використовуйте `--agent <id>`, щоб безпосередньо звернутися до налаштованого агента.
|
||||
|
||||
Передайте принаймні один селектор сесії:
|
||||
|
||||
@ -23,24 +23,24 @@ x-i18n:
|
||||
- `--session-id <id>`
|
||||
- `--agent <id>`
|
||||
|
||||
Пов’язане:
|
||||
Пов’язано:
|
||||
|
||||
- Інструмент надсилання агента: [Agent send](/uk/tools/agent-send)
|
||||
|
||||
## Параметри
|
||||
|
||||
- `-m, --message <text>`: обов’язковий текст повідомлення
|
||||
- `-m, --message <text>`: обов’язкове тіло повідомлення
|
||||
- `-t, --to <dest>`: одержувач, який використовується для визначення ключа сесії
|
||||
- `--session-id <id>`: явний ідентифікатор сесії
|
||||
- `--agent <id>`: ідентифікатор агента; перевизначає прив’язки маршрутизації
|
||||
- `--thinking <level>`: рівень мислення агента (`off`, `minimal`, `low`, `medium`, `high`, а також підтримувані провайдером власні рівні, як-от `xhigh`, `adaptive` або `max`)
|
||||
- `--verbose <on|off>`: зберегти рівень деталізації для сесії
|
||||
- `--thinking <level>`: рівень мислення агента (`off`, `minimal`, `low`, `medium`, `high`, а також підтримувані провайдером користувацькі рівні, такі як `xhigh`, `adaptive` або `max`)
|
||||
- `--verbose <on|off>`: зберегти рівень докладності для сесії
|
||||
- `--channel <channel>`: канал доставки; не вказуйте, щоб використовувати основний канал сесії
|
||||
- `--reply-to <target>`: перевизначення цілі доставки
|
||||
- `--reply-channel <channel>`: перевизначення каналу доставки
|
||||
- `--reply-account <id>`: перевизначення облікового запису доставки
|
||||
- `--local`: запустити вбудованого агента напряму (після попереднього завантаження реєстру Plugin)
|
||||
- `--deliver`: надіслати відповідь назад у вибраний канал/ціль
|
||||
- `--local`: запускати вбудованого агента безпосередньо (після попереднього завантаження реєстру плагінів)
|
||||
- `--deliver`: надіслати відповідь назад до вибраного каналу/цілі
|
||||
- `--timeout <seconds>`: перевизначити тайм-аут агента (типово 600 або значення з конфігурації)
|
||||
- `--json`: вивести JSON
|
||||
|
||||
@ -57,14 +57,15 @@ openclaw agent --agent ops --message "Run locally" --local
|
||||
|
||||
## Примітки
|
||||
|
||||
- Режим Gateway повертається до вбудованого агента, якщо запит до Gateway завершується помилкою. Використовуйте `--local`, щоб примусово ввімкнути вбудоване виконання одразу.
|
||||
- `--local` однаково спочатку попередньо завантажує реєстр Plugin, тому провайдери, інструменти та канали, надані Plugin, залишаються доступними під час вбудованих запусків.
|
||||
- Режим Gateway повертається до вбудованого агента, якщо запит до Gateway завершується помилкою. Використовуйте `--local`, щоб одразу примусово виконувати у вбудованому режимі.
|
||||
- `--local` усе одно спочатку попередньо завантажує реєстр плагінів, тому провайдери, інструменти й канали, надані плагінами, залишаються доступними під час вбудованих запусків.
|
||||
- Кожен виклик `openclaw agent` розглядається як одноразовий запуск. Вбудовані або налаштовані користувачем MCP-сервери, відкриті для цього запуску, завершуються після відповіді, навіть якщо команда використовує шлях через Gateway, тому дочірні stdio MCP-процеси не залишаються активними між викликами зі скриптів.
|
||||
- `--channel`, `--reply-channel` і `--reply-account` впливають на доставку відповіді, а не на маршрутизацію сесії.
|
||||
- `--json` зберігає stdout зарезервованим для JSON-відповіді. Діагностика Gateway, Plugin і вбудованого резервного режиму спрямовується до stderr, щоб скрипти могли напряму розбирати stdout.
|
||||
- Коли ця команда запускає регенерацію `models.json`, облікові дані провайдера, керовані SecretRef, зберігаються як несекретні маркери (наприклад, назви змінних середовища, `secretref-env:ENV_VAR_NAME` або `secretref-managed`), а не як розкритий відкритий текст секретів.
|
||||
- Записи маркерів є авторитетними від джерела: OpenClaw зберігає маркери з активного знімка конфігурації джерела, а не з розв’язаних значень секретів під час виконання.
|
||||
- `--json` зберігає stdout зарезервованим для JSON-відповіді. Діагностичні повідомлення Gateway, Plugin і вбудованого резервного режиму спрямовуються в stderr, щоб скрипти могли безпосередньо аналізувати stdout.
|
||||
- Коли ця команда запускає повторне створення `models.json`, облікові дані провайдерів, якими керує SecretRef, зберігаються як несекретні маркери (наприклад, назви змінних середовища, `secretref-env:ENV_VAR_NAME` або `secretref-managed`), а не як розкритий секретний відкритий текст.
|
||||
- Записи маркерів є авторитетними з боку джерела: OpenClaw зберігає маркери з активного знімка конфігурації джерела, а не з розв’язаних значень секретів під час виконання.
|
||||
|
||||
## Пов’язане
|
||||
## Пов’язано
|
||||
|
||||
- [Довідка CLI](/uk/cli)
|
||||
- [Середовище виконання агента](/uk/concepts/agent)
|
||||
|
||||
298
docs/uk/cli/crestodian.md
Normal file
298
docs/uk/cli/crestodian.md
Normal file
@ -0,0 +1,298 @@
|
||||
---
|
||||
read_when:
|
||||
- Ви запускаєте openclaw без команди й хочете зрозуміти, що таке Crestodian
|
||||
- Вам потрібен безконфігураційно-безпечний спосіб перевірити або відновити OpenClaw
|
||||
- Ви проєктуєте або вмикаєте режим відновлення каналу повідомлень
|
||||
summary: Довідка CLI та модель безпеки для Crestodian, безконфігураційно-безпечного помічника з налаштування та відновлення
|
||||
title: Crestodian
|
||||
x-i18n:
|
||||
generated_at: "2026-04-25T08:04:09Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 22ec3afe4e184523ea2211e48d5ccf0a5bd9f01d62b752c0229de6874fef8c7d
|
||||
source_path: cli/crestodian.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# `openclaw crestodian`
|
||||
|
||||
Crestodian — це локальний помічник OpenClaw для налаштування, відновлення та конфігурації. Його
|
||||
розроблено так, щоб він залишався доступним, коли звичайний шлях агента зламаний.
|
||||
|
||||
Запуск `openclaw` без команди запускає Crestodian в інтерактивному терміналі.
|
||||
Запуск `openclaw crestodian` явно запускає того самого помічника.
|
||||
|
||||
## Що показує Crestodian
|
||||
|
||||
Під час запуску Crestodian виводить стислий огляд системи:
|
||||
|
||||
- шлях до конфігурації та її коректність
|
||||
- налаштовані агенти й агент за замовчуванням
|
||||
- модель за замовчуванням
|
||||
- доступність локальних CLI Codex і Claude Code
|
||||
- наявність API-ключів OpenAI та Anthropic
|
||||
- режим планувальника (`deterministic` або з підтримкою моделі через налаштовану модель)
|
||||
- шлях до локальної документації або URL публічної документації
|
||||
- шлях до локального вихідного коду для Git checkout, інакше URL вихідного коду OpenClaw на GitHub
|
||||
- доступність Gateway
|
||||
- безпосередньо рекомендований наступний крок
|
||||
|
||||
Він не виводить секрети й не завантажує команди CLI Plugin лише для запуску.
|
||||
|
||||
Crestodian використовує те саме виявлення довідкових матеріалів OpenClaw, що й звичайні агенти. У Git checkout
|
||||
він спрямовує себе на локальний `docs/` і локальне дерево вихідного коду. У встановленні з npm-пакета він
|
||||
використовує вбудовану документацію пакета та посилається на
|
||||
[https://github.com/openclaw/openclaw](https://github.com/openclaw/openclaw), з явною
|
||||
рекомендацією переглядати вихідний код, коли документації недостатньо.
|
||||
|
||||
## Приклади
|
||||
|
||||
```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
|
||||
```
|
||||
|
||||
Усередині інтерактивного запиту:
|
||||
|
||||
```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`
|
||||
- запустити bootstrap налаштування/onboarding
|
||||
- змінити модель за замовчуванням
|
||||
- запустити, зупинити або перезапустити 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`
|
||||
- CLI Claude Code -> `claude-cli/claude-opus-4-7`
|
||||
- CLI Codex -> `codex-cli/gpt-5.5`
|
||||
|
||||
Якщо жоден із них недоступний, setup усе одно записує робочий простір за замовчуванням і залишає
|
||||
модель не встановленою. Установіть або виконайте вхід у Codex/Claude Code, або задайте
|
||||
`OPENAI_API_KEY`/`ANTHROPIC_API_KEY`, а потім знову запустіть setup.
|
||||
|
||||
## Планувальник із підтримкою моделі
|
||||
|
||||
Crestodian завжди запускається в режимі deterministic. Щойно налаштовано коректну модель OpenClaw,
|
||||
локальний Crestodian може зробити один обмежений виклик моделі для нечітких команд,
|
||||
які deterministic-парсер не розуміє.
|
||||
|
||||
Планувальник із підтримкою моделі не може безпосередньо змінювати конфігурацію. Він має перетворити
|
||||
запит на одну з типізованих команд Crestodian, після чого застосовуються звичайні правила схвалення
|
||||
й аудиту. Перш ніж щось виконувати, Crestodian виводить використану модель і інтерпретовану
|
||||
команду.
|
||||
|
||||
Режим аварійного відновлення через канал повідомлень не використовує планувальник із підтримкою моделі. Віддалене
|
||||
відновлення залишається deterministic, щоб зламаний або скомпрометований звичайний шлях агента
|
||||
не можна було використати як редактор конфігурації.
|
||||
|
||||
## Перемикання на агента
|
||||
|
||||
Використовуйте селектор природною мовою, щоб вийти з 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, де середовище виконання вже має незасандбоксовані локальні повноваження.
|
||||
- Вимагати явної ідентичності власника. Відновлення не повинно приймати правила
|
||||
відправника з підстановками, відкриту політику груп, неавтентифіковані Webhook або
|
||||
анонімні канали.
|
||||
- За замовчуванням лише DM власника. Відновлення в групі/каналі вимагає явного opt-in і
|
||||
все одно має спрямовувати запити на схвалення до DM власника.
|
||||
- Віддалене відновлення не може відкривати локальний TUI або перемикатися в інтерактивний сеанс
|
||||
агента. Для передачі керування агенту використовуйте локальний `openclaw`.
|
||||
- Постійні записи, як і раніше, потребують схвалення, навіть у режимі відновлення.
|
||||
- Аудитуйте кожну застосовану операцію відновлення, включно з каналом, обліковим записом, відправником,
|
||||
ключем сеансу, операцією, хешем конфігурації до та хешем конфігурації після.
|
||||
- Ніколи не повторюйте секрети. Перевірка SecretRef має повідомляти про доступність, а не
|
||||
значення.
|
||||
- Якщо Gateway працює, віддавайте перевагу типізованим операціям Gateway. Якщо Gateway
|
||||
недоступний, використовуйте лише мінімальну локальну поверхню відновлення, яка не залежить
|
||||
від звичайного циклу агента.
|
||||
|
||||
Форма конфігурації:
|
||||
|
||||
```jsonc
|
||||
{
|
||||
"crestodian": {
|
||||
"rescue": {
|
||||
"enabled": "auto",
|
||||
"ownerDmOnly": true,
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
`enabled` має приймати:
|
||||
|
||||
- `"auto"`: значення за замовчуванням. Дозволяти лише тоді, коли ефективне середовище виконання — YOLO і
|
||||
sandboxing вимкнено.
|
||||
- `false`: ніколи не дозволяти відновлення через канал повідомлень.
|
||||
- `true`: явно дозволяти відновлення, коли перевірки власника/каналу пройдено. Це
|
||||
все одно не повинно обходити заборону sandboxing.
|
||||
|
||||
Поведінка YOLO за замовчуванням для `"auto"` така:
|
||||
|
||||
- режим sandbox має значення `off`
|
||||
- `tools.exec.security` має значення `full`
|
||||
- `tools.exec.ask` має значення `off`
|
||||
|
||||
Віддалене відновлення покривається Docker lane:
|
||||
|
||||
```bash
|
||||
pnpm test:docker:crestodian-rescue
|
||||
```
|
||||
|
||||
Свіже безконфігураційне налаштування через Crestodian покривається:
|
||||
|
||||
```bash
|
||||
pnpm test:docker:crestodian-first-run
|
||||
```
|
||||
|
||||
## Пов’язані матеріали
|
||||
|
||||
- [Довідка CLI](/uk/cli)
|
||||
- [Doctor](/uk/cli/doctor)
|
||||
- [TUI](/uk/cli/tui)
|
||||
- [Sandbox](/uk/cli/sandbox)
|
||||
- [Security](/uk/cli/security)
|
||||
@ -1,62 +1,62 @@
|
||||
---
|
||||
read_when:
|
||||
- Пошук правильної підкоманди `openclaw`
|
||||
- Пошук потрібної підкоманди `openclaw`
|
||||
- Пошук глобальних прапорців або правил оформлення виводу
|
||||
summary: 'Індекс CLI OpenClaw: список команд, глобальні прапорці та посилання на сторінки окремих команд'
|
||||
title: Довідник CLI
|
||||
x-i18n:
|
||||
generated_at: "2026-04-23T20:47:21Z"
|
||||
generated_at: "2026-04-25T08:04:07Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 9fec51767cf6c2a0abeb684f00877371dae3ac05ed864eff03a581976e90c1ce
|
||||
source_hash: b8a61396b8ec7f57d15988d40b09f90458745bbb29e90bd387134aa032214853
|
||||
source_path: cli/index.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
`openclaw` — це основна точка входу CLI. Кожна основна команда має або
|
||||
окрему довідкову сторінку, або документується разом із командою, для якої вона є псевдонімом; цей
|
||||
індекс містить список команд, глобальні прапорці та правила оформлення виводу,
|
||||
які застосовуються в усьому CLI.
|
||||
окрему довідкову сторінку, або документується разом із командою, для якої є псевдонімом; цей
|
||||
індекс містить команди, глобальні прапорці та правила оформлення виводу, які
|
||||
застосовуються в усьому CLI.
|
||||
|
||||
## Сторінки команд
|
||||
|
||||
| Розділ | Команди |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| Налаштування та онбординг | [`setup`](/uk/cli/setup) · [`onboard`](/uk/cli/onboard) · [`configure`](/uk/cli/configure) · [`config`](/uk/cli/config) · [`completion`](/uk/cli/completion) · [`doctor`](/uk/cli/doctor) · [`dashboard`](/uk/cli/dashboard) |
|
||||
| Скидання та видалення | [`backup`](/uk/cli/backup) · [`reset`](/uk/cli/reset) · [`uninstall`](/uk/cli/uninstall) · [`update`](/uk/cli/update) |
|
||||
| Обмін повідомленнями та агенти | [`message`](/uk/cli/message) · [`agent`](/uk/cli/agent) · [`agents`](/uk/cli/agents) · [`acp`](/uk/cli/acp) · [`mcp`](/uk/cli/mcp) |
|
||||
| Стан і сесії | [`status`](/uk/cli/status) · [`health`](/uk/cli/health) · [`sessions`](/uk/cli/sessions) |
|
||||
| Gateway і логи | [`gateway`](/uk/cli/gateway) · [`logs`](/uk/cli/logs) · [`system`](/uk/cli/system) |
|
||||
| Моделі та інференс | [`models`](/uk/cli/models) · [`infer`](/uk/cli/infer) · `capability` (псевдонім для [`infer`](/uk/cli/infer)) · [`memory`](/uk/cli/memory) · [`wiki`](/uk/cli/wiki) |
|
||||
| Мережа та Node | [`directory`](/uk/cli/directory) · [`nodes`](/uk/cli/nodes) · [`devices`](/uk/cli/devices) · [`node`](/uk/cli/node) |
|
||||
| Середовище виконання та sandbox | [`approvals`](/uk/cli/approvals) · `exec-policy` (див. [`approvals`](/uk/cli/approvals)) · [`sandbox`](/uk/cli/sandbox) · [`tui`](/uk/cli/tui) · `chat`/`terminal` (псевдоніми для [`tui --local`](/uk/cli/tui)) · [`browser`](/uk/cli/browser) |
|
||||
| Автоматизація | [`cron`](/uk/cli/cron) · [`tasks`](/uk/cli/tasks) · [`hooks`](/uk/cli/hooks) · [`webhooks`](/uk/cli/webhooks) |
|
||||
| Виявлення та документація | [`dns`](/uk/cli/dns) · [`docs`](/uk/cli/docs) |
|
||||
| Pairing і канали | [`pairing`](/uk/cli/pairing) · [`qr`](/uk/cli/qr) · [`channels`](/uk/cli/channels) |
|
||||
| Безпека та Plugin | [`security`](/uk/cli/security) · [`secrets`](/uk/cli/secrets) · [`skills`](/uk/cli/skills) · [`plugins`](/uk/cli/plugins) · [`proxy`](/uk/cli/proxy) |
|
||||
| Застарілі псевдоніми | [`daemon`](/uk/cli/daemon) (сервіс gateway) · [`clawbot`](/uk/cli/clawbot) (простір імен) |
|
||||
| Plugins (необов’язково) | [`voicecall`](/uk/cli/voicecall) (якщо встановлено) |
|
||||
| Розділ | Команди |
|
||||
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Налаштування та початок роботи | [`crestodian`](/uk/cli/crestodian) · [`setup`](/uk/cli/setup) · [`onboard`](/uk/cli/onboard) · [`configure`](/uk/cli/configure) · [`config`](/uk/cli/config) · [`completion`](/uk/cli/completion) · [`doctor`](/uk/cli/doctor) · [`dashboard`](/uk/cli/dashboard) |
|
||||
| Скидання та видалення | [`backup`](/uk/cli/backup) · [`reset`](/uk/cli/reset) · [`uninstall`](/uk/cli/uninstall) · [`update`](/uk/cli/update) |
|
||||
| Повідомлення й агенти | [`message`](/uk/cli/message) · [`agent`](/uk/cli/agent) · [`agents`](/uk/cli/agents) · [`acp`](/uk/cli/acp) · [`mcp`](/uk/cli/mcp) |
|
||||
| Стан і сеанси | [`status`](/uk/cli/status) · [`health`](/uk/cli/health) · [`sessions`](/uk/cli/sessions) |
|
||||
| Gateway і журнали | [`gateway`](/uk/cli/gateway) · [`logs`](/uk/cli/logs) · [`system`](/uk/cli/system) |
|
||||
| Моделі та інференс | [`models`](/uk/cli/models) · [`infer`](/uk/cli/infer) · `capability` (псевдонім для [`infer`](/uk/cli/infer)) · [`memory`](/uk/cli/memory) · [`wiki`](/uk/cli/wiki) |
|
||||
| Мережа та вузли | [`directory`](/uk/cli/directory) · [`nodes`](/uk/cli/nodes) · [`devices`](/uk/cli/devices) · [`node`](/uk/cli/node) |
|
||||
| Середовище виконання та sandbox | [`approvals`](/uk/cli/approvals) · `exec-policy` (див. [`approvals`](/uk/cli/approvals)) · [`sandbox`](/uk/cli/sandbox) · [`tui`](/uk/cli/tui) · `chat`/`terminal` (псевдоніми для [`tui --local`](/uk/cli/tui)) · [`browser`](/uk/cli/browser) |
|
||||
| Автоматизація | [`cron`](/uk/cli/cron) · [`tasks`](/uk/cli/tasks) · [`hooks`](/uk/cli/hooks) · [`webhooks`](/uk/cli/webhooks) |
|
||||
| Виявлення та документація | [`dns`](/uk/cli/dns) · [`docs`](/uk/cli/docs) |
|
||||
| Підключення та канали | [`pairing`](/uk/cli/pairing) · [`qr`](/uk/cli/qr) · [`channels`](/uk/cli/channels) |
|
||||
| Безпека та plugins | [`security`](/uk/cli/security) · [`secrets`](/uk/cli/secrets) · [`skills`](/uk/cli/skills) · [`plugins`](/uk/cli/plugins) · [`proxy`](/uk/cli/proxy) |
|
||||
| Застарілі псевдоніми | [`daemon`](/uk/cli/daemon) (сервіс gateway) · [`clawbot`](/uk/cli/clawbot) (простір імен) |
|
||||
| Plugins (необов’язкові) | [`voicecall`](/uk/cli/voicecall) (якщо встановлено) |
|
||||
|
||||
## Глобальні прапорці
|
||||
|
||||
| Прапорець | Призначення |
|
||||
| ----------------------- | --------------------------------------------------------------------- |
|
||||
| `--dev` | Ізолює стан у `~/.openclaw-dev` і змінює типові порти |
|
||||
| `--profile <name>` | Ізолює стан у `~/.openclaw-<name>` |
|
||||
| `--container <name>` | Націлює виконання на іменований контейнер |
|
||||
| `--no-color` | Вимикає кольори ANSI (`NO_COLOR=1` також підтримується) |
|
||||
| `--update` | Скорочення для [`openclaw update`](/uk/cli/update) (лише встановлення з source) |
|
||||
| `-V`, `--version`, `-v` | Виводить версію та завершує роботу |
|
||||
| Прапорець | Призначення |
|
||||
| ---------------------- | --------------------------------------------------------------------- |
|
||||
| `--dev` | Ізолює стан у `~/.openclaw-dev` і змінює типові порти |
|
||||
| `--profile <name>` | Ізолює стан у `~/.openclaw-<name>` |
|
||||
| `--container <name>` | Спрямовує виконання до іменованого контейнера |
|
||||
| `--no-color` | Вимикає кольори ANSI (`NO_COLOR=1` також підтримується) |
|
||||
| `--update` | Скорочення для [`openclaw update`](/uk/cli/update) (лише для встановлень із джерела) |
|
||||
| `-V`, `--version`, `-v` | Виводить версію та завершує роботу |
|
||||
|
||||
## Режими виводу
|
||||
|
||||
- Кольори ANSI та індикатори прогресу відображаються лише в TTY-сесіях.
|
||||
- OSC-8 hyperlink відображаються як клікабельні посилання там, де це підтримується; інакше
|
||||
CLI повертається до звичайних URL.
|
||||
- Кольори ANSI та індикатори прогресу відображаються лише в сеансах TTY.
|
||||
- Гіперпосилання OSC-8 відображаються як клікабельні посилання там, де це підтримується; інакше
|
||||
CLI повертається до звичайних URL-адрес.
|
||||
- `--json` (і `--plain`, де підтримується) вимикає стилізацію для чистого виводу.
|
||||
- Довготривалі команди показують індикатор прогресу (OSC 9;4, де підтримується).
|
||||
- Довготривалі команди показують індикатор прогресу (OSC 9;4, якщо підтримується).
|
||||
|
||||
Джерело істини палітри: `src/terminal/palette.ts`.
|
||||
Джерело істини для палітри: `src/terminal/palette.ts`.
|
||||
|
||||
## Дерево команд
|
||||
|
||||
@ -64,6 +64,7 @@ x-i18n:
|
||||
|
||||
```
|
||||
openclaw [--dev] [--profile <name>] <command>
|
||||
crestodian
|
||||
setup
|
||||
onboard
|
||||
configure
|
||||
@ -357,29 +358,29 @@ Plugins можуть додавати додаткові команди верх
|
||||
|
||||
</Accordion>
|
||||
|
||||
## Slash-команди чату
|
||||
## Слеш-команди чату
|
||||
|
||||
Повідомлення чату підтримують команди `/...`. Див. [slash commands](/uk/tools/slash-commands).
|
||||
Повідомлення чату підтримують команди `/...`. Див. [слеш-команди](/uk/tools/slash-commands).
|
||||
|
||||
Основне:
|
||||
|
||||
- `/status` — швидка діагностика.
|
||||
- `/trace` — рядки трасування/налагодження Plugin у межах сесії.
|
||||
- `/trace` — рядки трасування/налагодження plugin у межах сеансу.
|
||||
- `/config` — збережені зміни конфігурації.
|
||||
- `/debug` — перевизначення конфігурації лише для середовища виконання (пам’ять, не диск; потребує `commands.debug: true`).
|
||||
- `/debug` — перевизначення конфігурації лише для середовища виконання (пам’ять, не диск; потрібен `commands.debug: true`).
|
||||
|
||||
## Відстеження використання
|
||||
|
||||
`openclaw status --usage` і Control UI показують використання/квоту провайдера, коли
|
||||
доступні облікові дані OAuth/API. Дані надходять безпосередньо з endpoint використання провайдера
|
||||
та нормалізуються до `X% left`. Провайдери з поточними вікнами
|
||||
використання: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax,
|
||||
доступні облікові дані OAuth/API. Дані надходять безпосередньо з кінцевих точок використання провайдера
|
||||
і нормалізуються до `X% left`. Провайдери з поточними вікнами використання:
|
||||
Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax,
|
||||
Xiaomi і z.ai.
|
||||
|
||||
Докладніше див. у [Usage tracking](/uk/concepts/usage-tracking).
|
||||
Докладніше див. у [Відстеження використання](/uk/concepts/usage-tracking).
|
||||
|
||||
## Пов’язане
|
||||
|
||||
- [Slash commands](/uk/tools/slash-commands)
|
||||
- [Configuration](/uk/gateway/configuration)
|
||||
- [Environment](/uk/help/environment)
|
||||
- [Слеш-команди](/uk/tools/slash-commands)
|
||||
- [Конфігурація](/uk/gateway/configuration)
|
||||
- [Середовище](/uk/help/environment)
|
||||
|
||||
@ -2,35 +2,35 @@
|
||||
read_when:
|
||||
- Додавання або змінення команд `openclaw infer`
|
||||
- Проєктування стабільної автоматизації можливостей без графічного інтерфейсу
|
||||
summary: CLI з infer-first для робочих процесів із моделями, зображеннями, аудіо, TTS, відео, вебом та ембедингами на основі провайдера
|
||||
summary: CLI з пріоритетним визначенням для робочих процесів моделі, зображень, аудіо, TTS, відео, вебу та ембедингів із підтримкою провайдера
|
||||
title: CLI для inference
|
||||
x-i18n:
|
||||
generated_at: "2026-04-24T19:51:03Z"
|
||||
generated_at: "2026-04-25T08:04:06Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: b2127deec34c5cf8431035c6cc02fc4acb35e4a107f70de0c7654fe4806c0d43
|
||||
source_hash: 2bd8179425f47a991a4577607db93b51724ac10b90b438397de4394a279d4eb8
|
||||
source_path: cli/infer.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
`openclaw infer` — це канонічна headless-поверхня для робочих процесів inference на основі провайдера.
|
||||
`openclaw infer` — це канонічна безголова поверхня для робочих процесів inference із підтримкою провайдера.
|
||||
|
||||
Вона навмисно надає сімейства можливостей, а не сирі назви Gateway RPC і не сирі ідентифікатори інструментів агентів.
|
||||
Вона навмисно надає сімейства можливостей, а не сирі назви gateway RPC і не сирі ідентифікатори інструментів агента.
|
||||
|
||||
## Перетворіть infer на skill
|
||||
## Перетворення infer на skill
|
||||
|
||||
Скопіюйте й вставте це агенту:
|
||||
|
||||
```text
|
||||
Read https://docs.openclaw.ai/cli/infer, then create a skill that routes my common workflows to `openclaw infer`.
|
||||
Focus on model runs, image generation, video generation, audio transcription, TTS, web search, and embeddings.
|
||||
Прочитай https://docs.openclaw.ai/cli/infer, а потім створи skill, який спрямовує мої типові робочі процеси до `openclaw infer`.
|
||||
Зосередься на запусках моделей, генерації зображень, генерації відео, транскрибуванні аудіо, TTS, вебпошуку та ембедингах.
|
||||
```
|
||||
|
||||
Хороший skill на основі infer має:
|
||||
|
||||
- зіставляти поширені наміри користувача з правильним підкомандним викликом infer
|
||||
- зіставляти типові наміри користувача з правильним підкомандним рядком infer
|
||||
- містити кілька канонічних прикладів infer для робочих процесів, які він охоплює
|
||||
- надавати перевагу `openclaw infer ...` у прикладах і рекомендаціях
|
||||
- надавати перевагу `openclaw infer ...` у прикладах і пропозиціях
|
||||
- уникати повторного документування всієї поверхні infer всередині тіла skill
|
||||
|
||||
Типове охоплення skill, зосередженого на infer:
|
||||
@ -44,17 +44,17 @@ Focus on model runs, image generation, video generation, audio transcription, TT
|
||||
|
||||
## Навіщо використовувати infer
|
||||
|
||||
`openclaw infer` надає єдиний узгоджений CLI для завдань inference на основі провайдера всередині OpenClaw.
|
||||
`openclaw infer` надає єдиний узгоджений CLI для завдань inference із підтримкою провайдера в OpenClaw.
|
||||
|
||||
Переваги:
|
||||
|
||||
- Використовуйте провайдерів і моделі, уже налаштовані в OpenClaw, замість підключення одноразових обгорток для кожного бекенда.
|
||||
- Тримайте робочі процеси з моделями, зображеннями, транскрипцією аудіо, TTS, відео, вебом та ембедингами в межах одного дерева команд.
|
||||
- Використовуйте стабільну форму виводу `--json` для скриптів, автоматизації та робочих процесів, керованих агентами.
|
||||
- Надавайте перевагу першочерговій поверхні OpenClaw, коли завдання по суті полягає в тому, щоб «запустити inference».
|
||||
- Використовуйте звичайний локальний шлях без потреби в Gateway для більшості команд infer.
|
||||
- Використовуйте провайдери та моделі, уже налаштовані в OpenClaw, замість підключення окремих одноразових обгорток для кожного бекенда.
|
||||
- Тримайте робочі процеси моделей, зображень, транскрибування аудіо, TTS, відео, вебу та ембедингів в одному дереві команд.
|
||||
- Використовуйте стабільну форму виводу `--json` для скриптів, автоматизації та робочих процесів, керованих агентом.
|
||||
- Віддавайте перевагу власній поверхні OpenClaw, якщо завдання за своєю суттю полягає у «виконанні inference».
|
||||
- Використовуйте звичайний локальний шлях без потреби в gateway для більшості команд infer.
|
||||
|
||||
Для наскрізних перевірок провайдерів віддавайте перевагу `openclaw infer ...`, щойно пройдено тести провайдера нижчого рівня. Це перевіряє постачений CLI, завантаження конфігурації, визначення агента за замовчуванням, активацію вбудованих plugin, відновлення залежностей середовища виконання та спільне середовище виконання можливостей до того, як буде зроблено запит до провайдера.
|
||||
Для наскрізних перевірок провайдера віддавайте перевагу `openclaw infer ...`, коли тести провайдера нижчого рівня вже зелені. Це перевіряє постачуваний CLI, завантаження конфігурації, визначення агента за замовчуванням, активацію вбудованого Plugin, відновлення залежностей середовища виконання та спільне середовище виконання можливостей до того, як буде зроблено запит до провайдера.
|
||||
|
||||
## Дерево команд
|
||||
|
||||
@ -107,19 +107,19 @@ Focus on model runs, image generation, video generation, audio transcription, TT
|
||||
providers
|
||||
```
|
||||
|
||||
## Поширені завдання
|
||||
## Типові завдання
|
||||
|
||||
Ця таблиця зіставляє поширені завдання inference з відповідною командою infer.
|
||||
Ця таблиця зіставляє типові завдання inference з відповідною командою infer.
|
||||
|
||||
| Завдання | Команда | Примітки |
|
||||
| ----------------------- | ---------------------------------------------------------------------- | ----------------------------------------------------- |
|
||||
| Запустити текстовий/модельний запит | `openclaw infer model run --prompt "..." --json` | За замовчуванням використовує звичайний локальний шлях |
|
||||
| Згенерувати зображення | `openclaw infer image generate --prompt "..." --json` | Використовуйте `image edit`, якщо починаєте з наявного файла |
|
||||
| Описати файл зображення | `openclaw infer image describe --file ./image.png --json` | `--model` має бути зображувально-сумісним `<provider/model>` |
|
||||
| Транскрибувати аудіо | `openclaw infer audio transcribe --file ./memo.m4a --json` | `--model` має бути `<provider/model>` |
|
||||
| Синтезувати мовлення | `openclaw infer tts convert --text "..." --output ./speech.mp3 --json` | `tts status` орієнтований на Gateway |
|
||||
| Виконати текстовий запит/запит до моделі | `openclaw infer model run --prompt "..." --json` | За замовчуванням використовує звичайний локальний шлях |
|
||||
| Згенерувати зображення | `openclaw infer image generate --prompt "..." --json` | Використовуйте `image edit`, якщо починаєте з наявного файлу |
|
||||
| Описати файл зображення | `openclaw infer image describe --file ./image.png --json` | `--model` має бути зображувально-сумісною у форматі `<provider/model>` |
|
||||
| Транскрибувати аудіо | `openclaw infer audio transcribe --file ./memo.m4a --json` | `--model` має бути у форматі `<provider/model>` |
|
||||
| Синтезувати мовлення | `openclaw infer tts convert --text "..." --output ./speech.mp3 --json` | `tts status` орієнтований на gateway |
|
||||
| Згенерувати відео | `openclaw infer video generate --prompt "..." --json` | |
|
||||
| Описати відеофайл | `openclaw infer video describe --file ./clip.mp4 --json` | `--model` має бути `<provider/model>` |
|
||||
| Описати відеофайл | `openclaw infer video describe --file ./clip.mp4 --json` | `--model` має бути у форматі `<provider/model>` |
|
||||
| Шукати у вебі | `openclaw infer web search --query "..." --json` | |
|
||||
| Отримати вебсторінку | `openclaw infer web fetch --url https://example.com --json` | |
|
||||
| Створити ембединги | `openclaw infer embedding create --text "..." --json` | |
|
||||
@ -130,14 +130,15 @@ Focus on model runs, image generation, video generation, audio transcription, TT
|
||||
- Використовуйте `--json`, коли вивід споживатиметься іншою командою або скриптом.
|
||||
- Використовуйте `--provider` або `--model provider/model`, коли потрібен конкретний бекенд.
|
||||
- Для `image describe`, `audio transcribe` і `video describe` параметр `--model` має використовувати форму `<provider/model>`.
|
||||
- Для `image describe` явний `--model` запускає цей провайдер/модель безпосередньо. Модель має підтримувати зображення в каталозі моделей або конфігурації провайдера. `codex/<model>` запускає обмежений хід розуміння зображень Codex app-server; `openai-codex/<model>` використовує шлях провайдера OpenAI Codex OAuth.
|
||||
- Команди stateless-виконання за замовчуванням використовують локальний режим.
|
||||
- Команди стану, керованого Gateway, за замовчуванням використовують Gateway.
|
||||
- Звичайний локальний шлях не вимагає, щоб Gateway був запущений.
|
||||
- Для `image describe` явний `--model` напряму запускає цю пару провайдер/модель. Модель має підтримувати зображення в каталозі моделей або конфігурації провайдера. `codex/<model>` запускає обмежений turn розуміння зображень Codex app-server; `openai-codex/<model>` використовує шлях провайдера OpenAI Codex OAuth.
|
||||
- Команди безстанового виконання за замовчуванням локальні.
|
||||
- Команди стану, керованого gateway, за замовчуванням використовують gateway.
|
||||
- Звичайний локальний шлях не вимагає, щоб gateway був запущений.
|
||||
- `model run` — одноразовий запуск. MCP-сервери, відкриті через середовище виконання агента для цієї команди, завершуються після відповіді як для локального виконання, так і для `--gateway`, тому повторні скриптові виклики не залишають живими дочірні stdio MCP-процеси.
|
||||
|
||||
## Model
|
||||
|
||||
Використовуйте `model` для текстового inference на основі провайдера та перевірки моделей/провайдерів.
|
||||
Використовуйте `model` для текстового inference із підтримкою провайдера та перевірки моделі/провайдера.
|
||||
|
||||
```bash
|
||||
openclaw infer model run --prompt "Reply with exactly: smoke-ok" --json
|
||||
@ -148,7 +149,8 @@ openclaw infer model inspect --name gpt-5.5 --json
|
||||
|
||||
Примітки:
|
||||
|
||||
- `model run` повторно використовує runtime агента, тож перевизначення провайдера/моделі поводяться як під час звичайного виконання агента.
|
||||
- `model run` повторно використовує середовище виконання агента, тому перевизначення провайдера/моделі поводяться як у звичайному виконанні агента.
|
||||
- Оскільки `model run` призначений для безголової автоматизації, він не зберігає вбудовані MCP-середовища виконання на сесію після завершення команди.
|
||||
- `model auth login`, `model auth logout` і `model auth status` керують збереженим станом автентифікації провайдера.
|
||||
|
||||
## Image
|
||||
@ -166,8 +168,8 @@ openclaw infer image describe --file ./photo.jpg --model ollama/qwen2.5vl:7b --j
|
||||
Примітки:
|
||||
|
||||
- Використовуйте `image edit`, якщо починаєте з наявних вхідних файлів.
|
||||
- Використовуйте `image providers --json`, щоб перевірити, які вбудовані провайдери зображень можна виявити, які налаштовані, вибрані та які можливості генерації/редагування надає кожен провайдер.
|
||||
- Використовуйте `image generate --model <provider/model> --json` як найвужчу живу CLI-перевірку для змін генерації зображень. Приклад:
|
||||
- Використовуйте `image providers --json`, щоб перевірити, які вбудовані провайдери зображень можна виявити, налаштувати, вибрати та які можливості генерації/редагування надає кожен провайдер.
|
||||
- Використовуйте `image generate --model <provider/model> --json` як найвужчу живу CLI smoke-перевірку для змін генерації зображень. Приклад:
|
||||
|
||||
```bash
|
||||
openclaw infer image providers --json
|
||||
@ -178,14 +180,14 @@ openclaw infer image describe --file ./photo.jpg --model ollama/qwen2.5vl:7b --j
|
||||
--json
|
||||
```
|
||||
|
||||
JSON-відповідь повідомляє `ok`, `provider`, `model`, `attempts` і шляхи записаних файлів. Якщо задано `--output`, фінальне розширення може відповідати MIME-типу, повернутому провайдером.
|
||||
Відповідь JSON повідомляє `ok`, `provider`, `model`, `attempts` і записані шляхи виводу. Якщо задано `--output`, кінцеве розширення може відповідати MIME-типу, який повернув провайдер.
|
||||
|
||||
- Для `image describe` параметр `--model` має бути зображувально-сумісним `<provider/model>`.
|
||||
- Для локальних моделей Ollama з підтримкою візуального аналізу спочатку завантажте модель і встановіть `OLLAMA_API_KEY` у будь-яке значення-заповнювач, наприклад `ollama-local`. Див. [Ollama](/uk/providers/ollama#vision-and-image-description).
|
||||
- Для `image describe` параметр `--model` має бути зображувально-сумісною моделлю у форматі `<provider/model>`.
|
||||
- Для локальних моделей Ollama з підтримкою зору спочатку завантажте модель і встановіть `OLLAMA_API_KEY` у будь-яке заповнювальне значення, наприклад `ollama-local`. Див. [Ollama](/uk/providers/ollama#vision-and-image-description).
|
||||
|
||||
## Audio
|
||||
|
||||
Використовуйте `audio` для транскрипції файлів.
|
||||
Використовуйте `audio` для транскрибування файлів.
|
||||
|
||||
```bash
|
||||
openclaw infer audio transcribe --file ./memo.m4a --json
|
||||
@ -195,8 +197,8 @@ openclaw infer audio transcribe --file ./memo.m4a --model openai/whisper-1 --jso
|
||||
|
||||
Примітки:
|
||||
|
||||
- `audio transcribe` призначено для транскрипції файлів, а не для керування сесіями в реальному часі.
|
||||
- `--model` має бути `<provider/model>`.
|
||||
- `audio transcribe` призначений для транскрибування файлів, а не для керування сесіями в реальному часі.
|
||||
- `--model` має бути у форматі `<provider/model>`.
|
||||
|
||||
## TTS
|
||||
|
||||
@ -211,7 +213,7 @@ openclaw infer tts status --json
|
||||
|
||||
Примітки:
|
||||
|
||||
- `tts status` за замовчуванням використовує Gateway, оскільки відображає стан TTS, керований Gateway.
|
||||
- `tts status` за замовчуванням використовує gateway, оскільки відображає стан TTS, керований gateway.
|
||||
- Використовуйте `tts providers`, `tts voices` і `tts set-provider` для перевірки та налаштування поведінки TTS.
|
||||
|
||||
## Video
|
||||
@ -227,11 +229,11 @@ openclaw infer video describe --file ./clip.mp4 --model openai/gpt-4.1-mini --js
|
||||
|
||||
Примітки:
|
||||
|
||||
- Для `video describe` параметр `--model` має бути `<provider/model>`.
|
||||
- Для `video describe` параметр `--model` має бути у форматі `<provider/model>`.
|
||||
|
||||
## Web
|
||||
|
||||
Використовуйте `web` для робочих процесів пошуку та отримання.
|
||||
Використовуйте `web` для робочих процесів пошуку та отримання сторінок.
|
||||
|
||||
```bash
|
||||
openclaw infer web search --query "OpenClaw docs" --json
|
||||
@ -256,7 +258,7 @@ openclaw infer embedding providers --json
|
||||
|
||||
## Вивід JSON
|
||||
|
||||
Команди infer нормалізують вивід JSON у спільній оболонці:
|
||||
Команди infer нормалізують вивід JSON у спільний контейнер:
|
||||
|
||||
```json
|
||||
{
|
||||
@ -281,29 +283,29 @@ openclaw infer embedding providers --json
|
||||
- `outputs`
|
||||
- `error`
|
||||
|
||||
Для команд генерації медіа `outputs` містить файли, записані OpenClaw. Використовуйте `path`, `mimeType`, `size` і будь-які специфічні для медіа розміри в цьому масиві для автоматизації замість аналізу людиночитаного stdout.
|
||||
Для команд генерації медіа `outputs` містить файли, записані OpenClaw. Використовуйте `path`, `mimeType`, `size` і будь-які специфічні для медіа розміри в цьому масиві для автоматизації замість розбору людиночитного stdout.
|
||||
|
||||
## Поширені помилки
|
||||
## Типові помилки
|
||||
|
||||
```bash
|
||||
# Погано
|
||||
# Bad
|
||||
openclaw infer media image generate --prompt "friendly lobster"
|
||||
|
||||
# Добре
|
||||
# Good
|
||||
openclaw infer image generate --prompt "friendly lobster"
|
||||
```
|
||||
|
||||
```bash
|
||||
# Погано
|
||||
# Bad
|
||||
openclaw infer audio transcribe --file ./memo.m4a --model whisper-1 --json
|
||||
|
||||
# Добре
|
||||
# Good
|
||||
openclaw infer audio transcribe --file ./memo.m4a --model openai/whisper-1 --json
|
||||
```
|
||||
|
||||
## Примітки
|
||||
|
||||
- `openclaw capability ...` — це псевдонім для `openclaw infer ...`.
|
||||
- `openclaw capability ...` — псевдонім для `openclaw infer ...`.
|
||||
|
||||
## Пов’язане
|
||||
|
||||
|
||||
@ -3,28 +3,28 @@ read_when:
|
||||
- Підключення Codex, Claude Code або іншого клієнта MCP до каналів на базі OpenClaw
|
||||
- Запуск `openclaw mcp serve`
|
||||
- Керування збереженими в OpenClaw визначеннями серверів MCP
|
||||
summary: Відкрийте доступ до розмов каналів OpenClaw через MCP і керуйте збереженими визначеннями серверів MCP
|
||||
summary: Показувати розмови каналів OpenClaw через MCP і керувати збереженими визначеннями серверів MCP
|
||||
title: MCP
|
||||
x-i18n:
|
||||
generated_at: "2026-04-25T07:01:56Z"
|
||||
generated_at: "2026-04-25T08:04:05Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 43505ab290d01a2c3f7dd9ff39b8a074360ba4365b628da71459c6f9a9659dc5
|
||||
source_hash: ca2a76d1dbca71b4048659c21ac7ff98a01cc6095f6baad67df5347f45cd32e6
|
||||
source_path: cli/mcp.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
`openclaw mcp` має дві задачі:
|
||||
`openclaw mcp` має два завдання:
|
||||
|
||||
- запускати OpenClaw як сервер MCP за допомогою `openclaw mcp serve`
|
||||
- керувати визначеннями вихідних серверів MCP, якими володіє OpenClaw, за допомогою `list`, `show`,
|
||||
- керувати визначеннями вихідних серверів MCP, що належать OpenClaw, за допомогою `list`, `show`,
|
||||
`set` і `unset`
|
||||
|
||||
Іншими словами:
|
||||
Інакше кажучи:
|
||||
|
||||
- `serve` — це OpenClaw, що працює як сервер MCP
|
||||
- `list` / `show` / `set` / `unset` — це OpenClaw, що працює як реєстр на боці клієнта MCP
|
||||
для інших серверів MCP, які його середовища виконання можуть використати пізніше
|
||||
для інших серверів MCP, які його середовища виконання можуть використовувати пізніше
|
||||
|
||||
Використовуйте [`openclaw acp`](/uk/cli/acp), коли OpenClaw має сам розміщувати
|
||||
сеанс coding harness і маршрутизувати це середовище виконання через ACP.
|
||||
@ -37,20 +37,20 @@ x-i18n:
|
||||
|
||||
Використовуйте `openclaw mcp serve`, коли:
|
||||
|
||||
- Codex, Claude Code або інший клієнт MCP має напряму взаємодіяти з
|
||||
- Codex, Claude Code або інший клієнт MCP має безпосередньо взаємодіяти з
|
||||
розмовами каналів на базі OpenClaw
|
||||
- у вас уже є локальний або віддалений Gateway OpenClaw із маршрутизованими сеансами
|
||||
- вам потрібен один сервер MCP, який працює через серверні частини каналів OpenClaw,
|
||||
- вам потрібен один сервер MCP, який працює з бекендами каналів OpenClaw,
|
||||
замість запуску окремих мостів для кожного каналу
|
||||
|
||||
Натомість використовуйте [`openclaw acp`](/uk/cli/acp), коли OpenClaw має сам розміщувати
|
||||
середовище виконання coding і тримати сеанс агента всередині OpenClaw.
|
||||
Замість цього використовуйте [`openclaw acp`](/uk/cli/acp), коли OpenClaw має сам
|
||||
розміщувати середовище виконання coding і зберігати сеанс агента всередині OpenClaw.
|
||||
|
||||
## Як це працює
|
||||
|
||||
`openclaw mcp serve` запускає сервер MCP через stdio. Клієнт MCP володіє цим
|
||||
`openclaw mcp serve` запускає stdio-сервер MCP. Клієнт MCP керує цим
|
||||
процесом. Поки клієнт тримає сеанс stdio відкритим, міст підключається до
|
||||
локального або віддаленого Gateway OpenClaw через WebSocket і відкриває
|
||||
локального або віддаленого Gateway OpenClaw через WebSocket і показує
|
||||
маршрутизовані розмови каналів через MCP.
|
||||
|
||||
Життєвий цикл:
|
||||
@ -59,53 +59,58 @@ x-i18n:
|
||||
2. міст підключається до Gateway
|
||||
3. маршрутизовані сеанси стають розмовами MCP та інструментами transcript/history
|
||||
4. живі події ставляться в чергу в пам’яті, поки міст підключений
|
||||
5. якщо увімкнено режим каналу Claude, той самий сеанс також може отримувати
|
||||
5. якщо ввімкнено режим каналу Claude, той самий сеанс також може отримувати
|
||||
push-сповіщення, специфічні для Claude
|
||||
|
||||
Важлива поведінка:
|
||||
|
||||
- стан живої черги починається, коли міст підключається
|
||||
- старіша історія transcript читається через `messages_read`
|
||||
- старіша історія transcript зчитується через `messages_read`
|
||||
- push-сповіщення Claude існують лише поки активний сеанс MCP
|
||||
- коли клієнт від’єднується, міст завершує роботу, і жива черга зникає
|
||||
- сервери stdio MCP, запущені OpenClaw (вбудовані або налаштовані користувачем), завершуються
|
||||
як дерево процесів під час вимкнення, тому дочірні підпроцеси, запущені
|
||||
сервером, не виживають після завершення батьківського клієнта stdio
|
||||
- коли клієнт відключається, міст завершує роботу, а жива черга зникає
|
||||
- одноразові точки входу агента, такі як `openclaw agent` і
|
||||
`openclaw infer model run`, прибирають усі вбудовані середовища виконання MCP,
|
||||
які вони відкривають, коли відповідь завершується, тому повторні сценарні запуски
|
||||
не накопичують дочірні stdio-процеси MCP
|
||||
- stdio-сервери MCP, запущені OpenClaw (вбудовані або налаштовані користувачем),
|
||||
зупиняються як дерево процесів під час завершення роботи, тому дочірні
|
||||
підпроцеси, запущені сервером, не залишаються після завершення батьківського
|
||||
stdio-клієнта
|
||||
- видалення або скидання сеансу звільняє клієнтів MCP цього сеансу через
|
||||
спільний шлях очищення середовища виконання, тож не залишається завислих
|
||||
stdio-з’єднань, прив’язаних до вилученого сеансу
|
||||
спільний шлях очищення середовища виконання, тому не залишається завислих
|
||||
stdio-з’єднань, прив’язаних до видаленого сеансу
|
||||
|
||||
## Вибір режиму клієнта
|
||||
## Виберіть режим клієнта
|
||||
|
||||
Той самий міст можна використовувати двома різними способами:
|
||||
Використовуйте той самий міст двома різними способами:
|
||||
|
||||
- Звичайні клієнти MCP: лише стандартні інструменти MCP. Використовуйте `conversations_list`,
|
||||
- Загальні клієнти MCP: лише стандартні інструменти MCP. Використовуйте `conversations_list`,
|
||||
`messages_read`, `events_poll`, `events_wait`, `messages_send` та
|
||||
інструменти погодження.
|
||||
- Claude Code: стандартні інструменти MCP плюс адаптер каналу, специфічний для Claude.
|
||||
Увімкніть `--claude-channel-mode on` або залиште значення за замовчуванням `auto`.
|
||||
|
||||
Наразі `auto` поводиться так само, як `on`. Виявлення можливостей клієнта
|
||||
ще немає.
|
||||
Наразі `auto` поводиться так само, як `on`. Визначення можливостей клієнта
|
||||
ще не реалізовано.
|
||||
|
||||
## Що відкриває `serve`
|
||||
## Що показує `serve`
|
||||
|
||||
Міст використовує наявні метадані маршруту сеансу Gateway, щоб відкривати
|
||||
Міст використовує наявні метадані маршрутів сеансів Gateway, щоб показувати
|
||||
розмови, прив’язані до каналів. Розмова з’являється, коли OpenClaw уже має стан
|
||||
сеансу з відомим маршрутом, таким як:
|
||||
|
||||
- `channel`
|
||||
- метадані отримувача або призначення
|
||||
- метадані одержувача або призначення
|
||||
- необов’язковий `accountId`
|
||||
- необов’язковий `threadId`
|
||||
|
||||
Це дає клієнтам MCP єдине місце, де можна:
|
||||
|
||||
- переглядати список нещодавніх маршрутизованих розмов
|
||||
- читати недавню історію transcript
|
||||
- чекати нові вхідні події
|
||||
- перелічувати нещодавні маршрутизовані розмови
|
||||
- читати нещодавню історію transcript
|
||||
- очікувати нові вхідні події
|
||||
- надсилати відповідь назад тим самим маршрутом
|
||||
- бачити запити на погодження, які надходять, поки міст підключений
|
||||
- бачити запити на погодження, що надходять, поки міст підключений
|
||||
|
||||
## Використання
|
||||
|
||||
@ -116,19 +121,19 @@ openclaw mcp serve
|
||||
# Віддалений Gateway
|
||||
openclaw mcp serve --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token
|
||||
|
||||
# Віддалений Gateway з автентифікацією за паролем
|
||||
# Віддалений Gateway з автентифікацією паролем
|
||||
openclaw mcp serve --url wss://gateway-host:18789 --password-file ~/.openclaw/gateway.password
|
||||
|
||||
# Увімкнути докладні журнали мосту
|
||||
# Увімкнути докладні журнали моста
|
||||
openclaw mcp serve --verbose
|
||||
|
||||
# Вимкнути push-сповіщення, специфічні для Claude
|
||||
openclaw mcp serve --claude-channel-mode off
|
||||
```
|
||||
|
||||
## Інструменти мосту
|
||||
## Інструменти моста
|
||||
|
||||
Поточний міст відкриває такі інструменти MCP:
|
||||
Поточний міст показує такі інструменти MCP:
|
||||
|
||||
- `conversations_list`
|
||||
- `conversation_get`
|
||||
@ -142,8 +147,8 @@ openclaw mcp serve --claude-channel-mode off
|
||||
|
||||
### `conversations_list`
|
||||
|
||||
Показує список нещодавніх розмов, прив’язаних до сеансів, які вже мають
|
||||
метадані маршруту в стані сеансу Gateway.
|
||||
Перелічує нещодавні розмови на основі сеансів, які вже мають метадані маршруту
|
||||
в стані сеансу Gateway.
|
||||
|
||||
Корисні фільтри:
|
||||
|
||||
@ -159,44 +164,43 @@ openclaw mcp serve --claude-channel-mode off
|
||||
|
||||
### `messages_read`
|
||||
|
||||
Читає недавні повідомлення transcript для однієї розмови, прив’язаної до сеансу.
|
||||
Зчитує нещодавні повідомлення transcript для однієї розмови на основі сеансу.
|
||||
|
||||
### `attachments_fetch`
|
||||
|
||||
Витягує нетекстові блоки вмісту повідомлення з одного повідомлення transcript. Це
|
||||
подання метаданих поверх вмісту transcript, а не окреме стійке сховище
|
||||
вкладень blob.
|
||||
подання метаданих вмісту transcript, а не окреме довговічне сховище blob-вкладень.
|
||||
|
||||
### `events_poll`
|
||||
|
||||
Читає поставлені в чергу живі події від числового курсора.
|
||||
Зчитує поставлені в чергу живі події, починаючи з числового курсора.
|
||||
|
||||
### `events_wait`
|
||||
|
||||
Виконує long-polling, доки не надійде наступна відповідна поставлена в чергу
|
||||
подія або не спливе час очікування.
|
||||
Виконує довге опитування, доки не надійде наступна відповідна подія з черги
|
||||
або не спливе час очікування.
|
||||
|
||||
Використовуйте це, коли звичайному клієнту MCP потрібна доставка, близька до
|
||||
реального часу, без протоколу push, специфічного для Claude.
|
||||
Використовуйте це, коли загальному клієнту MCP потрібна доставка, близька до
|
||||
реального часу, без push-протоколу, специфічного для Claude.
|
||||
|
||||
### `messages_send`
|
||||
|
||||
Надсилає текст назад тим самим маршрутом, уже збереженим у сеансі.
|
||||
Надсилає текст назад тим самим маршрутом, який уже записано в сеансі.
|
||||
|
||||
Поточна поведінка:
|
||||
|
||||
- потребує наявного маршруту розмови
|
||||
- використовує канал сеансу, отримувача, id облікового запису та id треду
|
||||
- використовує канал сеансу, одержувача, id облікового запису та id гілки
|
||||
- надсилає лише текст
|
||||
|
||||
### `permissions_list_open`
|
||||
|
||||
Показує список очікуваних запитів на погодження exec/plugin, які міст спостерігав
|
||||
від моменту підключення до Gateway.
|
||||
Перелічує запити на погодження exec/plugin, які міст спостерігав відтоді, як
|
||||
підключився до Gateway.
|
||||
|
||||
### `permissions_respond`
|
||||
|
||||
Вирішує один очікуваний запит на погодження exec/plugin за допомогою:
|
||||
Обробляє один очікуваний запит на погодження exec/plugin за допомогою:
|
||||
|
||||
- `allow-once`
|
||||
- `allow-always`
|
||||
@ -204,7 +208,7 @@ openclaw mcp serve --claude-channel-mode off
|
||||
|
||||
## Модель подій
|
||||
|
||||
Міст тримає в пам’яті чергу подій, поки він підключений.
|
||||
Міст зберігає чергу подій у пам’яті, поки він підключений.
|
||||
|
||||
Поточні типи подій:
|
||||
|
||||
@ -217,41 +221,41 @@ openclaw mcp serve --claude-channel-mode off
|
||||
|
||||
Важливі обмеження:
|
||||
|
||||
- черга лише жива; вона починається, коли запускається міст MCP
|
||||
- черга є лише живою; вона починається, коли запускається міст MCP
|
||||
- `events_poll` і `events_wait` самі по собі не відтворюють старішу історію Gateway
|
||||
- стійкий backlog слід читати через `messages_read`
|
||||
- довговічний backlog слід читати через `messages_read`
|
||||
|
||||
## Сповіщення каналу Claude
|
||||
|
||||
Міст також може відкривати сповіщення каналу, специфічні для Claude. Це
|
||||
еквівалент OpenClaw для адаптера каналу Claude Code: стандартні інструменти MCP
|
||||
Міст також може показувати сповіщення каналу, специфічні для Claude. Це
|
||||
еквівалент адаптера каналу Claude Code в OpenClaw: стандартні інструменти MCP
|
||||
залишаються доступними, але живі вхідні повідомлення також можуть надходити як
|
||||
специфічні для Claude сповіщення MCP.
|
||||
MCP-сповіщення, специфічні для Claude.
|
||||
|
||||
Прапорці:
|
||||
|
||||
- `--claude-channel-mode off`: лише стандартні інструменти MCP
|
||||
- `--claude-channel-mode on`: увімкнути сповіщення каналу Claude
|
||||
- `--claude-channel-mode auto`: поточне значення за замовчуванням; така сама поведінка мосту, як у `on`
|
||||
- `--claude-channel-mode auto`: поточне значення за замовчуванням; така сама поведінка моста, як у `on`
|
||||
|
||||
Коли режим каналу Claude увімкнено, сервер оголошує експериментальні
|
||||
Коли ввімкнено режим каналу Claude, сервер оголошує експериментальні
|
||||
можливості Claude і може надсилати:
|
||||
|
||||
- `notifications/claude/channel`
|
||||
- `notifications/claude/channel/permission`
|
||||
|
||||
Поточна поведінка мосту:
|
||||
Поточна поведінка моста:
|
||||
|
||||
- вхідні повідомлення transcript типу `user` пересилаються як
|
||||
- вхідні повідомлення transcript від `user` пересилаються як
|
||||
`notifications/claude/channel`
|
||||
- запити на погодження Claude, отримані через MCP, відстежуються в пам’яті
|
||||
- якщо пізніше пов’язана розмова надішле `yes abcde` або `no abcde`, міст
|
||||
- якщо пов’язана розмова пізніше надсилає `yes abcde` або `no abcde`, міст
|
||||
перетворює це на `notifications/claude/channel/permission`
|
||||
- ці сповіщення доступні лише в межах живого сеансу; якщо клієнт MCP
|
||||
від’єднається, цілі для push більше не буде
|
||||
- ці сповіщення доступні лише в живому сеансі; якщо клієнт MCP відключається,
|
||||
цілі для push більше немає
|
||||
|
||||
Це навмисно орієнтовано на конкретного клієнта. Звичайні клієнти MCP повинні
|
||||
покладатися на стандартні інструменти опитування.
|
||||
Це навмисно клієнтоспецифічна поведінка. Загальні клієнти MCP мають покладатися
|
||||
на стандартні інструменти опитування.
|
||||
|
||||
## Конфігурація клієнта MCP
|
||||
|
||||
@ -275,9 +279,9 @@ openclaw mcp serve --claude-channel-mode off
|
||||
}
|
||||
```
|
||||
|
||||
Для більшості звичайних клієнтів MCP починайте зі стандартної поверхні
|
||||
інструментів та ігноруйте режим Claude. Увімкніть режим Claude лише для
|
||||
клієнтів, які справді розуміють методи сповіщень, специфічні для Claude.
|
||||
Для більшості загальних клієнтів MCP починайте зі стандартної поверхні
|
||||
інструментів і ігноруйте режим Claude. Вмикайте режим Claude лише для клієнтів,
|
||||
які справді розуміють методи сповіщень, специфічні для Claude.
|
||||
|
||||
## Параметри
|
||||
|
||||
@ -285,60 +289,61 @@ openclaw mcp serve --claude-channel-mode off
|
||||
|
||||
- `--url <url>`: URL WebSocket Gateway
|
||||
- `--token <token>`: токен Gateway
|
||||
- `--token-file <path>`: прочитати токен із файлу
|
||||
- `--token-file <path>`: прочитати токен із файла
|
||||
- `--password <password>`: пароль Gateway
|
||||
- `--password-file <path>`: прочитати пароль із файлу
|
||||
- `--password-file <path>`: прочитати пароль із файла
|
||||
- `--claude-channel-mode <auto|on|off>`: режим сповіщень Claude
|
||||
- `-v`, `--verbose`: докладні журнали в stderr
|
||||
|
||||
За можливості віддавайте перевагу `--token-file` або `--password-file` замість
|
||||
За можливості надавайте перевагу `--token-file` або `--password-file` замість
|
||||
вбудованих секретів.
|
||||
|
||||
## Межа безпеки й довіри
|
||||
## Безпека та межа довіри
|
||||
|
||||
Міст не вигадує маршрутизацію. Він лише відкриває розмови, які Gateway уже
|
||||
вміє маршрутизувати.
|
||||
Міст не вигадує маршрутизацію. Він лише показує розмови, які Gateway уже вміє
|
||||
маршрутизувати.
|
||||
|
||||
Це означає:
|
||||
|
||||
- allowlist відправників, pairing і довіра на рівні каналу все ще належать
|
||||
до базової конфігурації каналу OpenClaw
|
||||
- списки дозволених відправників, спарювання та довіра на рівні каналу все ще
|
||||
належать базовій конфігурації каналу OpenClaw
|
||||
- `messages_send` може відповідати лише через наявний збережений маршрут
|
||||
- стан погодження є лише живим/в пам’яті для поточного сеансу мосту
|
||||
- автентифікація мосту має використовувати ті самі елементи контролю токена або пароля Gateway,
|
||||
яким ви б довіряли для будь-якого іншого віддаленого клієнта Gateway
|
||||
- стан погодження є лише живим/у пам’яті для поточного сеансу моста
|
||||
- автентифікація моста має використовувати ті самі механізми контролю токена
|
||||
або пароля Gateway, яким ви б довірили будь-який інший віддалений клієнт Gateway
|
||||
|
||||
Якщо розмова відсутня в `conversations_list`, типовою причиною є не
|
||||
конфігурація MCP. Це відсутні або неповні метадані маршруту в базовому сеансі Gateway.
|
||||
Якщо розмова відсутня в `conversations_list`, звичайна причина полягає не в
|
||||
конфігурації MCP. Причина — відсутні або неповні метадані маршруту в базовому
|
||||
сеансі Gateway.
|
||||
|
||||
## Тестування
|
||||
|
||||
OpenClaw постачається з детермінованим Docker smoke-тестом для цього мосту:
|
||||
OpenClaw постачається з детермінованою Docker smoke-перевіркою для цього моста:
|
||||
|
||||
```bash
|
||||
pnpm test:docker:mcp-channels
|
||||
```
|
||||
|
||||
Цей smoke-тест:
|
||||
Ця smoke-перевірка:
|
||||
|
||||
- запускає контейнер Gateway із попередньо підготовленими даними
|
||||
- запускає другий контейнер, який викликає `openclaw mcp serve`
|
||||
- запускає контейнер Gateway із початковими даними
|
||||
- запускає другий контейнер, який запускає `openclaw mcp serve`
|
||||
- перевіряє виявлення розмов, читання transcript, читання метаданих вкладень,
|
||||
поведінку черги живих подій і маршрутизацію вихідних надсилань
|
||||
- перевіряє сповіщення каналів і погоджень у стилі Claude через реальний
|
||||
міст stdio MCP
|
||||
поведінку черги живих подій і маршрутизацію вихідного надсилання
|
||||
- перевіряє сповіщення у стилі Claude для каналів і дозволів через реальний
|
||||
stdio-міст MCP
|
||||
|
||||
Це найшвидший спосіб довести, що міст працює, без підключення реального
|
||||
облікового запису Telegram, Discord або iMessage до тестового запуску.
|
||||
Це найшвидший спосіб довести, що міст працює, не підключаючи реальний
|
||||
обліковий запис Telegram, Discord або iMessage до тестового запуску.
|
||||
|
||||
Для ширшого контексту тестування дивіться [Testing](/uk/help/testing).
|
||||
Для ширшого контексту тестування див. [Testing](/uk/help/testing).
|
||||
|
||||
## Усунення проблем
|
||||
## Усунення несправностей
|
||||
|
||||
### Не повертаються жодні розмови
|
||||
### Не повертаються розмови
|
||||
|
||||
Зазвичай це означає, що сеанс Gateway ще не придатний для маршрутизації.
|
||||
Підтвердьте, що базовий сеанс має збережені channel/provider, отримувача та
|
||||
Підтвердьте, що базовий сеанс має збережені channel/provider, recipient і
|
||||
необов’язкові метадані маршруту account/thread.
|
||||
|
||||
### `events_poll` або `events_wait` пропускає старіші повідомлення
|
||||
@ -348,49 +353,50 @@ pnpm test:docker:mcp-channels
|
||||
|
||||
### Сповіщення Claude не з’являються
|
||||
|
||||
Перевірте все з цього списку:
|
||||
Перевірте все з наведеного:
|
||||
|
||||
- клієнт тримав сеанс stdio MCP відкритим
|
||||
- клієнт тримав stdio-сеанс MCP відкритим
|
||||
- `--claude-channel-mode` має значення `on` або `auto`
|
||||
- клієнт справді розуміє методи сповіщень, специфічні для Claude
|
||||
- вхідне повідомлення сталося після підключення мосту
|
||||
- вхідне повідомлення надійшло після підключення моста
|
||||
|
||||
### Відсутні погодження
|
||||
|
||||
`permissions_list_open` показує лише запити на погодження, спостережені, поки
|
||||
міст був підключений. Це не API стійкої історії погоджень.
|
||||
`permissions_list_open` показує лише запити на погодження, помічені, поки міст
|
||||
був підключений. Це не API довговічної історії погоджень.
|
||||
|
||||
## OpenClaw як реєстр клієнтів MCP
|
||||
|
||||
Це шлях `openclaw mcp list`, `show`, `set` і `unset`.
|
||||
|
||||
Ці команди не відкривають OpenClaw через MCP. Вони керують визначеннями серверів MCP,
|
||||
якими володіє OpenClaw, у `mcp.servers` у конфігурації OpenClaw.
|
||||
Ці команди не показують OpenClaw через MCP. Вони керують визначеннями серверів
|
||||
MCP, що належать OpenClaw, у `mcp.servers` у конфігурації OpenClaw.
|
||||
|
||||
Ці збережені визначення призначені для середовищ виконання, які OpenClaw
|
||||
запускає або налаштовує пізніше, наприклад вбудований Pi та інші адаптери
|
||||
середовища виконання. OpenClaw зберігає визначення централізовано, щоб цим
|
||||
середовищам не потрібно було підтримувати власні дубльовані списки серверів MCP.
|
||||
запускає або налаштовує пізніше, наприклад для вбудованого Pi та інших
|
||||
адаптерів середовища виконання. OpenClaw централізовано зберігає визначення,
|
||||
щоб цим середовищам виконання не потрібно було підтримувати власні дубльовані
|
||||
списки серверів MCP.
|
||||
|
||||
Важлива поведінка:
|
||||
|
||||
- ці команди лише читають або записують конфігурацію OpenClaw
|
||||
- вони не підключаються до цільового сервера MCP
|
||||
- вони не перевіряють, чи команда, URL або віддалений транспорт
|
||||
доступні прямо зараз
|
||||
- адаптери середовища виконання самі вирішують, які форми транспорту вони
|
||||
фактично підтримують під час виконання
|
||||
- вбудований Pi відкриває налаштовані інструменти MCP у звичайних профілях
|
||||
- вони не перевіряють, чи команда, URL або віддалений транспорт зараз
|
||||
доступні
|
||||
- адаптери середовища виконання вирішують під час виконання, які форми
|
||||
транспорту вони фактично підтримують
|
||||
- вбудований Pi показує налаштовані інструменти MCP у звичайних профілях
|
||||
інструментів `coding` і `messaging`; `minimal` усе ще приховує їх, а
|
||||
`tools.deny: ["bundle-mcp"]` явно вимикає їх
|
||||
- вбудовані середовища виконання MCP, прив’язані до сеансу, прибираються після
|
||||
`mcp.sessionIdleTtlMs` мілісекунд простою (типово 10 хвилин; встановіть `0`,
|
||||
`tools.deny: ["bundle-mcp"]` вимикає їх явно
|
||||
- вбудовані середовища виконання MCP з областю дії сеансу прибираються після
|
||||
`mcp.sessionIdleTtlMs` мілісекунд неактивності (типово 10 хвилин; встановіть `0`,
|
||||
щоб вимкнути), а одноразові вбудовані запуски очищають їх наприкінці виконання
|
||||
|
||||
## Збережені визначення серверів MCP
|
||||
|
||||
OpenClaw також зберігає в конфігурації легковажний реєстр серверів MCP для
|
||||
поверхонь, яким потрібні визначення MCP, керовані OpenClaw.
|
||||
OpenClaw також зберігає в конфігурації легкий реєстр серверів MCP для
|
||||
поверхонь, які хочуть мати визначення MCP під керуванням OpenClaw.
|
||||
|
||||
Команди:
|
||||
|
||||
@ -401,10 +407,10 @@ OpenClaw також зберігає в конфігурації легкова
|
||||
|
||||
Примітки:
|
||||
|
||||
- `list` сортує імена серверів.
|
||||
- `show` без імені виводить повний налаштований об’єкт сервера MCP.
|
||||
- `list` сортує назви серверів.
|
||||
- `show` без назви виводить повний налаштований об’єкт сервера MCP.
|
||||
- `set` очікує одне значення JSON-об’єкта в командному рядку.
|
||||
- `unset` завершується помилкою, якщо сервера з вказаним іменем не існує.
|
||||
- `unset` завершується помилкою, якщо іменований сервер не існує.
|
||||
|
||||
Приклади:
|
||||
|
||||
@ -436,29 +442,29 @@ openclaw mcp unset context7
|
||||
|
||||
### Транспорт Stdio
|
||||
|
||||
Запускає локальний дочірній процес і спілкується через stdin/stdout.
|
||||
Запускає локальний дочірній процес і взаємодіє через stdin/stdout.
|
||||
|
||||
| Поле | Опис |
|
||||
| -------------------------- | ----------------------------------- |
|
||||
| Field | Description |
|
||||
| -------------------------- | ------------------------------------- |
|
||||
| `command` | Виконуваний файл для запуску (обов’язково) |
|
||||
| `args` | Масив аргументів командного рядка |
|
||||
| `env` | Додаткові змінні середовища |
|
||||
| `cwd` / `workingDirectory` | Робочий каталог для процесу |
|
||||
| `args` | Масив аргументів командного рядка |
|
||||
| `env` | Додаткові змінні середовища |
|
||||
| `cwd` / `workingDirectory` | Робочий каталог для процесу |
|
||||
|
||||
#### Фільтр безпеки env для Stdio
|
||||
|
||||
OpenClaw відхиляє ключі env запуску інтерпретатора, які можуть змінити спосіб запуску сервера stdio MCP до першого RPC, навіть якщо вони присутні в блоці `env` сервера. Заблоковані ключі включають `NODE_OPTIONS`, `PYTHONSTARTUP`, `PYTHONPATH`, `PERL5OPT`, `RUBYOPT`, `SHELLOPTS`, `PS4` та подібні змінні керування середовищем виконання. Запуск відхиляє їх з помилкою конфігурації, щоб вони не могли впровадити неявний пролог, підмінити інтерпретатор або ввімкнути налагоджувач для процесу stdio. Звичайні змінні середовища для облікових даних, proxy та специфічні для сервера (`GITHUB_TOKEN`, `HTTP_PROXY`, власні `*_API_KEY` тощо) не зачіпаються.
|
||||
OpenClaw відхиляє ключі env запуску інтерпретатора, які можуть змінити спосіб запуску stdio-сервера MCP до першого RPC, навіть якщо вони з’являються в блоці `env` сервера. Заблоковані ключі включають `NODE_OPTIONS`, `PYTHONSTARTUP`, `PYTHONPATH`, `PERL5OPT`, `RUBYOPT`, `SHELLOPTS`, `PS4` та подібні змінні керування середовищем виконання. Запуск відхиляє їх із помилкою конфігурації, щоб вони не могли впровадити неявний prelude, підмінити інтерпретатор або ввімкнути налагоджувач для stdio-процесу. Звичайні облікові дані, проксі та змінні env, специфічні для сервера (`GITHUB_TOKEN`, `HTTP_PROXY`, власні `*_API_KEY` тощо), не зачіпаються.
|
||||
|
||||
Якщо вашому серверу MCP справді потрібна одна із заблокованих змінних, задайте її в процесі хоста Gateway, а не в `env` сервера stdio.
|
||||
Якщо вашому серверу MCP справді потрібна одна із заблокованих змінних, задайте її в процесі хоста Gateway, а не в `env` stdio-сервера.
|
||||
|
||||
### Транспорт SSE / HTTP
|
||||
|
||||
Підключається до віддаленого сервера MCP через HTTP Server-Sent Events.
|
||||
|
||||
| Поле | Опис |
|
||||
| Field | Description |
|
||||
| --------------------- | ---------------------------------------------------------------- |
|
||||
| `url` | URL HTTP або HTTPS віддаленого сервера (обов’язково) |
|
||||
| `headers` | Необов’язкова карта HTTP-заголовків ключ-значення (наприклад, токени автентифікації) |
|
||||
| `headers` | Необов’язкове відображення ключ-значення HTTP-заголовків (наприклад, токенів автентифікації) |
|
||||
| `connectionTimeoutMs` | Тайм-аут підключення для сервера в мс (необов’язково) |
|
||||
|
||||
Приклад:
|
||||
@ -478,19 +484,19 @@ OpenClaw відхиляє ключі env запуску інтерпретато
|
||||
}
|
||||
```
|
||||
|
||||
Чутливі значення в `url` (userinfo) і `headers` маскуються в журналах та
|
||||
виводі стану.
|
||||
Чутливі значення в `url` (userinfo) і `headers` маскуються в журналах і
|
||||
виведенні статусу.
|
||||
|
||||
### Транспорт Streamable HTTP
|
||||
|
||||
`streamable-http` — це додатковий варіант транспорту поряд із `sse` і `stdio`. Він використовує потоковий HTTP для двостороннього зв’язку з віддаленими серверами MCP.
|
||||
`streamable-http` — це додатковий варіант транспорту поряд із `sse` і `stdio`. Він використовує HTTP-streaming для двонаправленого зв’язку з віддаленими серверами MCP.
|
||||
|
||||
| Поле | Опис |
|
||||
| --------------------- | ------------------------------------------------------------------------------------ |
|
||||
| `url` | URL HTTP або HTTPS віддаленого сервера (обов’язково) |
|
||||
| `transport` | Встановіть `"streamable-http"`, щоб вибрати цей транспорт; якщо не вказано, OpenClaw використовує `sse` |
|
||||
| `headers` | Необов’язкова карта HTTP-заголовків ключ-значення (наприклад, токени автентифікації) |
|
||||
| `connectionTimeoutMs` | Тайм-аут підключення для сервера в мс (необов’язково) |
|
||||
| Field | Description |
|
||||
| --------------------- | -------------------------------------------------------------------------------------- |
|
||||
| `url` | URL HTTP або HTTPS віддаленого сервера (обов’язково) |
|
||||
| `transport` | Встановіть `"streamable-http"`, щоб вибрати цей транспорт; якщо його не вказано, OpenClaw використовує `sse` |
|
||||
| `headers` | Необов’язкове відображення ключ-значення HTTP-заголовків (наприклад, токенів автентифікації) |
|
||||
| `connectionTimeoutMs` | Тайм-аут підключення для сервера в мс (необов’язково) |
|
||||
|
||||
Приклад:
|
||||
|
||||
@ -511,24 +517,23 @@ OpenClaw відхиляє ключі env запуску інтерпретато
|
||||
}
|
||||
```
|
||||
|
||||
Ці команди керують лише збереженою конфігурацією. Вони не запускають міст
|
||||
каналу, не відкривають живий сеанс клієнта MCP і не доводять, що цільовий
|
||||
сервер доступний.
|
||||
Ці команди керують лише збереженою конфігурацією. Вони не запускають міст каналу,
|
||||
не відкривають живий сеанс клієнта MCP і не доводять, що цільовий сервер доступний.
|
||||
|
||||
## Поточні обмеження
|
||||
|
||||
Ця сторінка документує міст у тому вигляді, в якому він постачається сьогодні.
|
||||
Ця сторінка документує міст у поточному вигляді.
|
||||
|
||||
Поточні обмеження:
|
||||
|
||||
- виявлення розмов залежить від наявних метаданих маршруту сеансу Gateway
|
||||
- виявлення розмов залежить від наявних метаданих маршрутів сеансів Gateway
|
||||
- немає загального push-протоколу, окрім адаптера, специфічного для Claude
|
||||
- поки немає інструментів редагування повідомлень або react
|
||||
- інструментів редагування повідомлень або реакцій поки немає
|
||||
- транспорт HTTP/SSE/streamable-http підключається до одного віддаленого сервера; мультиплексованого upstream поки немає
|
||||
- `permissions_list_open` включає лише погодження, спостережені, поки міст був
|
||||
- `permissions_list_open` включає лише погодження, які спостерігалися, поки міст
|
||||
підключений
|
||||
|
||||
## Пов’язане
|
||||
|
||||
- [Довідка CLI](/uk/cli)
|
||||
- [Плагіни](/uk/cli/plugins)
|
||||
- [Довідник CLI](/uk/cli)
|
||||
- [Plugins](/uk/cli/plugins)
|
||||
|
||||
@ -1,45 +1,49 @@
|
||||
---
|
||||
read_when:
|
||||
- Ви хочете покрокове налаштування Gateway, робочого простору, автентифікації, каналів і Skills
|
||||
summary: Довідник CLI для `openclaw onboard` (інтерактивне налаштування)
|
||||
title: Налаштування
|
||||
- Ви хочете покрокове налаштування для Gateway, робочого простору, автентифікації, каналів і Skills
|
||||
summary: Довідник CLI для `openclaw onboard` (інтерактивне онбординг-налаштування)
|
||||
title: Онбординг
|
||||
x-i18n:
|
||||
generated_at: "2026-04-24T19:50:59Z"
|
||||
generated_at: "2026-04-25T08:04:11Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 2b09191f95ff6012c340976dbae1045d24b736a9e9e06fc4e15e1f15785f20f5
|
||||
source_hash: 234c308ea554195df1bd880bda7e30770e926af059740458d056e4a909aaeb07
|
||||
source_path: cli/onboard.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# `openclaw onboard`
|
||||
|
||||
Інтерактивне налаштування для локального або віддаленого налаштування Gateway.
|
||||
Інтерактивне онбординг-налаштування для локального або віддаленого налаштування Gateway.
|
||||
|
||||
## Пов’язані посібники
|
||||
|
||||
- Центр налаштування CLI: [Налаштування (CLI)](/uk/start/wizard)
|
||||
- Огляд налаштування: [Огляд налаштування](/uk/start/onboarding-overview)
|
||||
- Довідник налаштування CLI: [Довідник налаштування CLI](/uk/start/wizard-cli-reference)
|
||||
- Центр онбордингу CLI: [Онбординг (CLI)](/uk/start/wizard)
|
||||
- Огляд онбордингу: [Огляд онбордингу](/uk/start/onboarding-overview)
|
||||
- Довідник CLI для онбордингу: [Довідник із налаштування CLI](/uk/start/wizard-cli-reference)
|
||||
- Автоматизація CLI: [Автоматизація CLI](/uk/start/wizard-cli-automation)
|
||||
- Налаштування macOS: [Налаштування (застосунок macOS)](/uk/start/onboarding)
|
||||
- Онбординг macOS: [Онбординг (додаток macOS)](/uk/start/onboarding)
|
||||
|
||||
## Приклади
|
||||
|
||||
```bash
|
||||
openclaw onboard
|
||||
openclaw onboard --modern
|
||||
openclaw onboard --flow quickstart
|
||||
openclaw onboard --flow manual
|
||||
openclaw onboard --skip-bootstrap
|
||||
openclaw onboard --mode remote --remote-url wss://gateway-host:18789
|
||||
```
|
||||
|
||||
Для цілей приватної мережі з відкритим текстом `ws://` (лише для довірених мереж) встановіть
|
||||
`OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1` у середовищі процесу налаштування.
|
||||
Для цього клієнтського аварійного обходу транспортного рівня немає еквівалента
|
||||
`openclaw.json`.
|
||||
`--modern` запускає попередню версію розмовного онбордингу Crestodian. Без
|
||||
`--modern` `openclaw onboard` зберігає класичний сценарій онбордингу.
|
||||
|
||||
Некастомний провайдер у неінтерактивному режимі:
|
||||
Для plaintext-цілей `ws://` у приватній мережі (лише для довірених мереж) установіть
|
||||
`OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1` у середовищі процесу онбордингу.
|
||||
Еквівалента `openclaw.json` для цього аварійного клієнтського
|
||||
обхідного механізму транспорту немає.
|
||||
|
||||
Некерований custom provider:
|
||||
|
||||
```bash
|
||||
openclaw onboard --non-interactive \
|
||||
@ -51,9 +55,9 @@ openclaw onboard --non-interactive \
|
||||
--custom-compatibility openai
|
||||
```
|
||||
|
||||
`--custom-api-key` необов’язковий у неінтерактивному режимі. Якщо його пропущено, налаштування перевіряє `CUSTOM_API_KEY`.
|
||||
`--custom-api-key` є необов’язковим у неінтерактивному режимі. Якщо його не вказано, онбординг перевіряє `CUSTOM_API_KEY`.
|
||||
|
||||
LM Studio також підтримує прапорець ключа, специфічний для провайдера, у неінтерактивному режимі:
|
||||
LM Studio також підтримує специфічний для провайдера прапорець ключа в неінтерактивному режимі:
|
||||
|
||||
```bash
|
||||
openclaw onboard --non-interactive \
|
||||
@ -64,7 +68,7 @@ openclaw onboard --non-interactive \
|
||||
--accept-risk
|
||||
```
|
||||
|
||||
Некастомний Ollama у неінтерактивному режимі:
|
||||
Некерований Ollama:
|
||||
|
||||
```bash
|
||||
openclaw onboard --non-interactive \
|
||||
@ -74,9 +78,9 @@ openclaw onboard --non-interactive \
|
||||
--accept-risk
|
||||
```
|
||||
|
||||
`--custom-base-url` типово має значення `http://127.0.0.1:11434`. `--custom-model-id` необов’язковий; якщо його пропущено, налаштування використовує рекомендовані типові значення Ollama. Ідентифікатори хмарних моделей, такі як `kimi-k2.5:cloud`, також тут працюють.
|
||||
`--custom-base-url` за замовчуванням має значення `http://127.0.0.1:11434`. `--custom-model-id` є необов’язковим; якщо його не вказано, онбординг використовує рекомендовані Ollama значення за замовчуванням. Ідентифікатори хмарних моделей, як-от `kimi-k2.5:cloud`, тут також працюють.
|
||||
|
||||
Зберігайте ключі провайдера як посилання, а не як відкритий текст:
|
||||
Зберігайте ключі провайдерів як ref замість plaintext:
|
||||
|
||||
```bash
|
||||
openclaw onboard --non-interactive \
|
||||
@ -85,26 +89,26 @@ openclaw onboard --non-interactive \
|
||||
--accept-risk
|
||||
```
|
||||
|
||||
З `--secret-input-mode ref` налаштування записує посилання на основі env замість значень ключів у відкритому тексті.
|
||||
Для провайдерів на основі профілю автентифікації це записує записи `keyRef`; для кастомних провайдерів це записує `models.providers.<id>.apiKey` як env-посилання (наприклад, `{ source: "env", provider: "default", id: "CUSTOM_API_KEY" }`).
|
||||
З `--secret-input-mode ref` онбординг записує refs на основі env замість plaintext-значень ключів.
|
||||
Для провайдерів на основі auth-profile це записує записи `keyRef`; для custom providers це записує `models.providers.<id>.apiKey` як env ref (наприклад, `{ source: "env", provider: "default", id: "CUSTOM_API_KEY" }`).
|
||||
|
||||
Контракт неінтерактивного режиму `ref`:
|
||||
|
||||
- Встановіть змінну середовища провайдера в середовищі процесу налаштування (наприклад, `OPENAI_API_KEY`).
|
||||
- Не передавайте вбудовані прапорці ключа (наприклад, `--openai-api-key`), якщо цю змінну середовища також не встановлено.
|
||||
- Якщо вбудований прапорець ключа передано без потрібної змінної середовища, налаштування швидко завершується з повідомленням-підказкою.
|
||||
- Установіть env var провайдера в середовищі процесу онбордингу (наприклад, `OPENAI_API_KEY`).
|
||||
- Не передавайте вбудовані прапорці ключів (наприклад, `--openai-api-key`), якщо цей env var також не встановлено.
|
||||
- Якщо вбудований прапорець ключа передано без потрібного env var, онбординг негайно завершується з підказкою щодо виправлення.
|
||||
|
||||
Параметри токена Gateway у неінтерактивному режимі:
|
||||
|
||||
- `--gateway-auth token --gateway-token <token>` зберігає токен у відкритому тексті.
|
||||
- `--gateway-auth token --gateway-token <token>` зберігає plaintext-токен.
|
||||
- `--gateway-auth token --gateway-token-ref-env <name>` зберігає `gateway.auth.token` як env SecretRef.
|
||||
- `--gateway-token` і `--gateway-token-ref-env` взаємовиключні.
|
||||
- `--gateway-token-ref-env` вимагає непорожньої змінної середовища в середовищі процесу налаштування.
|
||||
- З `--install-daemon`, коли автентифікація токеном вимагає токен, токени Gateway під керуванням SecretRef перевіряються, але не зберігаються як розв’язаний відкритий текст у метаданих середовища служби supervisor.
|
||||
- З `--install-daemon`, якщо режим токена вимагає токен і налаштований SecretRef токена не розв’язується, налаштування завершується в закритому режимі з підказками щодо усунення проблеми.
|
||||
- З `--install-daemon`, якщо налаштовано і `gateway.auth.token`, і `gateway.auth.password`, а `gateway.auth.mode` не встановлено, налаштування блокує встановлення, доки режим не буде встановлено явно.
|
||||
- Локальне налаштування записує `gateway.mode="local"` у конфігурацію. Якщо в пізнішому файлі конфігурації бракує `gateway.mode`, вважайте це пошкодженням конфігурації або неповним ручним редагуванням, а не дійсним скороченням для локального режиму.
|
||||
- `--allow-unconfigured` — це окремий аварійний обхід часу виконання Gateway. Це не означає, що під час налаштування можна пропустити `gateway.mode`.
|
||||
- `--gateway-token` і `--gateway-token-ref-env` є взаємовиключними.
|
||||
- `--gateway-token-ref-env` потребує непорожнього env var у середовищі процесу онбордингу.
|
||||
- З `--install-daemon`, коли автентифікація токеном потребує токен, токени Gateway під керуванням SecretRef проходять перевірку, але не зберігаються як розв’язані plaintext-значення в метаданих середовища сервісу supervisor.
|
||||
- З `--install-daemon`, якщо режим токена потребує токен, а налаштований SecretRef токена є нерозв’язаним, онбординг завершується з блокуванням і підказкою щодо виправлення.
|
||||
- З `--install-daemon`, якщо налаштовано і `gateway.auth.token`, і `gateway.auth.password`, а `gateway.auth.mode` не встановлено, онбординг блокує встановлення, доки режим не буде вказано явно.
|
||||
- Локальний онбординг записує `gateway.mode="local"` у конфігурацію. Якщо в пізнішому файлі конфігурації бракує `gateway.mode`, розцінюйте це як пошкодження конфігурації або неповне ручне редагування, а не як припустиме скорочення для локального режиму.
|
||||
- `--allow-unconfigured` — це окремий аварійний механізм часу виконання Gateway. Це не означає, що онбординг може пропустити `gateway.mode`.
|
||||
|
||||
Приклад:
|
||||
|
||||
@ -118,41 +122,41 @@ openclaw onboard --non-interactive \
|
||||
--accept-risk
|
||||
```
|
||||
|
||||
Стан локального Gateway у неінтерактивному режимі:
|
||||
Стан Gateway локального режиму в неінтерактивному режимі:
|
||||
|
||||
- Якщо не передано `--skip-health`, налаштування чекає на доступний локальний Gateway, перш ніж успішно завершитися.
|
||||
- `--install-daemon` спочатку запускає шлях керованого встановлення Gateway. Без нього у вас уже має працювати локальний Gateway, наприклад `openclaw gateway run`.
|
||||
- Якщо ви не передасте `--skip-health`, онбординг чекатиме, доки локальний Gateway стане доступним, перш ніж успішно завершитися.
|
||||
- `--install-daemon` спочатку запускає сценарій керованого встановлення Gateway. Без нього у вас уже має працювати локальний Gateway, наприклад `openclaw gateway run`.
|
||||
- Якщо в автоматизації вам потрібні лише записи конфігурації/робочого простору/bootstrap, використовуйте `--skip-health`.
|
||||
- Якщо ви самостійно керуєте файлами робочого простору, передайте `--skip-bootstrap`, щоб установити `agents.defaults.skipBootstrap: true` і пропустити створення `AGENTS.md`, `SOUL.md`, `TOOLS.md`, `IDENTITY.md`, `USER.md`, `HEARTBEAT.md` і `BOOTSTRAP.md`.
|
||||
- У native Windows `--install-daemon` спочатку намагається використати Scheduled Tasks і переходить до елемента входу per-user у папці Startup, якщо створення завдання заборонено.
|
||||
- Якщо ви самі керуєте файлами робочого простору, передайте `--skip-bootstrap`, щоб установити `agents.defaults.skipBootstrap: true` і пропустити створення `AGENTS.md`, `SOUL.md`, `TOOLS.md`, `IDENTITY.md`, `USER.md`, `HEARTBEAT.md` і `BOOTSTRAP.md`.
|
||||
- У нативному Windows `--install-daemon` спочатку намагається використати Scheduled Tasks і повертається до елемента входу на рівні користувача в папці Startup, якщо створення завдання заборонено.
|
||||
|
||||
Поведінка інтерактивного налаштування в режимі посилань:
|
||||
Поведінка інтерактивного онбордингу з режимом reference:
|
||||
|
||||
- Коли буде запит, виберіть **Використати посилання на секрет**.
|
||||
- Потім виберіть одне з двох:
|
||||
- Коли з’явиться запит, виберіть **Використати посилання на секрет**.
|
||||
- Потім виберіть один із варіантів:
|
||||
- Змінна середовища
|
||||
- Налаштований провайдер секретів (`file` або `exec`)
|
||||
- Перед збереженням посилання налаштування виконує швидку перевірку preflight.
|
||||
- Якщо перевірка не пройде, налаштування покаже помилку й дозволить повторити спробу.
|
||||
- Перед збереженням ref онбординг виконує швидку preflight-перевірку.
|
||||
- Якщо перевірка не вдається, онбординг показує помилку й дає змогу повторити спробу.
|
||||
|
||||
Варіанти кінцевих точок Z.AI у неінтерактивному режимі:
|
||||
Варіанти endpoint Z.AI у неінтерактивному режимі:
|
||||
|
||||
Примітка: `--auth-choice zai-api-key` тепер автоматично визначає найкращу кінцеву точку Z.AI для вашого ключа (надає перевагу загальному API з `zai/glm-5.1`).
|
||||
Якщо вам конкретно потрібні кінцеві точки GLM Coding Plan, виберіть `zai-coding-global` або `zai-coding-cn`.
|
||||
Примітка: `--auth-choice zai-api-key` тепер автоматично визначає найкращий endpoint Z.AI для вашого ключа (надає перевагу загальному API з `zai/glm-5.1`).
|
||||
Якщо вам спеціально потрібні endpoints GLM Coding Plan, виберіть `zai-coding-global` або `zai-coding-cn`.
|
||||
|
||||
```bash
|
||||
# Вибір кінцевої точки без запитів
|
||||
# Вибір endpoint без запиту
|
||||
openclaw onboard --non-interactive \
|
||||
--auth-choice zai-coding-global \
|
||||
--zai-api-key "$ZAI_API_KEY"
|
||||
|
||||
# Інші варіанти кінцевих точок Z.AI:
|
||||
# Інші варіанти endpoint Z.AI:
|
||||
# --auth-choice zai-coding-cn
|
||||
# --auth-choice zai-global
|
||||
# --auth-choice zai-cn
|
||||
```
|
||||
|
||||
Приклад Mistral у неінтерактивному режимі:
|
||||
Неінтерактивний приклад Mistral:
|
||||
|
||||
```bash
|
||||
openclaw onboard --non-interactive \
|
||||
@ -160,25 +164,23 @@ openclaw onboard --non-interactive \
|
||||
--mistral-api-key "$MISTRAL_API_KEY"
|
||||
```
|
||||
|
||||
Примітки щодо потоків:
|
||||
Примітки щодо сценаріїв:
|
||||
|
||||
- `quickstart`: мінімум запитів, автоматично генерує токен Gateway.
|
||||
- `manual`: повні запити для порту/bind/auth (псевдонім `advanced`).
|
||||
- Коли вибір автентифікації передбачає бажаного провайдера, налаштування попередньо фільтрує
|
||||
засоби вибору моделі за замовчуванням і allowlist до цього провайдера. Для Volcengine і
|
||||
BytePlus це також охоплює варіанти coding-plan
|
||||
- `manual`: повні запити для port/bind/auth (псевдонім для `advanced`).
|
||||
- Коли варіант автентифікації передбачає бажаного провайдера, онбординг попередньо фільтрує засоби вибору default-model і allowlist до цього провайдера. Для Volcengine і BytePlus це також відповідає варіантам coding-plan
|
||||
(`volcengine-plan/*`, `byteplus-plan/*`).
|
||||
- Якщо фільтр бажаного провайдера ще не дає жодної завантаженої моделі,
|
||||
налаштування повертається до нефільтрованого каталогу замість того, щоб залишити засіб вибору порожнім.
|
||||
- На кроці web-search деякі провайдери можуть запускати додаткові запити, специфічні для провайдера:
|
||||
- Якщо фільтр preferred-provider поки що не дає жодної завантаженої моделі, онбординг
|
||||
повертається до нефільтрованого каталогу замість того, щоб залишити засіб вибору порожнім.
|
||||
- На етапі web-search деякі провайдери можуть викликати додаткові запити, специфічні для провайдера:
|
||||
- **Grok** може запропонувати необов’язкове налаштування `x_search` з тим самим `XAI_API_KEY`
|
||||
і вибором моделі `x_search`.
|
||||
- **Kimi** може запитати регіон Moonshot API (`api.moonshot.ai` чи
|
||||
`api.moonshot.cn`) і типову модель web-search Kimi.
|
||||
- Поведінка області DM для локального налаштування: [Довідник налаштування CLI](/uk/start/wizard-cli-reference#outputs-and-internals).
|
||||
`api.moonshot.cn`) і модель web-search Kimi за замовчуванням.
|
||||
- Поведінка області DM у локальному онбордингу: [Довідник із налаштування CLI](/uk/start/wizard-cli-reference#outputs-and-internals).
|
||||
- Найшвидший перший чат: `openclaw dashboard` (Control UI, без налаштування каналів).
|
||||
- Кастомний провайдер: підключіть будь-яку кінцеву точку, сумісну з OpenAI або Anthropic,
|
||||
зокрема хостингових провайдерів, яких немає в списку. Використовуйте Unknown для автовизначення.
|
||||
- Custom Provider: підключайте будь-який endpoint, сумісний з OpenAI або Anthropic,
|
||||
включно з хостованими провайдерами, яких немає в списку. Використовуйте Unknown для автоматичного визначення.
|
||||
|
||||
## Поширені команди після налаштування
|
||||
|
||||
|
||||
@ -1,102 +1,108 @@
|
||||
---
|
||||
read_when:
|
||||
- Редагування тексту системного промпту, списку інструментів або розділів часу/Heartbeat
|
||||
- Зміна bootstrap робочого простору або поведінки інʼєкції Skills
|
||||
summary: Що містить системний промпт OpenClaw і як він збирається
|
||||
- Зміна поведінки початкового налаштування робочого простору або інʼєкції Skills
|
||||
summary: Що містить системний промпт OpenClaw і як його зібрано
|
||||
title: Системний промпт
|
||||
x-i18n:
|
||||
generated_at: "2026-04-24T23:30:39Z"
|
||||
generated_at: "2026-04-25T08:04:07Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 83d9cc69fff164ba52d1fc1a9b04ea799f48dbd8b449bde63473c6dec4cb026a
|
||||
source_hash: 6a0717788885521848e3ef9508e3eb5bc5a8ad39f183f0ab2ce0d4cb971cb2df
|
||||
source_path: concepts/system-prompt.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
OpenClaw створює власний системний промпт для кожного запуску агента. Промпт **належить OpenClaw** і не використовує стандартний промпт pi-coding-agent.
|
||||
OpenClaw створює власний системний промпт для кожного запуску агента. Промпт **належить OpenClaw** і не використовує типовий промпт pi-coding-agent.
|
||||
|
||||
Промпт збирається OpenClaw і впроваджується в кожен запуск агента.
|
||||
Промпт збирається OpenClaw і вбудовується в кожен запуск агента.
|
||||
|
||||
Плагіни провайдерів можуть додавати вказівки для промпту з урахуванням кешу, не замінюючи при цьому весь промпт, що належить OpenClaw. Середовище виконання провайдера може:
|
||||
Плагіни провайдерів можуть додавати cache-aware інструкції для промпту, не замінюючи
|
||||
повністю промпт, що належить OpenClaw. Середовище виконання провайдера може:
|
||||
|
||||
- замінювати невеликий набір іменованих основних розділів (`interaction_style`,
|
||||
- замінювати невеликий набір іменованих базових розділів (`interaction_style`,
|
||||
`tool_call_style`, `execution_bias`)
|
||||
- впроваджувати **стабільний префікс** над межею кешу промпту
|
||||
- впроваджувати **динамічний суфікс** під межею кешу промпту
|
||||
- вбудовувати **стабільний префікс** над межею кешу промпту
|
||||
- вбудовувати **динамічний суфікс** під межею кешу промпту
|
||||
|
||||
Використовуйте внески, що належать провайдеру, для налаштування під конкретні сімейства моделей. Зберігайте застарілу мутацію промпту `before_prompt_build` для сумісності або справді глобальних змін промпту, а не для звичайної поведінки провайдера.
|
||||
Використовуйте внески, що належать провайдеру, для налаштування під конкретні сімейства моделей. Зберігайте застарілу
|
||||
мутацію промпту `before_prompt_build` для сумісності або справді глобальних змін промпту, а не для звичайної поведінки провайдера.
|
||||
|
||||
Оверлей для сімейства OpenAI GPT-5 зберігає основне правило виконання компактним і додає вказівки, специфічні для моделі: фіксація персони, лаконічний вивід, дисципліна використання інструментів, паралельний пошук, охоплення результатів, перевірка, відсутній контекст і гігієна інструментів термінала.
|
||||
Накладення для сімейства OpenAI GPT-5 зберігає невелике базове правило виконання та додає
|
||||
специфічні для моделі вказівки для фіксації персони, лаконічного виводу, дисципліни інструментів,
|
||||
паралельного пошуку, повноти результатів, перевірки, відсутнього контексту та
|
||||
гігієни інструментів термінала.
|
||||
|
||||
## Структура
|
||||
|
||||
Промпт навмисно компактний і використовує фіксовані розділи:
|
||||
|
||||
- **Інструменти**: нагадування про структуровані інструменти як джерело істини плюс вказівки щодо використання інструментів під час виконання.
|
||||
- **Ухил виконання**: компактні вказівки щодо доведення справ до кінця: діяти в межах поточного ходу для запитів, які можна виконати, продовжувати до завершення або блокування, відновлюватися після слабких результатів інструментів, перевіряти змінний стан наживо та верифікувати перед завершенням.
|
||||
- **Інструменти**: нагадування про структурований інструмент як єдине джерело істини плюс вказівки щодо використання інструментів під час виконання.
|
||||
- **Схильність до виконання**: компактні вказівки для доведення справи до кінця: діяти в поточному ході за
|
||||
запитами, які можна виконати, продовжувати до завершення або блокування, відновлюватися після слабких результатів
|
||||
інструментів, перевіряти змінний стан наживо та верифікувати перед фіналізацією.
|
||||
- **Безпека**: коротке нагадування про запобіжники, щоб уникати поведінки, спрямованої на здобуття влади, або обходу нагляду.
|
||||
- **Skills** (коли доступні): повідомляє моделі, як завантажувати інструкції Skills за потреби.
|
||||
- **Skills** (коли доступні): пояснює моделі, як завантажувати інструкції Skills на вимогу.
|
||||
- **Самооновлення OpenClaw**: як безпечно перевіряти конфігурацію за допомогою
|
||||
`config.schema.lookup`, змінювати конфігурацію за допомогою `config.patch`, замінювати всю
|
||||
конфігурацію за допомогою `config.apply` і запускати `update.run` лише за явним
|
||||
`config.schema.lookup`, змінювати конфігурацію через `config.patch`, замінювати всю
|
||||
конфігурацію через `config.apply` і запускати `update.run` лише за явним
|
||||
запитом користувача. Інструмент `gateway`, доступний лише власнику, також відмовляється переписувати
|
||||
`tools.exec.ask` / `tools.exec.security`, включно із застарілими
|
||||
псевдонімами `tools.bash.*`, які нормалізуються до цих захищених шляхів exec.
|
||||
- **Робочий простір**: робочий каталог (`agents.defaults.workspace`).
|
||||
- **Документація**: локальний шлях до документації OpenClaw (репозиторій або npm package) і коли її читати.
|
||||
- **Файли робочого простору (впроваджені)**: вказує, що bootstrap-файли включено нижче.
|
||||
- **Пісочниця** (коли ввімкнено): вказує на ізольоване середовище виконання, шляхи пісочниці та чи доступне підвищене виконання.
|
||||
- **Файли робочого простору (вбудовані)**: вказує, що файли початкового налаштування включено нижче.
|
||||
- **Пісочниця** (коли увімкнено): вказує на ізольоване середовище виконання, шляхи пісочниці та чи доступне підвищене виконання.
|
||||
- **Поточна дата й час**: локальний час користувача, часовий пояс і формат часу.
|
||||
- **Теги відповіді**: необов’язковий синтаксис тегів відповіді для підтримуваних провайдерів.
|
||||
- **Heartbeat**: промпт Heartbeat і поведінка підтвердження, коли Heartbeat увімкнено для стандартного агента.
|
||||
- **Середовище виконання**: хост, ОС, node, модель, корінь репозиторію (коли визначено), рівень мислення (одним рядком).
|
||||
- **Міркування**: поточний рівень видимості + підказка перемикання /reasoning.
|
||||
- **Heartbeat**: промпт Heartbeat і поведінка підтвердження, коли Heartbeat увімкнено для типового агента.
|
||||
- **Середовище виконання**: хост, ОС, node, модель, корінь репозиторію (коли виявлено), рівень міркування (один рядок).
|
||||
- **Міркування**: поточний рівень видимості + підказка про перемикання /reasoning.
|
||||
|
||||
Розділ «Інструменти» також містить вказівки під час виконання для довготривалої роботи:
|
||||
Розділ «Інструменти» також містить вказівки для довготривалої роботи під час виконання:
|
||||
|
||||
- використовуйте cron для подальших дій у майбутньому (`check back later`, нагадування, повторювана робота)
|
||||
замість циклів сну через `exec`, трюків із затримкою `yieldMs` або повторного
|
||||
опитування `process`
|
||||
- використовуйте `exec` / `process` лише для команд, які запускаються зараз і продовжують виконуватися
|
||||
- використовуйте Cron для подальших дій у майбутньому (`check back later`, нагадування, повторювана робота)
|
||||
замість циклів сну `exec`, трюків із затримкою `yieldMs` або повторного опитування
|
||||
`process`
|
||||
- використовуйте `exec` / `process` лише для команд, які запускаються зараз і продовжують працювати
|
||||
у фоновому режимі
|
||||
- коли ввімкнено автоматичне пробудження після завершення, запускайте команду один раз і покладайтеся на
|
||||
push-орієнтований механізм пробудження, коли вона виведе результат або завершиться з помилкою
|
||||
- використовуйте `process` для логів, статусу, введення або втручання, коли вам потрібно
|
||||
перевірити виконувану команду
|
||||
- якщо завдання більше, віддавайте перевагу `sessions_spawn`; завершення субагента працює на основі
|
||||
push і автоматично оголошується назад запитувачу
|
||||
- коли увімкнено автоматичне пробудження після завершення, запускайте команду один раз і покладайтеся на
|
||||
push-based шлях пробудження, коли вона виводить результат або завершується помилкою
|
||||
- використовуйте `process` для логів, стану, вводу або втручання, коли вам потрібно
|
||||
перевірити команду, що виконується
|
||||
- якщо завдання більше, надавайте перевагу `sessions_spawn`; завершення субагента є
|
||||
push-based і автоматично анонсується назад запитувачу
|
||||
- не опитуйте `subagents list` / `sessions_list` у циклі лише для очікування
|
||||
завершення
|
||||
|
||||
Коли ввімкнено експериментальний інструмент `update_plan`, розділ «Інструменти» також повідомляє
|
||||
моделі використовувати його лише для нетривіальної багатокрокової роботи, тримати рівно один
|
||||
крок `in_progress` і не повторювати весь план після кожного оновлення.
|
||||
Коли експериментальний інструмент `update_plan` увімкнено, розділ «Інструменти» також повідомляє
|
||||
моделі використовувати його лише для нетривіальної багатокрокової роботи, зберігати рівно один крок
|
||||
`in_progress` і уникати повторення всього плану після кожного оновлення.
|
||||
|
||||
Запобіжники безпеки в системному промпті мають рекомендаційний характер. Вони спрямовують поведінку моделі, але не забезпечують примусове застосування політики. Для жорсткого забезпечення використовуйте політику інструментів, погодження exec, пісочницю та allowlist каналів; оператори можуть вимкнути їх за задумом.
|
||||
Запобіжники безпеки в системному промпті мають рекомендаційний характер. Вони спрямовують поведінку моделі, але не забезпечують виконання політики. Для жорсткого забезпечення використовуйте політику інструментів, схвалення exec, пісочницю та allowlist каналів; оператори за задумом можуть їх вимкнути.
|
||||
|
||||
У каналах із нативними картками/кнопками погодження промпт середовища виконання тепер повідомляє
|
||||
агенту спочатку покладатися на цей нативний UI погодження. Він має включати ручну
|
||||
команду `/approve` лише тоді, коли результат інструмента каже, що погодження в чаті недоступні або
|
||||
ручне погодження — єдиний шлях.
|
||||
У каналах із нативними картками/кнопками схвалення промпт середовища виконання тепер вказує
|
||||
агенту спочатку покладатися саме на цей нативний UI схвалення. Він має включати ручну
|
||||
команду `/approve` лише тоді, коли результат інструмента вказує, що схвалення в чаті недоступні або
|
||||
ручне схвалення — єдиний шлях.
|
||||
|
||||
## Режими промпту
|
||||
|
||||
OpenClaw може рендерити менші системні промпти для субагентів. Середовище виконання встановлює
|
||||
`promptMode` для кожного запуску (це не користувацький параметр конфігурації):
|
||||
`promptMode` для кожного запуску (це не конфігурація, видима користувачу):
|
||||
|
||||
- `full` (типово): включає всі наведені вище розділи.
|
||||
- `minimal`: використовується для субагентів; пропускає **Skills**, **Виклик пам’яті**, **Самооновлення OpenClaw**, **Псевдоніми моделей**, **Ідентичність користувача**, **Теги відповіді**,
|
||||
**Повідомлення**, **Тихі відповіді** та **Heartbeat**. **Інструменти**,
|
||||
**Безпека**, Робочий простір, Пісочниця, Поточна дата й час (коли відомо), Середовище виконання та впроваджений
|
||||
- `full` (типово): включає всі розділи вище.
|
||||
- `minimal`: використовується для субагентів; пропускає **Skills**, **Відновлення пам’яті**, **Самооновлення OpenClaw**, **Псевдоніми моделей**, **Ідентичність користувача**, **Теги відповіді**,
|
||||
**Обмін повідомленнями**, **Тихі відповіді** та **Heartbeat**. **Інструменти**, **Безпека**,
|
||||
Робочий простір, Пісочниця, Поточна дата й час (коли відомо), Середовище виконання та вбудований
|
||||
контекст залишаються доступними.
|
||||
- `none`: повертає лише базовий рядок ідентичності.
|
||||
|
||||
Коли `promptMode=minimal`, додаткові впроваджені промпти позначаються як **Контекст субагента**
|
||||
замість **Контекст групового чату**.
|
||||
Коли `promptMode=minimal`, додаткові вбудовані промпти позначаються як **Контекст субагента** замість **Контекст групового чату**.
|
||||
|
||||
## Впровадження bootstrap робочого простору
|
||||
## Вбудовування початкового налаштування робочого простору
|
||||
|
||||
Bootstrap-файли обрізаються та додаються в розділ **Контекст проєкту**, щоб модель бачила контекст ідентичності та профілю без явного читання:
|
||||
Файли початкового налаштування обрізаються та додаються в розділ **Контекст проєкту**, щоб модель бачила контекст ідентичності та профілю без потреби в явному читанні:
|
||||
|
||||
- `AGENTS.md`
|
||||
- `SOUL.md`
|
||||
@ -105,72 +111,73 @@ Bootstrap-файли обрізаються та додаються в розд
|
||||
- `USER.md`
|
||||
- `HEARTBEAT.md`
|
||||
- `BOOTSTRAP.md` (лише в абсолютно нових робочих просторах)
|
||||
- `MEMORY.md` за наявності
|
||||
- `MEMORY.md`, якщо він присутній
|
||||
|
||||
Усі ці файли **впроваджуються у вікно контексту** на кожному ході, якщо не застосовується окремий бар’єр для файла. `HEARTBEAT.md` пропускається під час звичайних запусків, коли
|
||||
Heartbeat вимкнено для стандартного агента або
|
||||
`agents.defaults.heartbeat.includeSystemPromptSection` має значення false. Зберігайте впроваджені
|
||||
файли лаконічними — особливо `MEMORY.md`, який з часом може розростатися та призводити до
|
||||
Усі ці файли **вбудовуються у вікно контексту** на кожному ході, якщо
|
||||
не застосовується специфічне для файлу обмеження. `HEARTBEAT.md` пропускається під час звичайних запусків, коли
|
||||
Heartbeat вимкнено для типового агента або
|
||||
`agents.defaults.heartbeat.includeSystemPromptSection` має значення false. Зберігайте вбудовані
|
||||
файли лаконічними — особливо `MEMORY.md`, який із часом може збільшуватися та призводити до
|
||||
неочікувано високого використання контексту й частішої Compaction.
|
||||
|
||||
> **Примітка:** щоденні файли `memory/*.md` **не** входять до звичайного bootstrap
|
||||
> Контексту проєкту. У звичайних ходах доступ до них відбувається за потреби через
|
||||
> інструменти `memory_search` і `memory_get`, тому вони не враховуються у
|
||||
> вікні контексту, якщо модель явно їх не читає. Виняток — порожні ходи `/new` і
|
||||
> `/reset`: середовище виконання може додати нещодавню щоденну пам’ять як одноразовий
|
||||
> блок стартового контексту для цього першого ходу.
|
||||
> **Примітка:** щоденні файли `memory/*.md` **не** є частиною звичайного
|
||||
> Контексту проєкту початкового налаштування.
|
||||
> У звичайних ходах до них звертаються на вимогу через інструменти
|
||||
> `memory_search` і `memory_get`, тому вони не враховуються у
|
||||
> вікні контексту, якщо модель явно їх не читає. Виняток — прості ходи `/new` і
|
||||
> `/reset`: середовище виконання може додати нещодавню щоденну пам’ять як одноразовий блок стартового контексту для цього першого ходу.
|
||||
|
||||
Великі файли обрізаються з маркером. Максимальний розмір на файл керується через
|
||||
`agents.defaults.bootstrapMaxChars` (типово: 12000). Загальний обсяг впровадженого bootstrap-вмісту
|
||||
в усіх файлах обмежено `agents.defaults.bootstrapTotalMaxChars`
|
||||
(типово: 60000). Для відсутніх файлів впроваджується короткий маркер відсутнього файла. Коли відбувається обрізання,
|
||||
OpenClaw може впроваджувати блок попередження в Контекст проєкту; це керується через
|
||||
Великі файли обрізаються з маркером. Максимальний розмір кожного файлу контролюється через
|
||||
`agents.defaults.bootstrapMaxChars` (типово: 12000). Загальний обсяг вбудованого початкового
|
||||
вмісту в усіх файлах обмежується `agents.defaults.bootstrapTotalMaxChars`
|
||||
(типово: 60000). Для відсутніх файлів вбудовується короткий маркер відсутнього файлу. Коли відбувається обрізання,
|
||||
OpenClaw може вбудувати блок попередження в Контекст проєкту; це контролюється через
|
||||
`agents.defaults.bootstrapPromptTruncationWarning` (`off`, `once`, `always`;
|
||||
типово: `once`).
|
||||
|
||||
Сесії субагентів впроваджують лише `AGENTS.md` і `TOOLS.md` (інші bootstrap-файли
|
||||
Сеанси субагентів вбудовують лише `AGENTS.md` і `TOOLS.md` (інші файли початкового налаштування
|
||||
відфільтровуються, щоб контекст субагента залишався малим).
|
||||
|
||||
Внутрішні хуки можуть перехоплювати цей крок через `agent:bootstrap`, щоб змінювати або замінювати
|
||||
впроваджені bootstrap-файли (наприклад, замінювати `SOUL.md` альтернативною персоною).
|
||||
вбудовані файли початкового налаштування (наприклад, замінювати `SOUL.md` на альтернативну персону).
|
||||
|
||||
Якщо ви хочете, щоб агент звучав менш шаблонно, почніть із
|
||||
Якщо ви хочете, щоб агент звучав менш узагальнено, почніть із
|
||||
[Посібника з індивідуальності SOUL.md](/uk/concepts/soul).
|
||||
|
||||
Щоб перевірити, який внесок дає кожен впроваджений файл (сирий чи впроваджений, обрізання, а також накладні витрати на схему інструмента), використовуйте `/context list` або `/context detail`. Див. [Контекст](/uk/concepts/context).
|
||||
Щоб перевірити, який внесок робить кожен вбудований файл (сирий чи вбудований розмір, обрізання, а також накладні витрати схеми інструментів), використовуйте `/context list` або `/context detail`. Див. [Контекст](/uk/concepts/context).
|
||||
|
||||
## Обробка часу
|
||||
|
||||
Системний промпт містить окремий розділ **Поточна дата й час**, коли
|
||||
відомий часовий пояс користувача. Щоб зберігати стабільність кешу промпту, тепер він містить лише
|
||||
відомий часовий пояс користувача. Щоб зберегти стабільність кешу промпту, тепер він містить лише
|
||||
**часовий пояс** (без динамічного годинника чи формату часу).
|
||||
|
||||
Використовуйте `session_status`, коли агенту потрібен поточний час; картка статусу
|
||||
містить рядок позначки часу. Той самий інструмент також може за бажанням встановити перевизначення моделі
|
||||
для сесії (`model=default` очищає його).
|
||||
Використовуйте `session_status`, коли агенту потрібен поточний час; картка стану
|
||||
містить рядок із часовою позначкою. Той самий інструмент також за бажанням може встановлювати перевизначення
|
||||
моделі для окремого сеансу (`model=default` очищає його).
|
||||
|
||||
Налаштовується через:
|
||||
|
||||
- `agents.defaults.userTimezone`
|
||||
- `agents.defaults.timeFormat` (`auto` | `12` | `24`)
|
||||
|
||||
Повну інформацію про поведінку див. у [Дата й час](/uk/date-time).
|
||||
Див. [Дата й час](/uk/date-time) для повних деталей поведінки.
|
||||
|
||||
## Skills
|
||||
|
||||
Коли існують придатні Skills, OpenClaw впроваджує компактний **список доступних Skills**
|
||||
(`formatSkillsForPrompt`), який містить **шлях до файла** для кожного skill. Промпт
|
||||
інструктує модель використовувати `read`, щоб завантажити SKILL.md у зазначеному
|
||||
розташуванні (робочий простір, кероване або вбудоване). Якщо жоден skill не є придатним, розділ
|
||||
Skills пропускається.
|
||||
Коли існують відповідні Skills, OpenClaw вбудовує компактний **список доступних Skills**
|
||||
(`formatSkillsForPrompt`), який містить **шлях до файлу** для кожної Skills. Промпт
|
||||
інструктує модель використовувати `read` для завантаження SKILL.md у вказаному
|
||||
місці (робочий простір, кероване або вбудоване). Якщо відповідних Skills немає,
|
||||
розділ Skills пропускається.
|
||||
|
||||
Придатність включає бар’єри метаданих skill, перевірки середовища виконання/конфігурації
|
||||
та ефективний allowlist Skills агента, коли налаштовано `agents.defaults.skills` або
|
||||
Відповідність включає обмеження метаданих Skills, перевірки середовища виконання/конфігурації,
|
||||
а також ефективний allowlist Skills агента, коли налаштовано `agents.defaults.skills` або
|
||||
`agents.list[].skills`.
|
||||
|
||||
Skills, вбудовані в плагін, є придатними лише тоді, коли плагін-власник увімкнено.
|
||||
Це дозволяє плагінам інструментів надавати глибші робочі інструкції, не вбудовуючи всі
|
||||
ці вказівки безпосередньо в опис кожного інструмента.
|
||||
Skills, вбудовані в Plugin, відповідають умовам лише тоді, коли Plugin, якому вони належать, увімкнено.
|
||||
Це дозволяє плагінам інструментів надавати глибші операційні посібники без вбудовування всіх
|
||||
цих вказівок безпосередньо в опис кожного інструмента.
|
||||
|
||||
```
|
||||
<available_skills>
|
||||
@ -182,32 +189,38 @@ Skills, вбудовані в плагін, є придатними лише т
|
||||
</available_skills>
|
||||
```
|
||||
|
||||
Це зберігає базовий промпт малим, але водночас дає змогу цільового використання Skills.
|
||||
Це зберігає базовий промпт невеликим, але водночас дозволяє цільове використання Skills.
|
||||
|
||||
Бюджет списку Skills належить підсистемі Skills:
|
||||
|
||||
- Глобальне типове значення: `skills.limits.maxSkillsPromptChars`
|
||||
- Перевизначення для агента: `agents.list[].skillsLimits.maxSkillsPromptChars`
|
||||
- Перевизначення для окремого агента: `agents.list[].skillsLimits.maxSkillsPromptChars`
|
||||
|
||||
Загальні обмежені уривки середовища виконання використовують іншу поверхню:
|
||||
Універсальні обмежені витяги середовища виконання використовують іншу поверхню:
|
||||
|
||||
- `agents.defaults.contextLimits.*`
|
||||
- `agents.list[].contextLimits.*`
|
||||
|
||||
Такий поділ зберігає розмір Skills окремо від розміру читання/впровадження під час виконання, такого
|
||||
як `memory_get`, живі результати інструментів і оновлення AGENTS.md після Compaction.
|
||||
Такий поділ зберігає розмір Skills окремо від розміру читання/вбудовування в середовищі виконання, наприклад
|
||||
для `memory_get`, результатів живих інструментів і оновлень `AGENTS.md` після Compaction.
|
||||
|
||||
## Документація
|
||||
|
||||
Коли доступно, системний промпт містить розділ **Документація**, який вказує на
|
||||
локальний каталог документації OpenClaw (або `docs/` у робочому просторі репозиторію, або документацію вбудованого
|
||||
npm package) і також згадує публічне дзеркало, вихідний репозиторій, спільноту Discord і
|
||||
ClawHub ([https://clawhub.ai](https://clawhub.ai)) для пошуку Skills. Промпт інструктує модель спочатку звертатися до локальної документації
|
||||
щодо поведінки OpenClaw, команд, конфігурації чи архітектури та
|
||||
Системний промпт містить розділ **Документація**. Коли локальна документація доступна, він
|
||||
вказує на локальний каталог документації OpenClaw (`docs/` у Git checkout або документацію
|
||||
з комплектного npm package). Якщо локальна документація недоступна, використовується резервний варіант
|
||||
[https://docs.openclaw.ai](https://docs.openclaw.ai).
|
||||
|
||||
Той самий розділ також містить розташування вихідного коду OpenClaw. Git checkout надають локальний
|
||||
корінь вихідного коду, щоб агент міг безпосередньо перевіряти код. Встановлення з package містять GitHub
|
||||
URL вихідного коду й повідомляють агенту переглядати код там щоразу, коли документація неповна або
|
||||
застаріла. Промпт також згадує публічне дзеркало документації, Discord спільноти та ClawHub
|
||||
([https://clawhub.ai](https://clawhub.ai)) для пошуку Skills. Він вказує моделі
|
||||
спочатку звертатися до документації щодо поведінки OpenClaw, команд, конфігурації або архітектури, а також
|
||||
самостійно запускати `openclaw status`, коли це можливо (звертаючись до користувача лише тоді, коли доступу немає).
|
||||
|
||||
## Пов’язане
|
||||
|
||||
- [Середовище виконання агента](/uk/concepts/agent)
|
||||
- [Робочий простір агента](/uk/concepts/agent-workspace)
|
||||
- [Рушій контексту](/uk/concepts/context-engine)
|
||||
- [Механізм контексту](/uk/concepts/context-engine)
|
||||
|
||||
@ -1,36 +1,36 @@
|
||||
---
|
||||
read_when:
|
||||
- Використання або налаштування chat-команд
|
||||
- Використання або налаштування команд чату
|
||||
- Налагодження маршрутизації команд або дозволів
|
||||
summary: 'Слеш-команди: текстові vs native, config і підтримувані команди'
|
||||
summary: 'Слеш-команди: текстові чи нативні, конфігурація та підтримувані команди'
|
||||
title: Слеш-команди
|
||||
x-i18n:
|
||||
generated_at: "2026-04-25T00:04:16Z"
|
||||
generated_at: "2026-04-25T08:04:09Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 01d8c7a30f9a7bf9ea08ec6372bf47feb5d6153859f616cb0531cb910557d17e
|
||||
source_hash: bab969a72f10880b88a75a7a0cc7870989c826fbf7e9b8637a558cc29cfcc417
|
||||
source_path: tools/slash-commands.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
Команди обробляються Gateway. Більшість команд мають надсилатися як **окреме** повідомлення, що починається з `/`.
|
||||
Чат-команда bash лише для хоста використовує `! <cmd>` (з псевдонімом `/bash <cmd>`).
|
||||
Команди обробляє Gateway. Більшість команд потрібно надсилати як **окреме** повідомлення, яке починається з `/`.
|
||||
Команда чату bash лише для хоста використовує `! <cmd>` (із псевдонімом `/bash <cmd>`).
|
||||
|
||||
Є дві пов’язані системи:
|
||||
|
||||
- **Команди**: окремі повідомлення `/...`.
|
||||
- **Директиви**: `/think`, `/fast`, `/verbose`, `/trace`, `/reasoning`, `/elevated`, `/exec`, `/model`, `/queue`.
|
||||
- Директиви видаляються з повідомлення до того, як модель його побачить.
|
||||
- У звичайних чат-повідомленнях (не лише з директивами) вони трактуються як «вбудовані підказки» і **не** зберігають налаштування сесії.
|
||||
- Директиви вилучаються з повідомлення до того, як його побачить модель.
|
||||
- У звичайних повідомленнях чату (не лише з директив) вони трактуються як «вбудовані підказки» і **не** зберігають налаштування сесії.
|
||||
- У повідомленнях лише з директивами (повідомлення містить тільки директиви) вони зберігаються в сесії та повертають підтвердження.
|
||||
- Директиви застосовуються лише для **авторизованих відправників**. Якщо встановлено `commands.allowFrom`, використовується лише цей
|
||||
allowlist; інакше авторизація походить із allowlist каналу/пейрингу плюс `commands.useAccessGroups`.
|
||||
Для неавторизованих відправників директиви трактуються як звичайний текст.
|
||||
- Директиви застосовуються лише для **авторизованих відправників**. Якщо задано `commands.allowFrom`, це єдиний
|
||||
використовуваний список дозволених; інакше авторизація походить зі списків дозволених каналу/спарювання плюс `commands.useAccessGroups`.
|
||||
Для неавторизованих відправників директиви обробляються як звичайний текст.
|
||||
|
||||
Є також кілька **вбудованих shortcut** (лише для allowlisted/авторизованих відправників): `/help`, `/commands`, `/status`, `/whoami` (`/id`).
|
||||
Вони запускаються негайно, видаляються до того, як модель побачить повідомлення, а решта тексту проходить звичайний потік.
|
||||
Також є кілька **вбудованих скорочень** (лише для відправників зі списку дозволених/авторизованих): `/help`, `/commands`, `/status`, `/whoami` (`/id`).
|
||||
Вони виконуються негайно, вилучаються до того, як повідомлення побачить модель, а решта тексту проходить звичайний потік обробки.
|
||||
|
||||
## Config
|
||||
## Конфігурація
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -57,111 +57,111 @@ x-i18n:
|
||||
}
|
||||
```
|
||||
|
||||
- `commands.text` (за замовчуванням `true`) вмикає парсинг `/...` у чат-повідомленнях.
|
||||
- На поверхнях без native-команд (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams) текстові команди все одно працюють, навіть якщо встановити це значення в `false`.
|
||||
- `commands.native` (за замовчуванням `"auto"`) реєструє native-команди.
|
||||
- Auto: увімкнено для Discord/Telegram; вимкнено для Slack (доки ви не додасте slash-команди); ігнорується для провайдерів без native-підтримки.
|
||||
- `commands.text` (типово `true`) вмикає розбір `/...` у повідомленнях чату.
|
||||
- На поверхнях без нативних команд (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams) текстові команди все одно працюють, навіть якщо встановити це значення в `false`.
|
||||
- `commands.native` (типово `"auto"`) реєструє нативні команди.
|
||||
- Auto: увімкнено для Discord/Telegram; вимкнено для Slack (поки ви не додасте slash-команди); ігнорується для провайдерів без нативної підтримки.
|
||||
- Установіть `channels.discord.commands.native`, `channels.telegram.commands.native` або `channels.slack.commands.native`, щоб перевизначити значення для окремого провайдера (bool або `"auto"`).
|
||||
- `false` очищає раніше зареєстровані команди в Discord/Telegram під час запуску. Команди Slack керуються в застосунку Slack і не видаляються автоматично.
|
||||
- `commands.nativeSkills` (за замовчуванням `"auto"`) реєструє native-команди **skill**, коли це підтримується.
|
||||
- Auto: увімкнено для Discord/Telegram; вимкнено для Slack (у Slack потрібно створювати окрему slash-команду для кожного skill).
|
||||
- `commands.nativeSkills` (типово `"auto"`) реєструє команди **Skills** нативно, якщо це підтримується.
|
||||
- Auto: увімкнено для Discord/Telegram; вимкнено для Slack (у Slack потрібно створити slash-команду для кожного skill).
|
||||
- Установіть `channels.discord.commands.nativeSkills`, `channels.telegram.commands.nativeSkills` або `channels.slack.commands.nativeSkills`, щоб перевизначити значення для окремого провайдера (bool або `"auto"`).
|
||||
- `commands.bash` (за замовчуванням `false`) вмикає `! <cmd>` для виконання shell-команд хоста (`/bash <cmd>` — псевдонім; потрібні allowlist `tools.elevated`).
|
||||
- `commands.bashForegroundMs` (за замовчуванням `2000`) керує тим, скільки часу bash чекає перед переходом у фоновий режим (`0` одразу переводить у фон).
|
||||
- `commands.config` (за замовчуванням `false`) вмикає `/config` (читання/запис `openclaw.json`).
|
||||
- `commands.mcp` (за замовчуванням `false`) вмикає `/mcp` (читання/запис конфігурації MCP під керуванням OpenClaw у `mcp.servers`).
|
||||
- `commands.plugins` (за замовчуванням `false`) вмикає `/plugins` (виявлення/стан plugin плюс керування install + enable/disable).
|
||||
- `commands.debug` (за замовчуванням `false`) вмикає `/debug` (лише runtime overrides).
|
||||
- `commands.restart` (за замовчуванням `true`) вмикає `/restart` плюс tool actions перезапуску gateway.
|
||||
- `commands.ownerAllowFrom` (необов’язково) задає явний allowlist власника для поверхонь команд/tool лише для власника. Це окремо від `commands.allowFrom`.
|
||||
- Поканальний `channels.<channel>.commands.enforceOwnerForCommands` (необов’язково, за замовчуванням `false`) змушує команди лише для власника вимагати **ідентичність власника** для виконання на цій поверхні. Якщо значення `true`, відправник має або відповідати знайденому кандидату власника (наприклад, запису в `commands.ownerAllowFrom` або native-метаданим власника провайдера), або мати внутрішню область `operator.admin` на внутрішньому каналі повідомлень. Wildcard-запис у channel `allowFrom` або порожній/нерозв’язаний список кандидатів власника **не** є достатнім — команди лише для власника для цього каналу завершуються за принципом fail closed. Залишайте це вимкненим, якщо хочете, щоб команди лише для власника обмежувалися лише `ownerAllowFrom` і стандартними command allowlist.
|
||||
- `commands.ownerDisplay` керує тим, як id власника з’являються в system prompt: `raw` або `hash`.
|
||||
- `commands.bash` (типово `false`) вмикає `! <cmd>` для запуску команд оболонки на хості (`/bash <cmd>` — псевдонім; потребує списків дозволених `tools.elevated`).
|
||||
- `commands.bashForegroundMs` (типово `2000`) керує тим, як довго bash очікує перед переходом у фоновий режим (`0` одразу переводить у фон).
|
||||
- `commands.config` (типово `false`) вмикає `/config` (читає/записує `openclaw.json`).
|
||||
- `commands.mcp` (типово `false`) вмикає `/mcp` (читає/записує конфігурацію MCP, якою керує OpenClaw, у `mcp.servers`).
|
||||
- `commands.plugins` (типово `false`) вмикає `/plugins` (виявлення/статус плагінів, а також елементи керування встановленням і вмиканням/вимиканням).
|
||||
- `commands.debug` (типово `false`) вмикає `/debug` (лише перевизначення під час виконання).
|
||||
- `commands.restart` (типово `true`) вмикає `/restart`, а також дії інструментів перезапуску gateway.
|
||||
- `commands.ownerAllowFrom` (необов’язково) задає явний список дозволених власників для поверхонь команд/інструментів лише для власника. Це окремо від `commands.allowFrom`.
|
||||
- `channels.<channel>.commands.enforceOwnerForCommands` для кожного каналу (необов’язково, типово `false`) змушує команди лише для власника вимагати **ідентичність власника** для виконання на цій поверхні. Якщо `true`, відправник має або збігатися з визначеним кандидатом власника (наприклад, записом у `commands.ownerAllowFrom` чи нативними метаданими власника провайдера), або мати внутрішню область доступу `operator.admin` на внутрішньому каналі повідомлень. Запис-шаблон у `allowFrom` каналу або порожній/невизначений список кандидатів власника **не** є достатнім — команди лише для власника на цьому каналі безумовно блокуються. Залиште це вимкненим, якщо хочете, щоб команди лише для власника обмежувалися лише `ownerAllowFrom` і стандартними списками дозволених команд.
|
||||
- `commands.ownerDisplay` керує тим, як ідентифікатори власника відображаються в системному промпті: `raw` або `hash`.
|
||||
- `commands.ownerDisplaySecret` необов’язково задає секрет HMAC, який використовується, коли `commands.ownerDisplay="hash"`.
|
||||
- `commands.allowFrom` (необов’язково) задає allowlist для окремих провайдерів для авторизації команд. Якщо його налаштовано, це
|
||||
єдине джерело авторизації для команд і директив (allowlist каналу/пейринг і `commands.useAccessGroups`
|
||||
ігноруються). Використовуйте `"*"` для глобального значення за замовчуванням; ключі окремих провайдерів мають пріоритет.
|
||||
- `commands.useAccessGroups` (за замовчуванням `true`) застосовує allowlist/політики для команд, коли `commands.allowFrom` не задано.
|
||||
- `commands.allowFrom` (необов’язково) задає список дозволених для кожного провайдера для авторизації команд. Якщо налаштовано, це
|
||||
єдине джерело авторизації для команд і директив (`commands.useAccessGroups` і списки дозволених каналу/спарювання ігноруються). Використовуйте `"*"` для глобального типового значення; ключі конкретних провайдерів його перевизначають.
|
||||
- `commands.useAccessGroups` (типово `true`) застосовує списки дозволених/політики для команд, якщо `commands.allowFrom` не задано.
|
||||
|
||||
## Список команд
|
||||
|
||||
Поточне єдине джерело істини:
|
||||
Поточне джерело істини:
|
||||
|
||||
- вбудовані команди core надходять із `src/auto-reply/commands-registry.shared.ts`
|
||||
- згенеровані dock-команди надходять із `src/auto-reply/commands-registry.data.ts`
|
||||
- команди plugin надходять із викликів `registerCommand()` у plugin
|
||||
- фактична доступність на вашому gateway усе одно залежить від прапорців config, поверхні каналу та встановлених/увімкнених plugin
|
||||
- вбудовані команди ядра надходять із `src/auto-reply/commands-registry.shared.ts`
|
||||
- згенеровані команди dock надходять із `src/auto-reply/commands-registry.data.ts`
|
||||
- команди плагінів надходять із викликів `registerCommand()` у плагінах
|
||||
- фактична доступність на вашому gateway усе одно залежить від прапорців конфігурації, поверхні каналу та встановлених/увімкнених плагінів
|
||||
|
||||
### Вбудовані команди core
|
||||
### Вбудовані команди ядра
|
||||
|
||||
Доступні сьогодні вбудовані команди:
|
||||
Вбудовані команди, доступні сьогодні:
|
||||
|
||||
- `/new [model]` починає нову сесію; `/reset` — це псевдонім скидання.
|
||||
- `/reset soft [message]` зберігає поточний транскрипт, відкидає повторно використані id сесій бекенда CLI і повторно запускає завантаження startup/system-prompt на місці.
|
||||
- `/compact [instructions]` ущільнює контекст сесії. Див. [/concepts/compaction](/uk/concepts/compaction).
|
||||
- `/new [model]` починає нову сесію; `/reset` — це псевдонім для скидання.
|
||||
- `/reset soft [message]` зберігає поточну стенограму, скидає повторно використані ідентифікатори сесій CLI backend і повторно запускає завантаження стартового/системного промпту на місці.
|
||||
- `/compact [instructions]` виконує Compaction контексту сесії. Див. [/concepts/compaction](/uk/concepts/compaction).
|
||||
- `/stop` перериває поточний запуск.
|
||||
- `/session idle <duration|off>` і `/session max-age <duration|off>` керують строком дії прив’язки треда.
|
||||
- `/think <level>` задає рівень мислення. Варіанти надходять із профілю провайдера активної моделі; типовими рівнями є `off`, `minimal`, `low`, `medium` і `high`, із користувацькими рівнями, як-от `xhigh`, `adaptive`, `max`, або двійковим `on` лише там, де це підтримується. Псевдоніми: `/thinking`, `/t`.
|
||||
- `/session idle <duration|off>` і `/session max-age <duration|off>` керують строком дії прив’язки до потоку.
|
||||
- `/think <level>` задає рівень обмірковування. Варіанти надходять із профілю провайдера активної моделі; поширені рівні: `off`, `minimal`, `low`, `medium` і `high`, а також спеціальні рівні, як-от `xhigh`, `adaptive`, `max`, або двійкове `on` лише там, де це підтримується. Псевдоніми: `/thinking`, `/t`.
|
||||
- `/verbose on|off|full` перемикає докладний вивід. Псевдонім: `/v`.
|
||||
- `/trace on|off` перемикає вивід trace plugin для поточної сесії.
|
||||
- `/trace on|off` перемикає вивід трасування Plugin для поточної сесії.
|
||||
- `/fast [status|on|off]` показує або задає швидкий режим.
|
||||
- `/reasoning [on|off|stream]` перемикає видимість reasoning. Псевдонім: `/reason`.
|
||||
- `/elevated [on|off|ask|full]` перемикає elevated-режим. Псевдонім: `/elev`.
|
||||
- `/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>` показує або задає значення exec за замовчуванням.
|
||||
- `/reasoning [on|off|stream]` перемикає видимість міркування. Псевдонім: `/reason`.
|
||||
- `/elevated [on|off|ask|full]` перемикає підвищений режим. Псевдонім: `/elev`.
|
||||
- `/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>` показує або задає типові значення exec.
|
||||
- `/model [name|#|status]` показує або задає модель.
|
||||
- `/models [provider] [page] [limit=<n>|size=<n>|all]` перелічує провайдерів або моделі для провайдера.
|
||||
- `/queue <mode>` керує поведінкою черги (`steer`, `interrupt`, `followup`, `collect`, `steer-backlog`) плюс параметрами, як-от `debounce:2s cap:25 drop:summarize`.
|
||||
- `/models [provider] [page] [limit=<n>|size=<n>|all]` показує список провайдерів або моделей для провайдера.
|
||||
- `/queue <mode>` керує поведінкою черги (`steer`, `interrupt`, `followup`, `collect`, `steer-backlog`), а також параметрами на кшталт `debounce:2s cap:25 drop:summarize`.
|
||||
- `/help` показує коротке резюме довідки.
|
||||
- `/commands` показує згенерований каталог команд.
|
||||
- `/tools [compact|verbose]` показує, що поточний агент може використовувати прямо зараз.
|
||||
- `/status` показує стан виконання/runtime, зокрема мітки `Execution`/`Runtime` і використання/квоту провайдера, коли доступно.
|
||||
- `/tasks` перелічує активні/нещодавні фонові завдання для поточної сесії.
|
||||
- `/status` показує статус виконання/середовища виконання, включно з мітками `Execution`/`Runtime` і використанням/квотою провайдера, якщо доступно.
|
||||
- `/crestodian <request>` запускає помічник налаштування та відновлення Crestodian із приватного повідомлення власника.
|
||||
- `/tasks` показує список активних/останніх фонових завдань для поточної сесії.
|
||||
- `/context [list|detail|json]` пояснює, як збирається контекст.
|
||||
- `/export-session [path]` експортує поточну сесію в HTML. Псевдонім: `/export`.
|
||||
- `/export-trajectory [path]` експортує JSONL [trajectory bundle](/uk/tools/trajectory) для поточної сесії. Псевдонім: `/trajectory`.
|
||||
- `/whoami` показує ваш id відправника. Псевдонім: `/id`.
|
||||
- `/whoami` показує ваш ідентифікатор відправника. Псевдонім: `/id`.
|
||||
- `/skill <name> [input]` запускає skill за назвою.
|
||||
- `/allowlist [list|add|remove] ...` керує записами allowlist. Лише текстова команда.
|
||||
- `/approve <id> <decision>` розв’язує запити на схвалення exec.
|
||||
- `/allowlist [list|add|remove] ...` керує записами allowlist. Лише текстовий режим.
|
||||
- `/approve <id> <decision>` вирішує запити на схвалення exec.
|
||||
- `/btw <question>` ставить побічне запитання без зміни майбутнього контексту сесії. Див. [/tools/btw](/uk/tools/btw).
|
||||
- `/subagents list|kill|log|info|send|steer|spawn` керує запусками sub-agent для поточної сесії.
|
||||
- `/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help` керує сесіями ACP і параметрами runtime.
|
||||
- `/focus <target>` прив’язує поточний тред Discord або topic/conversation Telegram до цілі сесії.
|
||||
- `/unfocus` видаляє поточну прив’язку.
|
||||
- `/agents` перелічує агентів, прив’язаних до треда, для поточної сесії.
|
||||
- `/kill <id|#|all>` перериває один або всі запущені sub-agent.
|
||||
- `/steer <id|#> <message>` надсилає керування запущеному sub-agent. Псевдонім: `/tell`.
|
||||
- `/config show|get|set|unset` читає або записує `openclaw.json`. Лише для власника. Потрібно `commands.config: true`.
|
||||
- `/mcp show|get|set|unset` читає або записує конфігурацію MCP-сервера під керуванням OpenClaw у `mcp.servers`. Лише для власника. Потрібно `commands.mcp: true`.
|
||||
- `/plugins list|inspect|show|get|install|enable|disable` інспектує або змінює стан plugin. `/plugin` — псевдонім. Запис лише для власника. Потрібно `commands.plugins: true`.
|
||||
- `/debug show|set|unset|reset` керує overrides config лише на runtime. Лише для власника. Потрібно `commands.debug: true`.
|
||||
- `/subagents list|kill|log|info|send|steer|spawn` керує запусками субагентів для поточної сесії.
|
||||
- `/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help` керує сесіями ACP і параметрами середовища виконання.
|
||||
- `/focus <target>` прив’язує потік Discord або тему/розмову Telegram до цілі сесії.
|
||||
- `/unfocus` знімає поточну прив’язку.
|
||||
- `/agents` показує список агентів, прив’язаних до потоку, для поточної сесії.
|
||||
- `/kill <id|#|all>` перериває одного або всіх запущених субагентів.
|
||||
- `/steer <id|#> <message>` надсилає керувальне повідомлення запущеному субагенту. Псевдонім: `/tell`.
|
||||
- `/config show|get|set|unset` читає або записує `openclaw.json`. Лише для власника. Потребує `commands.config: true`.
|
||||
- `/mcp show|get|set|unset` читає або записує конфігурацію MCP-сервера, якою керує OpenClaw, у `mcp.servers`. Лише для власника. Потребує `commands.mcp: true`.
|
||||
- `/plugins list|inspect|show|get|install|enable|disable` перевіряє або змінює стан плагінів. `/plugin` — псевдонім. Запис — лише для власника. Потребує `commands.plugins: true`.
|
||||
- `/debug show|set|unset|reset` керує перевизначеннями конфігурації лише під час виконання. Лише для власника. Потребує `commands.debug: true`.
|
||||
- `/usage off|tokens|full|cost` керує нижнім колонтитулом використання для кожної відповіді або виводить локальне зведення вартості.
|
||||
- `/tts on|off|status|provider|limit|summary|audio|help` керує TTS. Див. [/tools/tts](/uk/tools/tts).
|
||||
- `/restart` перезапускає OpenClaw, коли це дозволено. За замовчуванням: увімкнено; установіть `commands.restart: false`, щоб вимкнути.
|
||||
- `/restart` перезапускає OpenClaw, коли це ввімкнено. Типово: увімкнено; установіть `commands.restart: false`, щоб вимкнути.
|
||||
- `/activation mention|always` задає режим активації групи.
|
||||
- `/send on|off|inherit` задає політику надсилання. Лише для власника.
|
||||
- `/bash <command>` запускає shell-команду хоста. Лише текстова команда. Псевдонім: `! <command>`. Потрібно `commands.bash: true` плюс allowlist `tools.elevated`.
|
||||
- `!poll [sessionId]` перевіряє фонове завдання bash.
|
||||
- `!stop [sessionId]` зупиняє фонове завдання bash.
|
||||
- `/bash <command>` запускає команду оболонки на хості. Лише текстовий режим. Псевдонім: `! <command>`. Потребує `commands.bash: true` і списків дозволених `tools.elevated`.
|
||||
- `!poll [sessionId]` перевіряє фонове bash-завдання.
|
||||
- `!stop [sessionId]` зупиняє фонове bash-завдання.
|
||||
|
||||
### Згенеровані dock-команди
|
||||
|
||||
Dock-команди генеруються з channel plugin із підтримкою native-команд. Поточний вбудований набір:
|
||||
Dock-команди генеруються з channel Plugins із підтримкою нативних команд. Поточний вбудований набір:
|
||||
|
||||
- `/dock-discord` (псевдонім: `/dock_discord`)
|
||||
- `/dock-mattermost` (псевдонім: `/dock_mattermost`)
|
||||
- `/dock-slack` (псевдонім: `/dock_slack`)
|
||||
- `/dock-telegram` (псевдонім: `/dock_telegram`)
|
||||
|
||||
### Команди вбудованих plugin
|
||||
### Команди вбудованих плагінів
|
||||
|
||||
Вбудовані plugin можуть додавати більше slash-команд. Поточні вбудовані команди в цьому репозиторії:
|
||||
Вбудовані плагіни можуть додавати більше slash-команд. Поточні вбудовані команди в цьому репозиторії:
|
||||
|
||||
- `/dreaming [on|off|status|help]` перемикає memory dreaming. Див. [Dreaming](/uk/concepts/dreaming).
|
||||
- `/pair [qr|status|pending|approve|cleanup|notify]` керує потоком пейрингу/налаштування пристрою. Див. [Pairing](/uk/channels/pairing).
|
||||
- `/phone status|arm <camera|screen|writes|all> [duration]|disarm` тимчасово вмикає високоризикові команди phone node.
|
||||
- `/voice status|list [limit]|set <voiceId|name>` керує конфігурацією голосу Talk. У Discord назва native-команди — `/talkvoice`.
|
||||
- `/card ...` надсилає preset rich card для LINE. Див. [LINE](/uk/channels/line).
|
||||
- `/codex status|models|threads|resume|compact|review|account|mcp|skills` інспектує і керує вбудованим harness app-server Codex. Див. [Codex Harness](/uk/plugins/codex-harness).
|
||||
- `/dreaming [on|off|status|help]` перемикає Dreaming пам’яті. Див. [Dreaming](/uk/concepts/dreaming).
|
||||
- `/pair [qr|status|pending|approve|cleanup|notify]` керує потоком спарювання/налаштування пристрою. Див. [Спарювання](/uk/channels/pairing).
|
||||
- `/phone status|arm <camera|screen|writes|all> [duration]|disarm` тимчасово активує високоризикові команди Node телефона.
|
||||
- `/voice status|list [limit]|set <voiceId|name>` керує конфігурацією голосу Talk. У Discord нативна назва команди — `/talkvoice`.
|
||||
- `/card ...` надсилає заготовки багатих карток LINE. Див. [LINE](/uk/channels/line).
|
||||
- `/codex status|models|threads|resume|compact|review|account|mcp|skills` перевіряє та керує вбудованим harness app-server Codex. Див. [Codex Harness](/uk/plugins/codex-harness).
|
||||
- Команди лише для QQBot:
|
||||
- `/bot-ping`
|
||||
- `/bot-version`
|
||||
@ -169,74 +169,77 @@ Dock-команди генеруються з channel plugin із підтрим
|
||||
- `/bot-upgrade`
|
||||
- `/bot-logs`
|
||||
|
||||
### Динамічні команди skill
|
||||
### Динамічні команди Skills
|
||||
|
||||
Skills, які може викликати користувач, також доступні як slash-команди:
|
||||
|
||||
- `/skill <name> [input]` завжди працює як загальна точка входу.
|
||||
- skills також можуть з’являтися як прямі команди на кшталт `/prose`, коли skill/plugin їх реєструє.
|
||||
- Реєстрація native skill-команд керується `commands.nativeSkills` і `channels.<provider>.commands.nativeSkills`.
|
||||
- `/skill <name> [input]` завжди працює як універсальна точка входу.
|
||||
- skills також можуть з’являтися як прямі команди, наприклад `/prose`, коли їх реєструє skill/плагін.
|
||||
- реєстрація нативних skill-команд керується через `commands.nativeSkills` і `channels.<provider>.commands.nativeSkills`.
|
||||
|
||||
Примітки:
|
||||
|
||||
- Команди приймають необов’язковий `:` між командою та args (наприклад, `/think: high`, `/send: on`, `/help:`).
|
||||
- Команди приймають необов’язковий символ `:` між командою та аргументами (наприклад, `/think: high`, `/send: on`, `/help:`).
|
||||
- `/new <model>` приймає псевдонім моделі, `provider/model` або назву провайдера (нечіткий збіг); якщо збігу немає, текст обробляється як тіло повідомлення.
|
||||
- Для повної деталізації використання провайдера використовуйте `openclaw status --usage`.
|
||||
- Для повного розподілу використання провайдера використовуйте `openclaw status --usage`.
|
||||
- `/allowlist add|remove` потребує `commands.config=true` і враховує `configWrites` каналу.
|
||||
- У каналах із кількома обліковими записами config-орієнтовані `/allowlist --account <id>` і `/config set channels.<provider>.accounts.<id>...` також враховують `configWrites` цільового облікового запису.
|
||||
- `/usage` керує нижнім колонтитулом використання для кожної відповіді; `/usage cost` виводить локальне зведення вартості з журналів сесій OpenClaw.
|
||||
- `/restart` увімкнено за замовчуванням; установіть `commands.restart: false`, щоб вимкнути його.
|
||||
- `/plugins install <spec>` приймає ті самі специфікації plugin, що й `openclaw plugins install`: локальний path/archive, npm package або `clawhub:<pkg>`.
|
||||
- `/plugins enable|disable` оновлює config plugin і може запросити перезапуск.
|
||||
- Native-команда лише для Discord: `/vc join|leave|status` керує голосовими каналами (потребує `channels.discord.voice` і native-команд; недоступна як текстова команда).
|
||||
- Команди прив’язування тредів Discord (`/focus`, `/unfocus`, `/agents`, `/session idle`, `/session max-age`) потребують, щоб ефективні прив’язки тредів були увімкнені (`session.threadBindings.enabled` і/або `channels.discord.threadBindings.enabled`).
|
||||
- Довідник команд ACP і поведінка runtime: [ACP Agents](/uk/tools/acp-agents).
|
||||
- У каналах із кількома обліковими записами `/allowlist --account <id>` для цільової конфігурації та `/config set channels.<provider>.accounts.<id>...` також враховують `configWrites` цільового облікового запису.
|
||||
- `/usage` керує нижнім колонтитулом використання для кожної відповіді; `/usage cost` виводить локальне зведення вартості з журналів сесії OpenClaw.
|
||||
- `/restart` увімкнено типово; установіть `commands.restart: false`, щоб вимкнути його.
|
||||
- `/plugins install <spec>` приймає ті самі специфікації плагінів, що й `openclaw plugins install`: локальний шлях/архів, npm-пакет або `clawhub:<pkg>`.
|
||||
- `/plugins enable|disable` оновлює конфігурацію плагіна й може запропонувати перезапуск.
|
||||
- Нативна команда лише для Discord: `/vc join|leave|status` керує голосовими каналами (потребує `channels.discord.voice` і нативних команд; недоступна як текстова).
|
||||
- Команди прив’язки до потоку Discord (`/focus`, `/unfocus`, `/agents`, `/session idle`, `/session max-age`) потребують, щоб ефективні прив’язки до потоку були увімкнені (`session.threadBindings.enabled` і/або `channels.discord.threadBindings.enabled`).
|
||||
- Довідник команд ACP і поведінка середовища виконання: [ACP Agents](/uk/tools/acp-agents).
|
||||
- `/verbose` призначено для налагодження та додаткової видимості; у звичайному використанні тримайте його **вимкненим**.
|
||||
- `/trace` вужчий за `/verbose`: він показує лише trace/debug-рядки, що належать plugin, і не вмикає звичайний докладний шум від tool.
|
||||
- `/fast on|off` зберігає override сесії. Використовуйте параметр `inherit` в інтерфейсі Sessions, щоб очистити його і повернутися до значень config за замовчуванням.
|
||||
- `/fast` залежить від провайдера: OpenAI/OpenAI Codex відображають його як `service_tier=priority` у native endpoint Responses, тоді як прямі публічні запити Anthropic, зокрема OAuth-автентифікований трафік до `api.anthropic.com`, відображають його як `service_tier=auto` або `standard_only`. Див. [OpenAI](/uk/providers/openai) і [Anthropic](/uk/providers/anthropic).
|
||||
- Підсумки збоїв tool усе ще показуються, коли це доречно, але детальний текст збоїв включається лише тоді, коли `/verbose` має значення `on` або `full`.
|
||||
- `/reasoning`, `/verbose` і `/trace` ризиковані в групових налаштуваннях: вони можуть розкрити внутрішнє reasoning, вивід tool або діагностику plugin, яку ви не збиралися показувати. Краще залишати їх вимкненими, особливо в групових чатах.
|
||||
- `/trace` вужчий за `/verbose`: він показує лише рядки трасування/налагодження, що належать плагінам, і не вмикає звичайну багатослівну балаканину інструментів.
|
||||
- `/fast on|off` зберігає перевизначення сесії. Використовуйте параметр `inherit` в інтерфейсі Sessions, щоб очистити його та повернутися до типових значень конфігурації.
|
||||
- `/fast` залежить від провайдера: OpenAI/OpenAI Codex зіставляють його з `service_tier=priority` у нативних endpoint Responses, тоді як прямі публічні запити Anthropic, зокрема трафік з OAuth-аутентифікацією, надісланий до `api.anthropic.com`, зіставляють його з `service_tier=auto` або `standard_only`. Див. [OpenAI](/uk/providers/openai) і [Anthropic](/uk/providers/anthropic).
|
||||
- Зведення про збої інструментів усе ще показуються, коли це доречно, але докладний текст помилок включається лише коли `/verbose` має значення `on` або `full`.
|
||||
- `/reasoning`, `/verbose` і `/trace` ризиковані в групових середовищах: вони можуть розкрити внутрішнє міркування, вивід інструментів або діагностику плагінів, які ви не збиралися показувати. Краще залишати їх вимкненими, особливо в групових чатах.
|
||||
- `/model` негайно зберігає нову модель сесії.
|
||||
- Якщо агент неактивний, наступний запуск одразу її використовує.
|
||||
- Якщо запуск уже активний, OpenClaw позначає live-перемикання як відкладене і перезапускає з новою моделлю лише в чистій точці повторної спроби.
|
||||
- Якщо активність tool або вивід відповіді вже почалися, відкладене перемикання може залишатися в черзі до пізнішої можливості повторної спроби або до наступного ходу користувача.
|
||||
- **Швидкий шлях:** повідомлення лише з командою від allowlisted-відправників обробляються негайно (в обхід черги + моделі).
|
||||
- **Обмеження згадок у групах:** повідомлення лише з командою від allowlisted-відправників обходять вимоги згадок.
|
||||
- **Вбудовані shortcut (лише для allowlisted-відправників):** певні команди також працюють, коли вбудовані у звичайне повідомлення, і видаляються до того, як модель побачить решту тексту.
|
||||
- Приклад: `hey /status` викликає відповідь зі статусом, а решта тексту продовжує проходити звичайний потік.
|
||||
- Якщо агент простоює, наступний запуск одразу її використовує.
|
||||
- Якщо запуск уже активний, OpenClaw позначає перемикання наживо як таке, що очікує, і перезапускається в нову модель лише в чистій точці повторної спроби.
|
||||
- Якщо активність інструментів або вивід відповіді вже почалися, відкладене перемикання може залишатися в черзі до наступної можливості повторної спроби або до наступного ходу користувача.
|
||||
- У локальному TUI `/crestodian [request]` повертає зі звичайного TUI агента до
|
||||
Crestodian. Це окремо від аварійного режиму каналу повідомлень і не
|
||||
надає віддалених повноважень на зміну конфігурації.
|
||||
- **Швидкий шлях:** повідомлення лише з командами від відправників зі списку дозволених обробляються негайно (обхід черги + моделі).
|
||||
- **Обмеження згадуванням у групі:** повідомлення лише з командами від відправників зі списку дозволених обходять вимоги щодо згадування.
|
||||
- **Вбудовані скорочення (лише для відправників зі списку дозволених):** деякі команди також працюють, коли вбудовані в звичайне повідомлення, і вилучаються до того, як модель побачить решту.
|
||||
- Приклад: `hey /status` викликає відповідь зі статусом, а решта тексту продовжує проходити звичайний потік обробки.
|
||||
- Наразі: `/help`, `/commands`, `/status`, `/whoami` (`/id`).
|
||||
- Неавторизовані повідомлення лише з командою тихо ігноруються, а вбудовані токени `/...` трактуються як звичайний текст.
|
||||
- **Команди skill:** Skills з `user-invocable` доступні як slash-команди. Назви очищаються до `a-z0-9_` (максимум 32 символи); у разі колізій додаються числові суфікси (наприклад, `_2`).
|
||||
- `/skill <name> [input]` запускає skill за назвою (це зручно, коли обмеження native-команд не дозволяють мати окремі команди для кожного skill).
|
||||
- За замовчуванням команди skill пересилаються моделі як звичайний запит.
|
||||
- Skills можуть необов’язково оголосити `command-dispatch: tool`, щоб маршрутизувати команду безпосередньо до tool (детерміновано, без моделі).
|
||||
- Приклад: `/prose` (plugin OpenProse) — див. [OpenProse](/uk/prose).
|
||||
- **Args native-команд:** Discord використовує autocomplete для динамічних параметрів (і меню кнопок, коли ви пропускаєте обов’язкові args). Telegram і Slack показують меню кнопок, коли команда підтримує варіанти вибору, а ви пропускаєте arg.
|
||||
- Неавторизовані повідомлення лише з командами мовчки ігноруються, а вбудовані токени `/...` обробляються як звичайний текст.
|
||||
- **Команди Skills:** skills із типом `user-invocable` також доступні як slash-команди. Назви очищуються до `a-z0-9_` (максимум 32 символи); у разі колізій додаються числові суфікси (наприклад, `_2`).
|
||||
- `/skill <name> [input]` запускає skill за назвою (це корисно, коли обмеження нативних команд не дають створити команду для кожного skill окремо).
|
||||
- Типово команди skill пересилаються моделі як звичайний запит.
|
||||
- Skills можуть необов’язково оголошувати `command-dispatch: tool`, щоб маршрутизувати команду безпосередньо до інструмента (детерміновано, без моделі).
|
||||
- Приклад: `/prose` (плагін OpenProse) — див. [OpenProse](/uk/prose).
|
||||
- **Аргументи нативних команд:** Discord використовує автодоповнення для динамічних параметрів (і меню кнопок, якщо пропущено обов’язкові аргументи). Telegram і Slack показують меню кнопок, коли команда підтримує вибір значень, а аргумент пропущено.
|
||||
|
||||
## `/tools`
|
||||
|
||||
`/tools` відповідає на питання runtime, а не config: **що цей агент може використовувати прямо зараз у
|
||||
`/tools` відповідає на запитання про середовище виконання, а не про конфігурацію: **що цей агент може використовувати прямо зараз у
|
||||
цій розмові**.
|
||||
|
||||
- `/tools` за замовчуванням компактний і оптимізований для швидкого перегляду.
|
||||
- Типовий `/tools` компактний і оптимізований для швидкого перегляду.
|
||||
- `/tools verbose` додає короткі описи.
|
||||
- Поверхні native-команд, які підтримують аргументи, мають той самий перемикач режимів `compact|verbose`.
|
||||
- Результати прив’язані до сесії, тому зміна агента, каналу, треда, авторизації відправника або моделі може
|
||||
- Поверхні нативних команд, що підтримують аргументи, надають той самий перемикач режиму `compact|verbose`.
|
||||
- Результати мають межі сесії, тому зміна агента, каналу, потоку, авторизації відправника або моделі може
|
||||
змінити вивід.
|
||||
- `/tools` включає tool, які реально доступні в runtime, зокрема core tool, підключені
|
||||
tool plugin і tool, що належать каналу.
|
||||
- `/tools` включає інструменти, які справді досяжні під час виконання, зокрема базові інструменти, підключені
|
||||
інструменти плагінів і інструменти, що належать каналу.
|
||||
|
||||
Для редагування профілів та overrides використовуйте панель Tools у Control UI або поверхні config/catalog, а не
|
||||
сприймайте `/tools` як статичний каталог.
|
||||
Для редагування профілів і перевизначень використовуйте панель Tools в інтерфейсі керування або поверхні конфігурації/каталогу,
|
||||
а не ставтеся до `/tools` як до статичного каталогу.
|
||||
|
||||
## Поверхні використання (що де показується)
|
||||
|
||||
- **Використання/квота провайдера** (приклад: «Claude 80% left») показується в `/status` для поточного провайдера моделі, коли відстеження використання ввімкнене. OpenClaw нормалізує вікна провайдера до `% left`; для MiniMax поля відсотків лише для залишку інвертуються перед показом, а відповіді `model_remains` віддають перевагу запису chat-model плюс мітці плану з тегом моделі.
|
||||
- **Рядки token/cache** у `/status` можуть повертатися до останнього запису використання в транскрипті, коли live-знімок сесії бідний на дані. Наявні ненульові live-значення все одно мають пріоритет, а fallback до транскрипту також може відновити мітку активної runtime-моделі плюс більше загальне значення, орієнтоване на prompt, коли збережені підсумки відсутні або менші.
|
||||
- **Execution vs runtime:** `/status` показує `Execution` для ефективного шляху sandbox і `Runtime` для того, хто фактично виконує сесію: `OpenClaw Pi Default`, `OpenAI Codex`, бекенд CLI або бекенд ACP.
|
||||
- **Кількість token/вартість на відповідь** контролюється через `/usage off|tokens|full` (додається до звичайних відповідей).
|
||||
- `/model status` стосується **моделей/auth/endpoint**, а не використання.
|
||||
- **Використання/квота провайдера** (приклад: «Claude 80% left») відображається в `/status` для провайдера поточної моделі, якщо ввімкнено відстеження використання. OpenClaw нормалізує вікна провайдера до `% left`; для MiniMax поля відсотка лише залишку інвертуються перед показом, а відповіді `model_remains` віддають перевагу запису моделі чату разом із міткою плану, прив’язаною до моделі.
|
||||
- **Рядки токенів/кешу** в `/status` можуть повертатися до останнього запису використання зі стенограми, якщо поточний знімок сесії бідний на дані. Наявні ненульові значення в реальному часі все одно мають пріоритет, а резервний варіант зі стенограми також може відновити мітку активної моделі середовища виконання разом із більшим загальним значенням, орієнтованим на промпт, коли збережені підсумки відсутні або менші.
|
||||
- **Execution проти runtime:** `/status` повідомляє `Execution` для ефективного шляху sandbox і `Runtime` для того, хто фактично виконує сесію: `OpenClaw Pi Default`, `OpenAI Codex`, CLI backend або ACP backend.
|
||||
- **Токени/вартість для кожної відповіді** керуються через `/usage off|tokens|full` (додаються до звичайних відповідей).
|
||||
- `/model status` стосується **моделей/автентифікації/endpoint**, а не використання.
|
||||
|
||||
## Вибір моделі (`/model`)
|
||||
|
||||
@ -244,7 +247,7 @@ Skills, які може викликати користувач, також до
|
||||
|
||||
Приклади:
|
||||
|
||||
```text
|
||||
```
|
||||
/model
|
||||
/model list
|
||||
/model 3
|
||||
@ -255,18 +258,18 @@ Skills, які може викликати користувач, також до
|
||||
|
||||
Примітки:
|
||||
|
||||
- `/model` і `/model list` показують компактний нумерований picker (сімейство моделей + доступні провайдери).
|
||||
- У Discord `/model` і `/models` відкривають інтерактивний picker із випадаючими списками провайдера та моделі плюс кроком Submit.
|
||||
- `/model <#>` вибирає з цього picker (і, якщо можливо, віддає перевагу поточному провайдеру).
|
||||
- `/model status` показує детальний вигляд, зокрема налаштований endpoint провайдера (`baseUrl`) і режим API (`api`), коли вони доступні.
|
||||
- `/model` і `/model list` показують компактний, пронумерований вибір (сімейство моделей + доступні провайдери).
|
||||
- У Discord `/model` і `/models` відкривають інтерактивний вибір із випадними списками провайдера та моделі, а також кроком Submit.
|
||||
- `/model <#>` вибирає зі цього списку (і за можливості віддає перевагу поточному провайдеру).
|
||||
- `/model status` показує докладний вигляд, зокрема налаштований endpoint провайдера (`baseUrl`) і режим API (`api`), якщо доступно.
|
||||
|
||||
## Debug overrides
|
||||
## Перевизначення для налагодження
|
||||
|
||||
`/debug` дає змогу задавати overrides config **лише для runtime** (у пам’яті, не на диску). Лише для власника. За замовчуванням вимкнено; увімкніть через `commands.debug: true`.
|
||||
`/debug` дає змогу задавати перевизначення конфігурації **лише під час виконання** (пам’ять, не диск). Лише для власника. Типово вимкнено; увімкніть через `commands.debug: true`.
|
||||
|
||||
Приклади:
|
||||
|
||||
```text
|
||||
```
|
||||
/debug show
|
||||
/debug set messages.responsePrefix="[openclaw]"
|
||||
/debug set channels.whatsapp.allowFrom=["+1555","+4477"]
|
||||
@ -276,12 +279,12 @@ Skills, які може викликати користувач, також до
|
||||
|
||||
Примітки:
|
||||
|
||||
- Overrides застосовуються негайно до нових читань config, але **не** записуються в `openclaw.json`.
|
||||
- Використовуйте `/debug reset`, щоб очистити всі overrides і повернутися до config на диску.
|
||||
- Перевизначення застосовуються негайно до нових читань конфігурації, але **не** записуються в `openclaw.json`.
|
||||
- Використовуйте `/debug reset`, щоб очистити всі перевизначення та повернутися до конфігурації на диску.
|
||||
|
||||
## Вивід trace plugin
|
||||
## Вивід трасування плагіна
|
||||
|
||||
`/trace` дає змогу вмикати **trace/debug-рядки plugin у межах сесії** без увімкнення повного verbose-режиму.
|
||||
`/trace` дає змогу перемикати **рядки трасування/налагодження плагіна в межах сесії** без увімкнення повного багатослівного режиму.
|
||||
|
||||
Приклади:
|
||||
|
||||
@ -293,20 +296,20 @@ Skills, які може викликати користувач, також до
|
||||
|
||||
Примітки:
|
||||
|
||||
- `/trace` без аргументу показує поточний стан trace для сесії.
|
||||
- `/trace on` вмикає рядки trace plugin для поточної сесії.
|
||||
- `/trace off` знову їх вимикає.
|
||||
- Рядки trace plugin можуть з’являтися в `/status` і як діагностичне follow-up повідомлення після звичайної відповіді асистента.
|
||||
- `/trace` не замінює `/debug`; `/debug` і далі керує overrides config лише для runtime.
|
||||
- `/trace` не замінює `/verbose`; звичайний докладний вивід tool/status і далі належить `/verbose`.
|
||||
- `/trace` без аргументу показує поточний стан трасування сесії.
|
||||
- `/trace on` вмикає рядки трасування плагіна для поточної сесії.
|
||||
- `/trace off` знову вимикає їх.
|
||||
- Рядки трасування плагіна можуть з’являтися в `/status` і як додаткове діагностичне повідомлення після звичайної відповіді асистента.
|
||||
- `/trace` не замінює `/debug`; `/debug` усе ще керує перевизначеннями конфігурації лише під час виконання.
|
||||
- `/trace` не замінює `/verbose`; звичайний багатослівний вивід інструментів/статусу й далі належить `/verbose`.
|
||||
|
||||
## Оновлення Config
|
||||
## Оновлення конфігурації
|
||||
|
||||
`/config` записує в config на диску (`openclaw.json`). Лише для власника. За замовчуванням вимкнено; увімкніть через `commands.config: true`.
|
||||
`/config` записує до вашої конфігурації на диску (`openclaw.json`). Лише для власника. Типово вимкнено; увімкніть через `commands.config: true`.
|
||||
|
||||
Приклади:
|
||||
|
||||
```text
|
||||
```
|
||||
/config show
|
||||
/config show messages.responsePrefix
|
||||
/config get messages.responsePrefix
|
||||
@ -316,12 +319,12 @@ Skills, які може викликати користувач, також до
|
||||
|
||||
Примітки:
|
||||
|
||||
- Перед записом config проходить валідацію; некоректні зміни відхиляються.
|
||||
- Перед записом конфігурація перевіряється; невалідні зміни відхиляються.
|
||||
- Оновлення `/config` зберігаються після перезапусків.
|
||||
|
||||
## Оновлення MCP
|
||||
|
||||
`/mcp` записує визначення MCP-серверів під керуванням OpenClaw у `mcp.servers`. Лише для власника. За замовчуванням вимкнено; увімкніть через `commands.mcp: true`.
|
||||
`/mcp` записує визначення MCP-серверів, якими керує OpenClaw, у `mcp.servers`. Лише для власника. Типово вимкнено; увімкніть через `commands.mcp: true`.
|
||||
|
||||
Приклади:
|
||||
|
||||
@ -334,12 +337,12 @@ Skills, які може викликати користувач, також до
|
||||
|
||||
Примітки:
|
||||
|
||||
- `/mcp` зберігає config у config OpenClaw, а не в налаштуваннях проєкту, якими володіє Pi.
|
||||
- Runtime-адаптери вирішують, які транспорти реально можна виконувати.
|
||||
- `/mcp` зберігає конфігурацію в конфігурації OpenClaw, а не в налаштуваннях проєкту, що належать Pi.
|
||||
- Адаптери середовища виконання вирішують, які саме транспорти реально можна виконувати.
|
||||
|
||||
## Оновлення Plugin
|
||||
## Оновлення плагінів
|
||||
|
||||
`/plugins` дозволяє операторам інспектувати виявлені plugin і перемикати стан увімкнення в config. Потоки лише для читання можуть використовувати `/plugin` як псевдонім. За замовчуванням вимкнено; увімкніть через `commands.plugins: true`.
|
||||
`/plugins` дає змогу операторам перевіряти знайдені плагіни та перемикати стан увімкнення в конфігурації. Потоки лише для читання можуть використовувати `/plugin` як псевдонім. Типово вимкнено; увімкніть через `commands.plugins: true`.
|
||||
|
||||
Приклади:
|
||||
|
||||
@ -353,31 +356,31 @@ Skills, які може викликати користувач, також до
|
||||
|
||||
Примітки:
|
||||
|
||||
- `/plugins list` і `/plugins show` використовують реальне виявлення plugin у поточному workspace плюс config на диску.
|
||||
- `/plugins enable|disable` оновлює лише config plugin; він не встановлює і не видаляє plugin.
|
||||
- Після змін enable/disable перезапустіть gateway, щоб застосувати їх.
|
||||
- `/plugins list` і `/plugins show` використовують реальне виявлення плагінів у поточному робочому просторі разом із конфігурацією на диску.
|
||||
- `/plugins enable|disable` оновлює лише конфігурацію плагіна; він не встановлює й не видаляє плагіни.
|
||||
- Після змін `enable/disable` перезапустіть gateway, щоб застосувати їх.
|
||||
|
||||
## Примітки щодо поверхонь
|
||||
|
||||
- **Текстові команди** працюють у звичайній чат-сесії (DM використовують `main`, групи мають власну сесію).
|
||||
- **Native-команди** використовують ізольовані сесії:
|
||||
- **Текстові команди** працюють у звичайній чат-сесії (приватні повідомлення використовують `main`, групи мають власну сесію).
|
||||
- **Нативні команди** використовують ізольовані сесії:
|
||||
- Discord: `agent:<agentId>:discord:slash:<userId>`
|
||||
- Slack: `agent:<agentId>:slack:slash:<userId>` (префікс налаштовується через `channels.slack.slashCommand.sessionPrefix`)
|
||||
- Telegram: `telegram:slash:<userId>` (націлюється на чат-сесію через `CommandTargetSessionKey`)
|
||||
- **`/stop`** націлюється на активну чат-сесію, щоб можна було перервати поточний запуск.
|
||||
- **Slack:** `channels.slack.slashCommand` усе ще підтримується для однієї команди в стилі `/openclaw`. Якщо ви вмикаєте `commands.native`, потрібно створити одну slash-команду Slack для кожної вбудованої команди (з тими самими назвами, що й `/help`). Меню аргументів команд для Slack доставляються як ефемерні кнопки Block Kit.
|
||||
- Виняток native для Slack: реєструйте `/agentstatus` (а не `/status`), оскільки Slack резервує `/status`. Текстова `/status` у повідомленнях Slack усе ще працює.
|
||||
- Telegram: `telegram:slash:<userId>` (спрямовується на чат-сесію через `CommandTargetSessionKey`)
|
||||
- **`/stop`** націлюється на активну чат-сесію, щоб перервати поточний запуск.
|
||||
- **Slack:** `channels.slack.slashCommand` усе ще підтримується для однієї команди стилю `/openclaw`. Якщо ви вмикаєте `commands.native`, потрібно створити одну slash-команду Slack для кожної вбудованої команди (з тими самими назвами, що й `/help`). Меню аргументів команд для Slack доставляються як ефемерні кнопки Block Kit.
|
||||
- Виняток для нативних команд Slack: зареєструйте `/agentstatus` (а не `/status`), оскільки Slack резервує `/status`. Текстова `/status` у повідомленнях Slack усе одно працює.
|
||||
|
||||
## BTW side questions
|
||||
## Побічні запитання BTW
|
||||
|
||||
`/btw` — це швидке **побічне запитання** щодо поточної сесії.
|
||||
`/btw` — це швидке **побічне запитання** про поточну сесію.
|
||||
|
||||
На відміну від звичайного чату:
|
||||
|
||||
- воно використовує поточну сесію як фоновий контекст,
|
||||
- виконується як окремий **одноразовий** виклик без tool,
|
||||
- виконується як окремий одноразовий виклик **без інструментів**,
|
||||
- не змінює майбутній контекст сесії,
|
||||
- не записується в історію транскрипту,
|
||||
- не записується в історію стенограми,
|
||||
- доставляється як живий побічний результат, а не як звичайне повідомлення асистента.
|
||||
|
||||
Це робить `/btw` корисним, коли вам потрібне тимчасове уточнення, поки основне
|
||||
@ -389,11 +392,11 @@ Skills, які може викликати користувач, також до
|
||||
/btw what are we doing right now?
|
||||
```
|
||||
|
||||
Див. [BTW Side Questions](/uk/tools/btw) для повного опису поведінки та деталей UX
|
||||
клієнта.
|
||||
Див. [BTW Side Questions](/uk/tools/btw), щоб ознайомитися з повною поведінкою та
|
||||
подробицями UX клієнта.
|
||||
|
||||
## Пов’язане
|
||||
|
||||
- [Skills](/uk/tools/skills)
|
||||
- [Skills config](/uk/tools/skills-config)
|
||||
- [Creating skills](/uk/tools/creating-skills)
|
||||
- [Конфігурація Skills](/uk/tools/skills-config)
|
||||
- [Створення Skills](/uk/tools/creating-skills)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user