From 0bc0f101036c3a7f3f3dfcf23562d06ea844572d Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Sun, 26 Apr 2026 21:54:50 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/install/docker.md | 268 ++++++++++++++++++------------------ docs/uk/providers/ollama.md | 222 ++++++++++++++--------------- docs/uk/tools/thinking.md | 123 +++++++++-------- 3 files changed, 308 insertions(+), 305 deletions(-) diff --git a/docs/uk/install/docker.md b/docs/uk/install/docker.md index b7e285d71..170abaa26 100644 --- a/docs/uk/install/docker.md +++ b/docs/uk/install/docker.md @@ -5,36 +5,36 @@ read_when: summary: Необов’язкове налаштування та онбординг OpenClaw на основі Docker title: Docker x-i18n: - generated_at: "2026-04-26T21:44:10Z" + generated_at: "2026-04-26T21:53:32Z" model: gpt-5.4 provider: openai - source_hash: fd8a20ac45744bb02a324de86f9b374ca1a96d7c6be2b6216967813bf0139fd5 + source_hash: 66e79a53377c394ed581b856ee65946bc2a08a6fe66a85ed4f46fd4c7635e5e0 source_path: install/docker.md workflow: 15 --- -Docker є **необов’язковим**. Використовуйте його лише тоді, коли вам потрібен контейнеризований Gateway або якщо ви хочете перевірити Docker-потік. +Docker **необов’язковий**. Використовуйте його лише якщо вам потрібен контейнеризований Gateway або якщо ви хочете перевірити потік Docker. ## Чи підходить мені Docker? -- **Так**: вам потрібне ізольоване, тимчасове середовище Gateway або ви хочете запускати OpenClaw на хості без локальних встановлень. -- **Ні**: ви працюєте на власній машині й просто хочете найшвидший цикл розробки. Натомість скористайтеся звичайним потоком встановлення. -- **Примітка щодо ізоляції**: типовий бекенд sandbox використовує Docker, коли ізоляцію ввімкнено, але за замовчуванням ізоляція вимкнена і **не** вимагає запуску всього Gateway у Docker. Також доступні бекенди sandbox SSH і OpenShell. Див. [Ізоляція](/uk/gateway/sandboxing). +- **Так**: вам потрібне ізольоване, тимчасове середовище Gateway або ви хочете запустити OpenClaw на хості без локальних встановлень. +- **Ні**: ви запускаєте все на власній машині й просто хочете найшвидший цикл розробки. Натомість використовуйте звичайний потік встановлення. +- **Примітка щодо пісочниці**: типовий бекенд пісочниці використовує Docker, коли пісочницю ввімкнено, але пісочниця за замовчуванням вимкнена і **не** вимагає запуску всього Gateway у Docker. Також доступні бекенди пісочниці SSH і OpenShell. Див. [Пісочниця](/uk/gateway/sandboxing). ## Передумови - Docker Desktop (або Docker Engine) + Docker Compose v2 -- Щонайменше 2 ГБ RAM для збирання образу (`pnpm install` може бути примусово завершено через OOM на хостах із 1 ГБ із кодом виходу 137) +- Щонайменше 2 ГБ RAM для збирання образу (`pnpm install` може бути примусово завершено через OOM на хостах із 1 ГБ з кодом виходу 137) - Достатньо місця на диску для образів і журналів -- Якщо запуск відбувається на VPS/публічному хості, перегляньте - [Посилення безпеки для мережевої експозиції](/uk/gateway/security), +- Якщо запускаєте на VPS/публічному хості, перегляньте + [Посилення безпеки для мережевої доступності](/uk/gateway/security), особливо політику брандмауера Docker `DOCKER-USER`. ## Контейнеризований Gateway - Із кореня репозиторію запустіть скрипт налаштування: + У корені репозиторію виконайте скрипт налаштування: ```bash ./scripts/docker/setup.sh @@ -54,14 +54,14 @@ Docker є **необов’язковим**. Використовуйте йог - Скрипт налаштування автоматично запускає онбординг. Він: + Скрипт налаштування запускає онбординг автоматично. Він: - - запропонує ввести ключі API провайдерів + - запитає API-ключі провайдера - згенерує токен Gateway і запише його в `.env` - запустить Gateway через Docker Compose - Під час налаштування онбординг перед стартом і записи конфігурації виконуються безпосередньо через - `openclaw-gateway`. `openclaw-cli` призначений для команд, які ви запускаєте після того, + Під час налаштування онбординг до старту та запис конфігурації виконуються + безпосередньо через `openclaw-gateway`. `openclaw-cli` призначений для команд, які ви виконуєте після того, як контейнер Gateway уже існує. @@ -80,7 +80,7 @@ Docker є **необов’язковим**. Використовуйте йог - Використовуйте контейнер CLI, щоб додати канали обміну повідомленнями: + Використайте контейнер CLI, щоб додати канали обміну повідомленнями: ```bash # WhatsApp (QR) @@ -100,7 +100,7 @@ Docker є **необов’язковим**. Використовуйте йог ### Ручний потік -Якщо ви віддаєте перевагу запуску кожного кроку самостійно замість використання скрипта налаштування: +Якщо ви віддаєте перевагу виконанню кожного кроку вручну замість використання скрипта налаштування: ```bash docker build -t openclaw:local -f Dockerfile . @@ -118,9 +118,9 @@ docker compose up -d openclaw-gateway -Оскільки `openclaw-cli` використовує той самий простір імен мережі, що й `openclaw-gateway`, це -інструмент після запуску. До `docker compose up -d openclaw-gateway` виконуйте онбординг -і записи конфігурації на етапі налаштування через `openclaw-gateway` з +Оскільки `openclaw-cli` використовує той самий простір мережевих імен, що й `openclaw-gateway`, це +інструмент для використання після старту. До `docker compose up -d openclaw-gateway` виконуйте онбординг +і запис конфігурації на етапі налаштування через `openclaw-gateway` з `--no-deps --entrypoint node`. @@ -128,35 +128,36 @@ docker compose up -d openclaw-gateway Скрипт налаштування приймає такі необов’язкові змінні середовища: -| Variable | Purpose | -| ------------------------------------------ | --------------------------------------------------------------- | -| `OPENCLAW_IMAGE` | Використати віддалений образ замість локального збирання | -| `OPENCLAW_DOCKER_APT_PACKAGES` | Установити додаткові apt-пакунки під час збирання (назви через пробіл) | -| `OPENCLAW_EXTENSIONS` | Попередньо встановити залежності Plugin під час збирання (назви через пробіл) | -| `OPENCLAW_EXTRA_MOUNTS` | Додаткові bind-монтування хоста (через кому у форматі `source:target[:opts]`) | -| `OPENCLAW_HOME_VOLUME` | Зберігати `/home/node` в іменованому Docker-томі | -| `OPENCLAW_SANDBOX` | Увімкнути початкове налаштування sandbox (`1`, `true`, `yes`, `on`) | -| `OPENCLAW_DOCKER_SOCKET` | Перевизначити шлях до Docker socket | -| `OPENCLAW_DISABLE_BONJOUR` | Вимкнути рекламу Bonjour/mDNS (для Docker за замовчуванням `1`) | -| `OPENCLAW_DISABLE_BUNDLED_SOURCE_OVERLAYS` | Вимкнути bind-mount overlay для вихідного коду вбудованих Plugin | -| `OTEL_EXPORTER_OTLP_ENDPOINT` | Спільна кінцева точка колектора OTLP/HTTP для експорту OpenTelemetry | -| `OTEL_EXPORTER_OTLP_*_ENDPOINT` | Кінцеві точки OTLP для конкретних сигналів трасування, метрик або журналів | +| Variable | Purpose | +| ------------------------------------------ | ---------------------------------------------------------------- | +| `OPENCLAW_IMAGE` | Використати віддалений образ замість локального збирання | +| `OPENCLAW_DOCKER_APT_PACKAGES` | Встановити додаткові apt-пакети під час збирання (через пробіл) | +| `OPENCLAW_EXTENSIONS` | Попередньо встановити залежності плагінів під час збирання (назви через пробіл) | +| `OPENCLAW_EXTRA_MOUNTS` | Додаткові bind mount-и хоста (через кому `source:target[:opts]`) | +| `OPENCLAW_HOME_VOLUME` | Зберігати `/home/node` в іменованому Docker volume | +| `OPENCLAW_SANDBOX` | Увімкнути початкове налаштування пісочниці (`1`, `true`, `yes`, `on`) | +| `OPENCLAW_DOCKER_SOCKET` | Перевизначити шлях до сокета Docker | +| `OPENCLAW_DISABLE_BONJOUR` | Вимкнути рекламу Bonjour/mDNS (для Docker за замовчуванням `1`) | +| `OPENCLAW_DISABLE_BUNDLED_SOURCE_OVERLAYS` | Вимкнути bind-mount overlay для вбудованих вихідних кодів плагінів | +| `OTEL_EXPORTER_OTLP_ENDPOINT` | Спільна адреса OTLP/HTTP collector для експорту OpenTelemetry | +| `OTEL_EXPORTER_OTLP_*_ENDPOINT` | Окремі адреси OTLP для трас, метрик або журналів | | `OTEL_EXPORTER_OTLP_PROTOCOL` | Перевизначення протоколу OTLP. Наразі підтримується лише `http/protobuf` | -| `OTEL_SERVICE_NAME` | Назва сервісу, що використовується для ресурсів OpenTelemetry | -| `OTEL_SEMCONV_STABILITY_OPT_IN` | Увімкнути найновіші експериментальні семантичні атрибути GenAI | -| `OPENCLAW_OTEL_PRELOADED` | Не запускати другий SDK OpenTelemetry, якщо один уже попередньо завантажено | +| `OTEL_SERVICE_NAME` | Назва сервісу для ресурсів OpenTelemetry | +| `OTEL_SEMCONV_STABILITY_OPT_IN` | Увімкнути найновіші експериментальні семантичні атрибути GenAI | +| `OPENCLAW_OTEL_PRELOADED` | Не запускати другий OpenTelemetry SDK, якщо один уже попередньо завантажено | -Супровідники можуть тестувати вихідний код вбудованого Plugin на основі пакетованого образу, змонтувавши -один каталог вихідного коду Plugin поверх його пакетованого шляху вихідного коду, наприклад +Супроводжувачі можуть тестувати вихідний код вбудованого плагіна з упакованим образом, змонтувавши +один каталог вихідного коду плагіна поверх його упакованого шляху до вихідного коду, наприклад `OPENCLAW_EXTRA_MOUNTS=/path/to/fork/extensions/synology-chat:/app/extensions/synology-chat:ro`. -Цей змонтований каталог вихідного коду перевизначає відповідний скомпільований -пакет `/app/dist/extensions/synology-chat` для того самого ідентифікатора Plugin. +Цей змонтований каталог вихідного коду перевизначає відповідний зібраний +бандл `/app/dist/extensions/synology-chat` для того самого ідентифікатора плагіна. ### Спостережуваність Експорт OpenTelemetry є вихідним із контейнера Gateway до вашого OTLP -колектора. Для цього не потрібен опублікований порт Docker. Якщо ви локально збираєте образ і хочете, щоб вбудований експортер OpenTelemetry був доступний усередині образу, -додайте його залежності виконання: +collector. Для цього не потрібен опублікований порт Docker. Якщо ви локально збираєте образ +і хочете, щоб у ньому був доступний вбудований експортер OpenTelemetry, +додайте його залежності часу виконання: ```bash export OPENCLAW_EXTENSIONS="diagnostics-otel" @@ -165,40 +166,41 @@ export OTEL_SERVICE_NAME="openclaw-gateway" ./scripts/docker/setup.sh ``` -Офіційний Docker-образ релізу OpenClaw містить вихідний код вбудованого -Plugin `diagnostics-otel`. Залежно від образу та стану кешу, -Gateway може все одно підготувати локальні залежності виконання OpenTelemetry Plugin -під час першого ввімкнення Plugin, тому дозвольте під час першого запуску доступ до -реєстру пакунків або попередньо прогрійте образ у вашому релізному потоці. Щоб увімкнути експорт, дозвольте та -увімкніть Plugin `diagnostics-otel` у конфігурації, а потім задайте +Офіційний релізний Docker-образ OpenClaw містить вбудований вихідний код плагіна +`diagnostics-otel`. Залежно від образу та стану кешу, +Gateway може все ще підготувати локальні залежності часу виконання OpenTelemetry для плагіна +під час першого ввімкнення плагіна, тому дозвольте цьому першому завантаженню мати доступ до +реєстру пакетів або попередньо прогрійте образ у вашому релізному конвеєрі. Щоб увімкнути експорт, дозвольте і +увімкніть плагін `diagnostics-otel` у конфігурації, а потім встановіть `diagnostics.otel.enabled=true` або використайте приклад конфігурації в -[Експорт OpenTelemetry](/uk/gateway/opentelemetry). Заголовки автентифікації колектора налаштовуються через `diagnostics.otel.headers`, а не через змінні середовища Docker. +[Експорт OpenTelemetry](/uk/gateway/opentelemetry). Заголовки автентифікації collector налаштовуються через +`diagnostics.otel.headers`, а не через змінні середовища Docker. Метрики Prometheus використовують уже опублікований порт Gateway. Увімкніть -Plugin `diagnostics-prometheus`, а потім виконуйте збирання: +плагін `diagnostics-prometheus`, а потім збирайте: ```text http://:18789/api/diagnostics/prometheus ``` Маршрут захищений автентифікацією Gateway. Не відкривайте окремий -публічний порт `/metrics` або неавтентифікований шлях зворотного проксі. Див. +публічний порт `/metrics` або неавтентифікований шлях reverse proxy. Див. [Метрики Prometheus](/uk/gateway/prometheus). -### Перевірки працездатності +### Перевірки стану -Кінцеві точки probe контейнера (автентифікація не потрібна): +Кінцеві точки probes контейнера (автентифікація не потрібна): ```bash -curl -fsS http://127.0.0.1:18789/healthz # live-перевірка -curl -fsS http://127.0.0.1:18789/readyz # перевірка готовності +curl -fsS http://127.0.0.1:18789/healthz # liveness +curl -fsS http://127.0.0.1:18789/readyz # readiness ``` -Docker-образ містить вбудований `HEALTHCHECK`, який опитує `/healthz`. -Якщо перевірки продовжують завершуватися помилкою, Docker позначає контейнер як `unhealthy`, і +Docker-образ містить вбудований `HEALTHCHECK`, який звертається до `/healthz`. +Якщо перевірки постійно не проходять, Docker позначає контейнер як `unhealthy`, і системи оркестрації можуть перезапустити або замінити його. -Автентифікований глибокий знімок працездатності: +Автентифікований розгорнутий знімок стану: ```bash docker compose exec openclaw-gateway node dist/index.js health --token "$OPENCLAW_GATEWAY_TOKEN" @@ -206,72 +208,72 @@ docker compose exec openclaw-gateway node dist/index.js health --token "$OPENCLA ### LAN проти loopback -`scripts/docker/setup.sh` за замовчуванням використовує `OPENCLAW_GATEWAY_BIND=lan`, тож доступ хоста до -`http://127.0.0.1:18789` працює з опублікованим портом Docker. +`scripts/docker/setup.sh` за замовчуванням встановлює `OPENCLAW_GATEWAY_BIND=lan`, тож доступ хоста до +`http://127.0.0.1:18789` працює з публікацією портів Docker. -- `lan` (за замовчуванням): браузер хоста та CLI хоста можуть досягти опублікованого порту Gateway. -- `loopback`: лише процеси всередині простору імен мережі контейнера можуть - напряму досягти Gateway. +- `lan` (за замовчуванням): браузер хоста і CLI хоста можуть звертатися до опублікованого порту Gateway. +- `loopback`: лише процеси всередині простору мережевих імен контейнера можуть безпосередньо звертатися + до Gateway. -Використовуйте значення режиму bind у `gateway.bind` (`lan` / `loopback` / `custom` / +Використовуйте значення режиму прив’язки в `gateway.bind` (`lan` / `loopback` / `custom` / `tailnet` / `auto`), а не псевдоніми хоста на кшталт `0.0.0.0` або `127.0.0.1`. ### Bonjour / mDNS -Мережа моста Docker зазвичай ненадійно пересилає multicast-трафік Bonjour/mDNS -(`224.0.0.251:5353`). Тому вбудоване налаштування Compose за замовчуванням використовує -`OPENCLAW_DISABLE_BONJOUR=1`, щоб Gateway не потрапляв у цикл збоїв або не -перезапускав рекламу повторно, коли міст відкидає multicast-трафік. +Мережа мосту Docker зазвичай ненадійно пересилає мультикаст Bonjour/mDNS +(`224.0.0.251:5353`). Тому вбудоване налаштування Compose за замовчуванням встановлює +`OPENCLAW_DISABLE_BONJOUR=1`, щоб Gateway не потрапляв у цикл аварійних перезапусків і не +перезапускав рекламу знову і знову, коли міст втрачає мультикаст-трафік. -Для хостів Docker використовуйте опубліковану URL-адресу Gateway, Tailscale або wide-area DNS-SD. -Установлюйте `OPENCLAW_DISABLE_BONJOUR=0` лише під час запуску з host networking, macvlan -або іншою мережею, де достеменно відомо, що multicast mDNS працює. +Для Docker-хостів використовуйте опубліковану URL-адресу Gateway, Tailscale або DNS-SD широкої зони. +Встановлюйте `OPENCLAW_DISABLE_BONJOUR=0` лише під час роботи з host networking, macvlan +або іншою мережею, де точно відомо, що мультикаст mDNS працює. -Щоб дізнатися про типові проблеми та способи усунення несправностей, див. [Виявлення Bonjour](/uk/gateway/bonjour). +Щоб дізнатися про типові проблеми й усунення неполадок, див. [Виявлення Bonjour](/uk/gateway/bonjour). ### Сховище та збереження даних -Docker Compose bind-монтує `OPENCLAW_CONFIG_DIR` у `/home/node/.openclaw` і -`OPENCLAW_WORKSPACE_DIR` у `/home/node/.openclaw/workspace`, тож ці шляхи +Docker Compose монтує `OPENCLAW_CONFIG_DIR` у `/home/node/.openclaw` і +`OPENCLAW_WORKSPACE_DIR` у `/home/node/.openclaw/workspace`, тому ці шляхи зберігаються після заміни контейнера. У цьому змонтованому каталозі конфігурації OpenClaw зберігає: - `openclaw.json` для конфігурації поведінки -- `agents//agent/auth-profiles.json` для збереженої OAuth/API-key автентифікації провайдерів +- `agents//agent/auth-profiles.json` для збереженої OAuth/API-key автентифікації провайдера - `.env` для секретів часу виконання на основі env, таких як `OPENCLAW_GATEWAY_TOKEN` -Докладніше про повне збереження даних у розгортаннях на VM див. -[Docker VM Runtime - Що зберігається і де](/uk/install/docker-vm-runtime#what-persists-where). +Повні відомості про збереження даних у розгортаннях на VM див. у +[Docker VM Runtime - Що і де зберігається](/uk/install/docker-vm-runtime#what-persists-where). -**Основні джерела зростання дискового простору:** стежте за `media/`, JSONL-файлами сеансів, `cron/runs/*.jsonl` +**Точки зростання дискового простору:** стежте за `media/`, файлами JSONL сеансів, `cron/runs/*.jsonl`, і циклічними файловими журналами в `/tmp/openclaw/`. -### Shell helper-и (необов’язково) +### Допоміжні команди оболонки (необов’язково) -Для простішого щоденного керування Docker установіть `ClawDock`: +Для зручнішого повсякденного керування Docker установіть `ClawDock`: ```bash mkdir -p ~/.clawdock && curl -sL https://raw.githubusercontent.com/openclaw/openclaw/main/scripts/clawdock/clawdock-helpers.sh -o ~/.clawdock/clawdock-helpers.sh echo 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc ``` -Якщо ви встановлювали ClawDock зі старого raw-шляху `scripts/shell-helpers/clawdock-helpers.sh`, повторно виконайте наведену вище команду встановлення, щоб ваш локальний helper-файл відстежував нове розташування. +Якщо ви встановили ClawDock зі старого raw-шляху `scripts/shell-helpers/clawdock-helpers.sh`, повторно виконайте наведену вище команду встановлення, щоб ваш локальний файл помічника відстежував нове розташування. Після цього використовуйте `clawdock-start`, `clawdock-stop`, `clawdock-dashboard` тощо. Виконайте -`clawdock-help`, щоб переглянути всі команди. -Повний посібник з helper-ів див. у [ClawDock](/uk/install/clawdock). +`clawdock-help`, щоб побачити всі команди. +Повний посібник із допоміжних команд див. у [ClawDock](/uk/install/clawdock). - + ```bash export OPENCLAW_SANDBOX=1 ./scripts/docker/setup.sh ``` - Власний шлях до socket (наприклад, rootless Docker): + Власний шлях до сокета (наприклад, rootless Docker): ```bash export OPENCLAW_SANDBOX=1 @@ -279,14 +281,14 @@ echo 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc ./scripts/docker/setup.sh ``` - Скрипт монтує `docker.sock` лише після успішного проходження передумов sandbox. Якщо - налаштування sandbox неможливо завершити, скрипт скидає `agents.defaults.sandbox.mode` - до `off`. + Скрипт монтує `docker.sock` лише після проходження перевірки передумов пісочниці. Якщо + налаштування пісочниці не вдасться завершити, скрипт скине `agents.defaults.sandbox.mode` + на `off`. - Вимкніть виділення псевдо-TTY для Compose за допомогою `-T`: + Вимкніть виділення псевдо-TTY Compose за допомогою `-T`: ```bash docker compose run -T --rm openclaw-cli gateway probe @@ -297,14 +299,14 @@ echo 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc `openclaw-cli` використовує `network_mode: "service:openclaw-gateway"`, тож команди CLI - можуть звертатися до gateway через `127.0.0.1`. Розглядайте це як спільну + можуть звертатися до Gateway через `127.0.0.1`. Розглядайте це як спільну межу довіри. Конфігурація compose скидає `NET_RAW`/`NET_ADMIN` і вмикає `no-new-privileges` для `openclaw-cli`. Образ працює від імені `node` (uid 1000). Якщо ви бачите помилки дозволів для - `/home/node/.openclaw`, переконайтеся, що bind-монтування хоста належать uid 1000: + `/home/node/.openclaw`, переконайтеся, що ваші bind mount-и хоста належать uid 1000: ```bash sudo chown -R 1000:1000 /path/to/openclaw-config /path/to/openclaw-workspace @@ -313,7 +315,7 @@ echo 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc - Упорядкуйте ваш Dockerfile так, щоб шари залежностей кешувалися. Це дає змогу уникнути повторного запуску + Упорядкуйте Dockerfile так, щоб шари залежностей кешувалися. Це дозволяє уникнути повторного запуску `pnpm install`, якщо lockfile-и не змінювалися: ```dockerfile @@ -337,35 +339,35 @@ echo 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc - Типовий образ орієнтований насамперед на безпеку й працює від непривілейованого `node`. Для більш + Типовий образ орієнтований насамперед на безпеку й працює від імені непривілейованого `node`. Для більш функціонального контейнера: 1. **Зберігайте `/home/node`**: `export OPENCLAW_HOME_VOLUME="openclaw_home"` - 2. **Додайте системні залежності в образ**: `export OPENCLAW_DOCKER_APT_PACKAGES="git curl jq"` + 2. **Вбудуйте системні залежності**: `export OPENCLAW_DOCKER_APT_PACKAGES="git curl jq"` 3. **Установіть браузери Playwright**: ```bash docker compose run --rm openclaw-cli \ node /app/node_modules/playwright-core/cli.js install chromium ``` - 4. **Зберігайте завантаження браузерів**: задайте + 4. **Зберігайте завантаження браузерів**: установіть `PLAYWRIGHT_BROWSERS_PATH=/home/node/.cache/ms-playwright` і використовуйте `OPENCLAW_HOME_VOLUME` або `OPENCLAW_EXTRA_MOUNTS`. - - Якщо у майстрі ви виберете OpenAI Codex OAuth, він відкриє URL-адресу в браузері. У + + Якщо у майстрі ви виберете OAuth OpenAI Codex, він відкриє URL-адресу в браузері. У Docker або headless-середовищах скопіюйте повну URL-адресу перенаправлення, на яку ви потрапите, і вставте її назад у майстер, щоб завершити автентифікацію. - Основний Docker-образ використовує `node:24-bookworm` і публікує OCI-анотації - базового образу, зокрема `org.opencontainers.image.base.name`, + Основний runtime-образ Docker використовує `node:24-bookworm-slim` і публікує OCI + анотації базового образу, зокрема `org.opencontainers.image.base.name`, `org.opencontainers.image.source` та інші. Digest базового образу Node - оновлюється через PR Dependabot для базових Docker-образів; збірки релізів не виконують + оновлюється через PR Dependabot для базових Docker-образів; релізні збірки не запускають шар оновлення дистрибутива. Див. - [OCI image annotations](https://github.com/opencontainers/image-spec/blob/main/annotations.md). + [Анотації образів OCI](https://github.com/opencontainers/image-spec/blob/main/annotations.md). @@ -373,26 +375,26 @@ echo 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc Див. [Hetzner (Docker VPS)](/uk/install/hetzner) і [Docker VM Runtime](/uk/install/docker-vm-runtime) для кроків розгортання на спільних VM, -зокрема підготовки бінарних файлів в образі, збереження даних і оновлень. +включно з вбудовуванням бінарних файлів, збереженням даних і оновленнями. -## Sandbox агента +## Пісочниця агента -Коли `agents.defaults.sandbox` увімкнено з Docker-бекендом, gateway +Коли `agents.defaults.sandbox` увімкнено з бекендом Docker, Gateway виконує інструменти агента (shell, читання/запис файлів тощо) в ізольованих Docker- -контейнерах, тоді як сам gateway залишається на хості. Це дає вам жорстку межу +контейнерах, тоді як сам Gateway залишається на хості. Це створює жорстку межу навколо недовірених або багатокористувацьких сеансів агента без контейнеризації всього -gateway. +Gateway. -Область sandbox може бути для кожного агента окремо (за замовчуванням), для кожного сеансу або спільною. Кожна область -отримує власний робочий простір, змонтований у `/workspace`. Ви також можете налаштувати -політики дозволу/заборони інструментів, ізоляцію мережі, обмеження ресурсів і браузерні -контейнери. +Область дії пісочниці може бути на рівні агента (за замовчуванням), сеансу або спільною. Кожна область +отримує власний workspace, змонтований у `/workspace`. Ви також можете налаштувати +політики дозволу/заборони інструментів, ізоляцію мережі, обмеження ресурсів і +контейнери браузера. Повну інформацію про конфігурацію, образи, примітки щодо безпеки та профілі з кількома агентами див. тут: -- [Ізоляція](/uk/gateway/sandboxing) -- повний довідник з sandbox -- [OpenShell](/uk/gateway/openshell) -- інтерактивний доступ до shell контейнерів sandbox -- [Multi-Agent Sandbox and Tools](/uk/tools/multi-agent-sandbox-tools) -- перевизначення для окремих агентів +- [Пісочниця](/uk/gateway/sandboxing) -- повний довідник із пісочниці +- [OpenShell](/uk/gateway/openshell) -- інтерактивний доступ shell до контейнерів пісочниці +- [Пісочниця та інструменти для кількох агентів](/uk/tools/multi-agent-sandbox-tools) -- перевизначення для окремих агентів ### Швидке ввімкнення @@ -409,38 +411,38 @@ gateway. } ``` -Зберіть типовий образ sandbox: +Зберіть типовий образ пісочниці: ```bash scripts/sandbox-setup.sh ``` -## Усунення несправностей +## Усунення неполадок - - Зберіть образ sandbox за допомогою + + Зберіть образ пісочниці за допомогою [`scripts/sandbox-setup.sh`](https://github.com/openclaw/openclaw/blob/main/scripts/sandbox-setup.sh) - або задайте `agents.defaults.sandbox.docker.image` для вашого власного образу. - Контейнери автоматично створюються за потреби для кожного сеансу. + або встановіть `agents.defaults.sandbox.docker.image` на ваш власний образ. + Контейнери автоматично створюються для кожного сеансу за потреби. - - Задайте `docker.user` як UID:GID, що відповідає правам власності змонтованого робочого простору, - або змініть власника теки робочого простору через chown. + + Встановіть `docker.user` на UID:GID, що відповідає правам власності змонтованого workspace, + або змініть власника папки workspace через chown. - - OpenClaw запускає команди через `sh -lc` (login shell), який зчитує - `/etc/profile` і може скидати PATH. Задайте `docker.env.PATH`, щоб додати - ваші власні шляхи до інструментів на початок, або додайте скрипт у `/etc/profile.d/` у вашому Dockerfile. + + OpenClaw запускає команди через `sh -lc` (login shell), який завантажує + `/etc/profile` і може скидати PATH. Встановіть `docker.env.PATH`, щоб додати + ваші власні шляхи до інструментів, або додайте скрипт у `/etc/profile.d/` у вашому Dockerfile. - - VM потребує щонайменше 2 ГБ RAM. Використайте більший клас машини та повторіть спробу. + + VM потребує щонайменше 2 ГБ RAM. Використайте більший клас машини й повторіть спробу. - + Отримайте нове посилання на dashboard і схваліть пристрій браузера: ```bash @@ -449,12 +451,12 @@ scripts/sandbox-setup.sh docker compose run --rm openclaw-cli devices approve ``` - Докладніше: [Dashboard](/uk/web/dashboard), [Devices](/uk/cli/devices). + Докладніше: [Dashboard](/uk/web/dashboard), [Пристрої](/uk/cli/devices). - - Скиньте режим і bind gateway: + + Скиньте режим і прив’язку Gateway: ```bash docker compose run --rm openclaw-cli config set --batch-json '[{"path":"gateway.mode","value":"local"},{"path":"gateway.bind","value":"lan"}]' @@ -469,5 +471,5 @@ scripts/sandbox-setup.sh - [Огляд встановлення](/uk/install) — усі способи встановлення - [Podman](/uk/install/podman) — альтернатива Docker на базі Podman - [ClawDock](/uk/install/clawdock) — спільнотне налаштування Docker Compose -- [Оновлення](/uk/install/updating) — підтримання OpenClaw в актуальному стані -- [Конфігурація](/uk/gateway/configuration) — конфігурація gateway після встановлення +- [Оновлення](/uk/install/updating) — підтримка OpenClaw в актуальному стані +- [Конфігурація](/uk/gateway/configuration) — конфігурація Gateway після встановлення diff --git a/docs/uk/providers/ollama.md b/docs/uk/providers/ollama.md index 9db62a789..9d1baa687 100644 --- a/docs/uk/providers/ollama.md +++ b/docs/uk/providers/ollama.md @@ -1,23 +1,23 @@ --- read_when: - Ви хочете запускати OpenClaw з хмарними або локальними моделями через Ollama - - Вам потрібні вказівки щодо налаштування та конфігурації Ollama - - Ви хочете моделі Ollama з підтримкою vision для розуміння зображень -summary: Запустити OpenClaw з Ollama (хмарні та локальні моделі) + - Вам потрібні інструкції з налаштування та конфігурації Ollama + - Ви хочете використовувати моделі Ollama з підтримкою зору для розуміння зображень +summary: Запускайте OpenClaw з Ollama (хмарні та локальні моделі) title: Ollama x-i18n: - generated_at: "2026-04-23T21:07:09Z" + generated_at: "2026-04-26T21:53:32Z" model: gpt-5.4 provider: openai - source_hash: 9595459cc32ff81332b09a81388f84059f48e86039170078fd7f30ccd9b4e1f5 + source_hash: 6fdec2ee2b642bbc57badbc434d41a210b421ac745cd0fceb7be595cbb0cb082 source_path: providers/ollama.md workflow: 15 --- -OpenClaw інтегрується з нативним API Ollama (`/api/chat`) для хмарних моделей і локальних/self-hosted серверів Ollama. Ви можете використовувати Ollama у трьох режимах: `Cloud + Local` через досяжний хост Ollama, `Cloud only` проти `https://ollama.com`, або `Local only` проти досяжного хоста Ollama. +OpenClaw інтегрується з нативним API Ollama (`/api/chat`) для розміщених хмарних моделей і локальних/самостійно розміщених серверів Ollama. Ви можете використовувати Ollama у трьох режимах: `Cloud + Local` через доступний хост Ollama, `Cloud only` через `https://ollama.com` або `Local only` через доступний хост Ollama. -**Користувачі віддаленого Ollama**: не використовуйте з OpenClaw URL `/v1`, сумісний з OpenAI (`http://host:11434/v1`). Це ламає виклики інструментів, і моделі можуть виводити сирий JSON інструментів як звичайний текст. Використовуйте натомість нативний URL API Ollama: `baseUrl: "http://host:11434"` (без `/v1`). +**Користувачі віддаленого Ollama**: Не використовуйте URL OpenAI-сумісного `/v1` (`http://host:11434/v1`) з OpenClaw. Це ламає виклик інструментів, і моделі можуть виводити сирий JSON інструментів як звичайний текст. Натомість використовуйте URL нативного API Ollama: `baseUrl: "http://host:11434"` (без `/v1`). ## Початок роботи @@ -25,26 +25,26 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`) Виберіть бажаний спосіб налаштування та режим. - - **Найкраще для:** найшвидшого шляху до робочого хмарного або локального налаштування Ollama. + + **Найкраще для:** найшвидшого способу отримати робоче хмарне або локальне налаштування Ollama. - + ```bash openclaw onboard ``` Виберіть **Ollama** зі списку провайдерів. - - - **Cloud + Local** — локальний хост Ollama плюс хмарні моделі, маршрутизовані через цей хост - - **Cloud only** — хмарні моделі Ollama через `https://ollama.com` + + - **Cloud + Local** — локальний хост Ollama плюс хмарні моделі, спрямовані через цей хост + - **Cloud only** — розміщені моделі Ollama через `https://ollama.com` - **Local only** — лише локальні моделі - `Cloud only` запитує `OLLAMA_API_KEY` і пропонує типові хмарні значення. `Cloud + Local` і `Local only` запитують base URL Ollama, виявляють доступні моделі та автоматично виконують pull вибраної локальної моделі, якщо її ще немає. `Cloud + Local` також перевіряє, чи виконано вхід на цьому хості Ollama для хмарного доступу. + `Cloud only` запитує `OLLAMA_API_KEY` і пропонує стандартні хмарні налаштування за замовчуванням. `Cloud + Local` і `Local only` запитують базовий URL Ollama, виявляють доступні моделі та автоматично завантажують вибрану локальну модель, якщо вона ще недоступна. `Cloud + Local` також перевіряє, чи виконано вхід на цьому хості Ollama для хмарного доступу. - + ```bash openclaw models list --provider ollama ``` @@ -59,7 +59,7 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`) --accept-risk ``` - За бажанням можна вказати користувацький base URL або модель: + За потреби вкажіть власний базовий URL або модель: ```bash openclaw onboard --non-interactive \ @@ -76,40 +76,40 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`) - - **Cloud + Local**: установіть Ollama, увійдіть через `ollama signin` і маршрутизуйте хмарні запити через цей хост + - **Cloud + Local**: встановіть Ollama, виконайте вхід через `ollama signin` і спрямовуйте хмарні запити через цей хост - **Cloud only**: використовуйте `https://ollama.com` з `OLLAMA_API_KEY` - - **Local only**: установіть Ollama з [ollama.com/download](https://ollama.com/download) + - **Local only**: встановіть Ollama з [ollama.com/download](https://ollama.com/download) - + ```bash ollama pull gemma4 - # or + # або ollama pull gpt-oss:20b - # or + # або ollama pull llama3.3 ``` - Для `Cloud only` використовуйте справжній `OLLAMA_API_KEY`. Для варіантів, що працюють через хост, підійде будь-яке placeholder-значення: + Для `Cloud only` використовуйте свій справжній `OLLAMA_API_KEY`. Для конфігурацій на основі хоста підійде будь-яке значення-заповнювач: ```bash - # Cloud + # Хмара export OLLAMA_API_KEY="your-ollama-api-key" - # Local-only + # Лише локально export OLLAMA_API_KEY="ollama-local" - # Or configure in your config file + # Або налаштуйте у своєму файлі конфігурації openclaw config set models.providers.ollama.apiKey "OLLAMA_API_KEY" ``` - + ```bash openclaw models list openclaw models set ollama/gemma4 ``` - Або задайте типову модель у config: + Або встановіть модель за замовчуванням у конфігурації: ```json5 { @@ -130,53 +130,53 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`) - `Cloud + Local` використовує досяжний хост Ollama як контрольну точку і для локальних, і для хмарних моделей. Це рекомендований Ollama гібридний потік. + `Cloud + Local` використовує доступний хост Ollama як контрольну точку і для локальних, і для хмарних моделей. Це рекомендований гібридний підхід Ollama. - Під час налаштування виберіть **Cloud + Local**. OpenClaw запитує base URL Ollama, виявляє локальні моделі з цього хоста та перевіряє, чи виконано вхід на хості для хмарного доступу через `ollama signin`. Коли вхід на хості виконано, OpenClaw також пропонує типові хмарні моделі, такі як `kimi-k2.5:cloud`, `minimax-m2.7:cloud` і `glm-5.1:cloud`. + Використовуйте **Cloud + Local** під час налаштування. OpenClaw запитує базовий URL Ollama, виявляє локальні моделі з цього хоста та перевіряє, чи виконано вхід на хості для хмарного доступу через `ollama signin`. Якщо вхід на хості виконано, OpenClaw також пропонує стандартні розміщені хмарні моделі, такі як `kimi-k2.5:cloud`, `minimax-m2.7:cloud` і `glm-5.1:cloud`. - Якщо на хості ще не виконано вхід, OpenClaw залишає налаштування лише локальним, доки ви не виконаєте `ollama signin`. + Якщо вхід на хості ще не виконано, OpenClaw зберігає налаштування лише локальним, доки ви не запустите `ollama signin`. - `Cloud only` працює з хмарним API Ollama за адресою `https://ollama.com`. + `Cloud only` працює через розміщений API Ollama за адресою `https://ollama.com`. - Під час налаштування виберіть **Cloud only**. OpenClaw запитує `OLLAMA_API_KEY`, задає `baseUrl: "https://ollama.com"` і ініціалізує список хмарних моделей. Цей шлях **не** потребує локального сервера Ollama або `ollama signin`. + Використовуйте **Cloud only** під час налаштування. OpenClaw запитує `OLLAMA_API_KEY`, установлює `baseUrl: "https://ollama.com"` і заповнює список розміщених хмарних моделей. Цей шлях **не** потребує локального сервера Ollama або `ollama signin`. - Список хмарних моделей, який показується під час `openclaw onboard`, заповнюється в реальному часі з `https://ollama.com/api/tags`, з обмеженням у 500 записів, тому picker відображає актуальний хмарний каталог, а не статичний початковий список. Якщо `ollama.com` недоступний або не повертає моделей під час налаштування, OpenClaw повертається до попередніх жорстко заданих пропозицій, щоб onboarding усе одно завершився. + Список хмарних моделей, показаний під час `openclaw onboard`, заповнюється в реальному часі з `https://ollama.com/api/tags` з обмеженням до 500 записів, тому засіб вибору відображає поточний розміщений каталог, а не статичний початковий список. Якщо `ollama.com` недоступний або не повертає моделей під час налаштування, OpenClaw повертається до попередніх жорстко закодованих рекомендацій, щоб початкове налаштування все одно завершилось. - У режимі лише local OpenClaw виявляє моделі з налаштованого екземпляра Ollama. Цей шлях призначено для локальних або self-hosted серверів Ollama. + У режимі лише локального використання OpenClaw виявляє моделі з налаштованого екземпляра Ollama. Цей шлях призначений для локальних або самостійно розміщених серверів Ollama. - Наразі OpenClaw пропонує `gemma4` як типову локальну модель. + OpenClaw наразі пропонує `gemma4` як локальну модель за замовчуванням. ## Виявлення моделей (неявний провайдер) -Коли ви задаєте `OLLAMA_API_KEY` (або auth profile) і **не** визначаєте `models.providers.ollama`, OpenClaw виявляє моделі з локального екземпляра Ollama за адресою `http://127.0.0.1:11434`. +Коли ви встановлюєте `OLLAMA_API_KEY` (або профіль автентифікації) і **не** визначаєте `models.providers.ollama`, OpenClaw виявляє моделі з локального екземпляра Ollama за адресою `http://127.0.0.1:11434`. -| Поведінка | Деталі | -| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Запит каталогу | Опитує `/api/tags` | -| Виявлення можливостей | Використовує best-effort запити до `/api/show`, щоб прочитати `contextWindow` і визначити можливості (включно з vision) | -| Vision-моделі | Моделі з можливістю `vision`, яку повертає `/api/show`, позначаються як такі, що підтримують зображення (`input: ["text", "image"]`), тому OpenClaw автоматично ін’єктує зображення в prompt | -| Виявлення reasoning | Позначає `reasoning` за евристикою назви моделі (`r1`, `reasoning`, `think`) | -| Ліміти токенів | Установлює `maxTokens` на типове обмеження max-token Ollama, яке використовує OpenClaw | -| Вартість | Усі значення вартості встановлюються в `0` | +| Поведінка | Докладно | +| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Запит каталогу | Виконує запити до `/api/tags` | +| Визначення можливостей | Використовує best-effort запити до `/api/show`, щоб зчитати `contextWindow` і визначити можливості (зокрема vision) | +| Vision-моделі | Моделі з можливістю `vision`, про яку повідомляє `/api/show`, позначаються як такі, що підтримують зображення (`input: ["text", "image"]`), тому OpenClaw автоматично додає зображення до prompt | +| Визначення reasoning | Позначає `reasoning` за допомогою евристики імені моделі (`r1`, `reasoning`, `think`) | +| Ліміти токенів | Установлює `maxTokens` на стандартне максимальне обмеження токенів Ollama, яке використовує OpenClaw | +| Вартість | Установлює всі значення вартості в `0` | -Це дає змогу уникнути ручного додавання записів моделей, зберігаючи узгодженість каталогу з локальним екземпляром Ollama. +Це дає змогу уникнути ручного додавання моделей, водночас зберігаючи узгодженість каталогу з локальним екземпляром Ollama. ```bash -# See what models are available +# Подивитися, які моделі доступні ollama list openclaw models list ``` -Щоб додати нову модель, просто виконайте її pull через Ollama: +Щоб додати нову модель, просто завантажте її через Ollama: ```bash ollama pull mistral @@ -185,21 +185,21 @@ ollama pull mistral Нова модель буде автоматично виявлена й доступна для використання. -Якщо ви явно задаєте `models.providers.ollama`, автовиявлення пропускається, і моделі потрібно визначати вручну. Див. розділ про явну config нижче. +Якщо ви явно задаєте `models.providers.ollama`, автовиявлення пропускається, і вам потрібно визначати моделі вручну. Дивіться розділ явної конфігурації нижче. ## Vision і опис зображень -Вбудований plugin Ollama реєструє Ollama як provider розуміння медіа з підтримкою зображень. Це дає OpenClaw змогу маршрутизувати явні запити на опис зображень і налаштовані типові значення image-model через локальні або хмарні vision-моделі Ollama. +Вбудований Plugin Ollama реєструє Ollama як провайдера розуміння медіа, що підтримує зображення. Це дає змогу OpenClaw спрямовувати явні запити на опис зображень і налаштовані значення моделей зображень за замовчуванням через локальні або розміщені vision-моделі Ollama. -Для локального vision виконайте pull моделі, що підтримує зображення: +Для локального vision завантажте модель, що підтримує зображення: ```bash ollama pull qwen2.5vl:7b export OLLAMA_API_KEY="ollama-local" ``` -Потім перевірте через CLI infer: +Потім перевірте за допомогою CLI infer: ```bash openclaw infer image describe \ @@ -208,9 +208,9 @@ openclaw infer image describe \ --json ``` -`--model` має бути повним посиланням ``. Коли його задано, `openclaw infer image describe` запускає цю модель напряму замість пропуску опису через те, що модель уже нативно підтримує vision. +`--model` має бути повним посиланням ``. Коли його встановлено, `openclaw infer image describe` запускає цю модель напряму замість пропуску опису, оскільки модель підтримує нативний vision. -Щоб зробити Ollama типовою моделлю розуміння зображень для вхідних медіа, налаштуйте `agents.defaults.imageModel`: +Щоб зробити Ollama моделлю розуміння зображень за замовчуванням для вхідних медіа, налаштуйте `agents.defaults.imageModel`: ```json5 { @@ -224,7 +224,7 @@ openclaw infer image describe \ } ``` -Якщо ви визначаєте `models.providers.ollama.models` вручну, позначайте vision-моделі як такі, що підтримують зображення: +Якщо ви визначаєте `models.providers.ollama.models` вручну, позначте vision-моделі як такі, що підтримують вхідні зображення: ```json5 { @@ -242,20 +242,20 @@ OpenClaw відхиляє запити на опис зображень для - Найпростіший шлях увімкнення режиму лише local — через змінну середовища: + Найпростіший спосіб увімкнути режим лише локального використання — через змінну середовища: ```bash export OLLAMA_API_KEY="ollama-local" ``` - Якщо задано `OLLAMA_API_KEY`, можна не вказувати `apiKey` у записі провайдера, і OpenClaw сам підставить його для перевірок доступності. + Якщо встановлено `OLLAMA_API_KEY`, ви можете не вказувати `apiKey` у записі провайдера, і OpenClaw підставить його для перевірок доступності. - Використовуйте явну config, коли вам потрібне хмарне налаштування, Ollama працює на іншому хості/порту, ви хочете примусово задати конкретні context window або списки моделей, або вам потрібні повністю ручні визначення моделей. + Використовуйте явну конфігурацію, якщо вам потрібне розміщене хмарне налаштування, Ollama працює на іншому хості/порту, ви хочете примусово встановити конкретні вікна контексту або списки моделей, або вам потрібні повністю ручні визначення моделей. ```json5 { @@ -284,8 +284,8 @@ OpenClaw відхиляє запити на опис зображень для - - Якщо Ollama працює на іншому хості або порту (явна config вимикає автовиявлення, тому моделі потрібно визначити вручну): + + Якщо Ollama працює на іншому хості або порту (явна конфігурація вимикає автовиявлення, тому визначайте моделі вручну): ```json5 { @@ -293,8 +293,8 @@ OpenClaw відхиляє запити на опис зображень для providers: { ollama: { apiKey: "ollama-local", - baseUrl: "http://ollama-host:11434", // No /v1 - use native Ollama API URL - api: "ollama", // Set explicitly to guarantee native tool-calling behavior + baseUrl: "http://ollama-host:11434", // Без /v1 - використовуйте URL нативного API Ollama + api: "ollama", // Установіть явно, щоб гарантувати нативну поведінку виклику інструментів }, }, }, @@ -302,7 +302,7 @@ OpenClaw відхиляє запити на опис зображень для ``` - Не додавайте `/v1` до URL. Шлях `/v1` використовує OpenAI-compatible mode, де виклики інструментів ненадійні. Використовуйте базовий URL Ollama без суфікса шляху. + Не додавайте `/v1` до URL. Шлях `/v1` використовує OpenAI-сумісний режим, у якому виклик інструментів працює ненадійно. Використовуйте базовий URL Ollama без суфікса шляху. @@ -310,7 +310,7 @@ OpenClaw відхиляє запити на опис зображень для ### Вибір моделі -Після налаштування всі ваші моделі Ollama стають доступними: +Після налаштування всі ваші моделі Ollama будуть доступні: ```json5 { @@ -327,15 +327,15 @@ OpenClaw відхиляє запити на опис зображень для ## Ollama Web Search -OpenClaw підтримує **Ollama Web Search** як вбудований provider `web_search`. +OpenClaw підтримує **Ollama Web Search** як вбудований провайдер `web_search`. -| Властивість | Деталі | -| ----------- | ----------------------------------------------------------------------------------------------------------------- | -| Хост | Використовує ваш налаштований хост Ollama (`models.providers.ollama.baseUrl`, якщо задано, інакше `http://127.0.0.1:11434`) | -| Auth | Ключ не потрібен | -| Вимога | Ollama має працювати, і потрібно виконати вхід через `ollama signin` | +| Властивість | Докладно | +| ----------- | ------------------------------------------------------------------------------------------------------------------- | +| Хост | Використовує налаштований вами хост Ollama (`models.providers.ollama.baseUrl`, якщо задано, інакше `http://127.0.0.1:11434`) | +| Автентифікація | Без ключа | +| Вимога | Ollama має бути запущений, і вхід має бути виконаний через `ollama signin` | -Виберіть **Ollama Web Search** під час `openclaw onboard` або `openclaw configure --section web`, або задайте: +Виберіть **Ollama Web Search** під час `openclaw onboard` або `openclaw configure --section web`, або встановіть: ```json5 { @@ -350,18 +350,18 @@ OpenClaw підтримує **Ollama Web Search** як вбудований prov ``` -Повні відомості про налаштування та поведінку див. у [Ollama Web Search](/uk/tools/ollama-search). +Повні відомості про налаштування та поведінку дивіться в [Ollama Web Search](/uk/tools/ollama-search). ## Розширена конфігурація - + - **Виклики інструментів ненадійні в OpenAI-compatible mode.** Використовуйте цей режим лише тоді, коли вам потрібен формат OpenAI для proxy і ви не залежите від нативної поведінки викликів інструментів. + **Виклик інструментів у OpenAI-сумісному режимі працює ненадійно.** Використовуйте цей режим лише тоді, коли вам потрібен формат OpenAI для проксі й ви не залежите від нативної поведінки виклику інструментів. - Якщо вам потрібно використовувати натомість OpenAI-compatible endpoint (наприклад, за proxy, який підтримує лише формат OpenAI), явно задайте `api: "openai-completions"`: + Якщо вам потрібно замість цього використовувати OpenAI-сумісну кінцеву точку (наприклад, за проксі, який підтримує лише формат OpenAI), явно встановіть `api: "openai-completions"`: ```json5 { @@ -370,7 +370,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований prov ollama: { baseUrl: "http://ollama-host:11434/v1", api: "openai-completions", - injectNumCtxForOpenAICompat: true, // default: true + injectNumCtxForOpenAICompat: true, // за замовчуванням: true apiKey: "ollama-local", models: [...] } @@ -379,9 +379,9 @@ OpenClaw підтримує **Ollama Web Search** як вбудований prov } ``` - У цьому режимі може не підтримуватися одночасно і streaming, і виклики інструментів. Може знадобитися вимкнути streaming через `params: { streaming: false }` у config моделі. + У цьому режимі може не підтримуватися одночасно потокова передача та виклик інструментів. Вам може знадобитися вимкнути потокову передачу за допомогою `params: { streaming: false }` у конфігурації моделі. - Коли `api: "openai-completions"` використовується з Ollama, OpenClaw типово ін’єктує `options.num_ctx`, щоб Ollama не переходив мовчки до context window 4096. Якщо ваш proxy/upstream відхиляє невідомі поля `options`, вимкніть цю поведінку: + Коли `api: "openai-completions"` використовується з Ollama, OpenClaw за замовчуванням додає `options.num_ctx`, щоб Ollama не переходила мовчки до вікна контексту 4096. Якщо ваш проксі/апстрім відхиляє невідомі поля `options`, вимкніть цю поведінку: ```json5 { @@ -401,10 +401,10 @@ OpenClaw підтримує **Ollama Web Search** як вбудований prov - - Для автоматично виявлених моделей OpenClaw використовує context window, повідомлений Ollama, коли він доступний; інакше повертається до типового context window Ollama, який використовує OpenClaw. + + Для автоматично виявлених моделей OpenClaw використовує вікно контексту, про яке повідомляє Ollama, якщо воно доступне; інакше використовується стандартне вікно контексту Ollama, яке застосовує OpenClaw. - Ви можете перевизначити `contextWindow` і `maxTokens` в явній config провайдера: + Ви можете перевизначити `contextWindow` і `maxTokens` у явній конфігурації провайдера: ```json5 { @@ -426,8 +426,8 @@ OpenClaw підтримує **Ollama Web Search** як вбудований prov - - OpenClaw типово вважає моделі з назвами на кшталт `deepseek-r1`, `reasoning` або `think` такими, що підтримують reasoning. + + OpenClaw за замовчуванням вважає моделі з назвами на кшталт `deepseek-r1`, `reasoning` або `think` такими, що підтримують reasoning. ```bash ollama pull deepseek-r1:32b @@ -438,20 +438,20 @@ OpenClaw підтримує **Ollama Web Search** як вбудований prov - Ollama безкоштовний і працює локально, тому для всіх моделей вартість встановлюється в $0. Це стосується як автоматично виявлених, так і вручну визначених моделей. + Ollama є безплатною та працює локально, тому вартість усіх моделей встановлена на рівні $0. Це стосується як автоматично виявлених, так і вручну визначених моделей. - - Вбудований plugin Ollama реєструє provider embeddings для пам’яті для - [пошуку пам’яті](/uk/concepts/memory). Він використовує налаштовані base URL - та API-ключ Ollama. + + Вбудований Plugin Ollama реєструє провайдера вбудовувань пам’яті для + [пошуку в пам’яті](/uk/concepts/memory). Він використовує налаштований базовий URL Ollama + та API-ключ. - | Властивість | Значення | - | -------------- | ------------------- | - | Типова модель | `nomic-embed-text` | - | Auto-pull | Так — embedding-модель автоматично виконує pull, якщо локально її немає | + | Властивість | Значення | + | ------------------ | ------------------- | + | Модель за замовчуванням | `nomic-embed-text` | + | Автозавантаження | Так — модель вбудовувань автоматично завантажується локально, якщо її ще немає | - Щоб вибрати Ollama як provider embeddings для пошуку пам’яті: + Щоб вибрати Ollama як провайдера вбудовувань для пошуку в пам’яті: ```json5 { @@ -465,13 +465,13 @@ OpenClaw підтримує **Ollama Web Search** як вбудований prov - - Інтеграція Ollama в OpenClaw типово використовує **нативний API Ollama** (`/api/chat`), який повністю підтримує одночасно streaming і виклики інструментів. Спеціальна конфігурація не потрібна. + + Інтеграція Ollama в OpenClaw за замовчуванням використовує **нативний API Ollama** (`/api/chat`), який повністю підтримує одночасно потокову передачу та виклик інструментів. Жодної спеціальної конфігурації не потрібно. - Для нативних запитів `/api/chat` OpenClaw також напряму передає керування thinking до Ollama: `/think off` і `openclaw agent --thinking off` надсилають верхньорівневий `think: false`, тоді як рівні thinking, відмінні від `off`, надсилають `think: true`. + Для нативних запитів `/api/chat` OpenClaw також напряму передає керування thinking до Ollama: `/think off` і `openclaw agent --thinking off` надсилають верхньорівневе `think: false`, тоді як `/think low|medium|high` надсилають відповідний рядок рівня effort у верхньому рівні `think`. `/think max` відповідає найвищому нативному рівню effort в Ollama, `think: "high"`. - Якщо вам потрібно використовувати OpenAI-compatible endpoint, див. розділ "Застарілий OpenAI-compatible mode" вище. У цьому режимі streaming і виклики інструментів можуть не працювати одночасно. + Якщо вам потрібно використовувати OpenAI-сумісну кінцеву точку, дивіться розділ "Застарілий OpenAI-сумісний режим" вище. У цьому режимі потокова передача та виклик інструментів можуть не працювати одночасно. @@ -480,14 +480,14 @@ OpenClaw підтримує **Ollama Web Search** як вбудований prov ## Усунення несправностей - - Переконайтеся, що Ollama працює, що ви задали `OLLAMA_API_KEY` (або auth profile) і що ви **не** визначили явний запис `models.providers.ollama`: + + Переконайтеся, що Ollama запущена, що ви встановили `OLLAMA_API_KEY` (або профіль автентифікації) і що ви **не** визначили явний запис `models.providers.ollama`: ```bash ollama serve ``` - Перевірте, що API доступне: + Переконайтеся, що API доступний: ```bash curl http://localhost:11434/api/tags @@ -496,25 +496,25 @@ OpenClaw підтримує **Ollama Web Search** як вбудований prov - Якщо вашої моделі немає у списку, виконайте її локальний pull або явно визначте її в `models.providers.ollama`. + Якщо вашої моделі немає у списку, або завантажте її локально, або визначте її явно в `models.providers.ollama`. ```bash - ollama list # See what's installed + ollama list # Подивитися, що встановлено ollama pull gemma4 ollama pull gpt-oss:20b - ollama pull llama3.3 # Or another model + ollama pull llama3.3 # Або іншу модель ``` - - Переконайтеся, що Ollama працює на правильному порту: + + Перевірте, що Ollama запущена на правильному порту: ```bash - # Check if Ollama is running + # Перевірити, чи запущена Ollama ps aux | grep ollama - # Or restart Ollama + # Або перезапустити Ollama ollama serve ``` @@ -522,22 +522,22 @@ OpenClaw підтримує **Ollama Web Search** як вбудований prov -Більше допомоги: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq). +Додаткова допомога: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq). ## Пов’язане - Огляд усіх провайдерів, посилань на моделі та поведінки failover. + Огляд усіх провайдерів, посилань на моделі та поведінки перемикання при збоях. - Як вибирати й налаштовувати моделі. + Як вибирати та налаштовувати моделі. - Повні відомості про налаштування та поведінку web search на базі Ollama. + Повні відомості про налаштування та поведінку вебпошуку на основі Ollama. - Повний довідник із конфігурації. + Повна довідка з конфігурації. diff --git a/docs/uk/tools/thinking.md b/docs/uk/tools/thinking.md index 9ffd25c43..ea2a19ffc 100644 --- a/docs/uk/tools/thinking.md +++ b/docs/uk/tools/thinking.md @@ -1,131 +1,132 @@ --- read_when: - - Налаштування розбору директив мислення, швидкого режиму або докладного режиму чи значень за замовчуванням + - Налаштування аналізу директив мислення, швидкого режиму або розширених відповідей чи значень за замовчуванням summary: Синтаксис директив для /think, /fast, /verbose, /trace і видимості міркувань title: Рівні мислення x-i18n: - generated_at: "2026-04-25T01:07:35Z" + generated_at: "2026-04-26T21:53:33Z" model: gpt-5.4 provider: openai - source_hash: 0537f10d3dd3251ac41590bebd2d83ba8b2562725c322040b20f32547c8af88d + source_hash: 88138c8145afb686d3902a0cc8087c96eace4e955b87c0797ab841bdc20d28db source_path: tools/thinking.md workflow: 15 --- ## Що це робить -- Вбудована директива в будь-якому вхідному тілі: `/t `, `/think:` або `/thinking `. +- Вбудована директива в будь-якому вхідному тілі повідомлення: `/t `, `/think:` або `/thinking `. - Рівні (псевдоніми): `off | minimal | low | medium | high | xhigh | adaptive | max` - - minimal → “think” - - low → “think hard” - - medium → “think harder” - - high → “ultrathink” (максимальний бюджет) - - xhigh → “ultrathink+” (GPT-5.2+ і моделі Codex, а також зусилля Anthropic Claude Opus 4.7) - - adaptive → адаптивне мислення під керуванням провайдера (підтримується для Claude 4.6 на Anthropic/Bedrock, Anthropic Claude Opus 4.7 і Google Gemini dynamic thinking) - - max → максимальне міркування провайдера (наразі Anthropic Claude Opus 4.7) + - minimal → «think» + - low → «think hard» + - medium → «think harder» + - high → «ultrathink» (максимальний бюджет) + - xhigh → «ultrathink+» (GPT-5.2+ і моделі Codex, а також effort для Anthropic Claude Opus 4.7) + - adaptive → кероване провайдером адаптивне мислення (підтримується для Claude 4.6 на Anthropic/Bedrock, Anthropic Claude Opus 4.7 і динамічного мислення Google Gemini) + - max → максимальне міркування провайдера (Anthropic Claude Opus 4.7; Ollama зіставляє це зі своїм найвищим нативним effort `think`) - `x-high`, `x_high`, `extra-high`, `extra high` і `extra_high` зіставляються з `xhigh`. - `highest` зіставляється з `high`. - Примітки щодо провайдерів: - Меню та перемикачі мислення керуються профілем провайдера. Плагіни провайдерів оголошують точний набір рівнів для вибраної моделі, включно з мітками на кшталт бінарного `on`. - - `adaptive`, `xhigh` і `max` рекламуються лише для профілів провайдера/моделі, які їх підтримують. Введені директиви для непідтримуваних рівнів відхиляються з показом дійсних варіантів для цієї моделі. - - Наявні збережені непідтримувані рівні переназначаються за рангом профілю провайдера. `adaptive` повертається до `medium` на неадаптивних моделях, а `xhigh` і `max` — до найбільшого підтримуваного небінарного рівня, відмінного від `off`, для вибраної моделі. - - Для моделей Anthropic Claude 4.6 за замовчуванням використовується `adaptive`, якщо явний рівень мислення не задано. - - Anthropic Claude Opus 4.7 не використовує adaptive thinking за замовчуванням. Типовий рівень effort для його API залишається під керуванням провайдера, якщо ви явно не задасте рівень мислення. - - Anthropic Claude Opus 4.7 зіставляє `/think xhigh` з adaptive thinking плюс `output_config.effort: "xhigh"`, оскільки `/think` — це директива мислення, а `xhigh` — налаштування effort для Opus 4.7. - - Anthropic Claude Opus 4.7 також підтримує `/think max`; це зіставляється з тим самим шляхом максимального effort під керуванням провайдера. - - Моделі OpenAI GPT зіставляють `/think` через підтримку effort у Responses API, специфічну для моделі. `/think off` надсилає `reasoning.effort: "none"` лише тоді, коли цільова модель це підтримує; інакше OpenClaw пропускає payload вимкненого reasoning замість надсилання непідтримуваного значення. - - Google Gemini зіставляє `/think adaptive` з dynamic thinking Gemini під керуванням провайдера. Запити Gemini 3 пропускають фіксований `thinkingLevel`, тоді як запити Gemini 2.5 надсилають `thinkingBudget: -1`; фіксовані рівні, як і раніше, зіставляються з найближчим `thinkingLevel` або бюджетом Gemini для цього сімейства моделей. - - MiniMax (`minimax/*`) на Anthropic-сумісному потоковому шляху за замовчуванням використовує `thinking: { type: "disabled" }`, якщо ви явно не задасте thinking у параметрах моделі або параметрах запиту. Це запобігає витоку дельт `reasoning_content` із ненативного формату Anthropic stream у MiniMax. - - Z.AI (`zai/*`) підтримує лише бінарне thinking (`on`/`off`). Будь-який рівень, відмінний від `off`, трактується як `on` (зіставляється з `low`). - - Moonshot (`moonshot/*`) зіставляє `/think off` з `thinking: { type: "disabled" }`, а будь-який рівень, відмінний від `off`, — з `thinking: { type: "enabled" }`. Коли thinking увімкнено, Moonshot приймає лише `tool_choice` `auto|none`; OpenClaw нормалізує несумісні значення до `auto`. + - `adaptive`, `xhigh` і `max` оголошуються лише для профілів провайдерів/моделей, які їх підтримують. Введені директиви з непідтримуваними рівнями відхиляються зі списком допустимих варіантів для цієї моделі. + - Наявні збережені непідтримувані рівні перепризначаються за рангом профілю провайдера. `adaptive` повертається до `medium` на неадаптивних моделях, а `xhigh` і `max` повертаються до найбільшого підтримуваного рівня, відмінного від `off`, для вибраної моделі. + - Моделі Anthropic Claude 4.6 за замовчуванням використовують `adaptive`, якщо явний рівень мислення не встановлено. + - Anthropic Claude Opus 4.7 не використовує адаптивне мислення за замовчуванням. Типовий effort в його API залишається під керуванням провайдера, якщо ви явно не встановите рівень мислення. + - Anthropic Claude Opus 4.7 зіставляє `/think xhigh` з адаптивним мисленням плюс `output_config.effort: "xhigh"`, оскільки `/think` — це директива мислення, а `xhigh` — параметр effort для Opus 4.7. + - Anthropic Claude Opus 4.7 також підтримує `/think max`; це зіставляється з тим самим шляхом максимального effort, керованого провайдером. + - Моделі Ollama з підтримкою мислення підтримують `/think low|medium|high|max`; `max` зіставляється з нативним `think: "high"`, оскільки нативний API Ollama приймає рядки effort `low`, `medium` і `high`. + - Моделі OpenAI GPT зіставляють `/think` через підтримку effort в API Responses для конкретної моделі. `/think off` надсилає `reasoning.effort: "none"` лише тоді, коли цільова модель це підтримує; інакше OpenClaw пропускає payload вимкненого reasoning замість надсилання непідтримуваного значення. + - Google Gemini зіставляє `/think adaptive` з динамічним мисленням Gemini, керованим провайдером. Запити Gemini 3 пропускають фіксований `thinkingLevel`, тоді як запити Gemini 2.5 надсилають `thinkingBudget: -1`; фіксовані рівні, як і раніше, зіставляються з найближчим `thinkingLevel` або бюджетом Gemini для цього сімейства моделей. + - MiniMax (`minimax/*`) на Anthropic-сумісному streaming-шляху за замовчуванням використовує `thinking: { type: "disabled" }`, якщо ви явно не встановите мислення в параметрах моделі або параметрах запиту. Це запобігає витоку дельт `reasoning_content` з ненативного формату потоку Anthropic у MiniMax. + - Z.AI (`zai/*`) підтримує лише бінарне мислення (`on`/`off`). Будь-який рівень, відмінний від `off`, розглядається як `on` (зіставляється з `low`). + - Moonshot (`moonshot/*`) зіставляє `/think off` з `thinking: { type: "disabled" }`, а будь-який рівень, відмінний від `off`, — з `thinking: { type: "enabled" }`. Коли мислення ввімкнене, Moonshot приймає лише `tool_choice` `auto|none`; OpenClaw нормалізує несумісні значення до `auto`. ## Порядок визначення 1. Вбудована директива в повідомленні (застосовується лише до цього повідомлення). -2. Перевизначення сесії (встановлюється надсиланням повідомлення, що містить лише директиву). +2. Перевизначення сесії (встановлюється надсиланням повідомлення, яке містить лише директиву). 3. Значення за замовчуванням для агента (`agents.list[].thinkingDefault` у конфігурації). 4. Глобальне значення за замовчуванням (`agents.defaults.thinkingDefault` у конфігурації). -5. Резервний варіант: оголошене провайдером значення за замовчуванням, якщо доступне; інакше моделі зі здатністю до міркування визначаються як `medium` або найближчий підтримуваний рівень, відмінний від `off`, для цієї моделі, а моделі без міркування залишаються `off`. +5. Резервний варіант: оголошене провайдером значення за замовчуванням, якщо доступне; інакше моделі з підтримкою міркування визначаються як `medium` або найближчий підтримуваний рівень, відмінний від `off`, для цієї моделі, а моделі без міркування залишаються на `off`. -## Встановлення значення за замовчуванням для сесії +## Встановлення значення сесії за замовчуванням -- Надішліть повідомлення, яке **містить лише** директиву (допускаються пробіли), наприклад `/think:medium` або `/t high`. -- Це зберігається для поточної сесії (типово окремо для кожного відправника); скидається через `/think:off` або під час idle reset сесії. -- Надсилається відповідь-підтвердження (`Thinking level set to high.` / `Thinking disabled.`). Якщо рівень недійсний (наприклад, `/thinking big`), команду буде відхилено з підказкою, а стан сесії залишиться без змін. +- Надішліть повідомлення, яке **містить лише** директиву (пробіли дозволені), наприклад `/think:medium` або `/t high`. +- Це закріплюється для поточної сесії (за замовчуванням для кожного відправника окремо); скидається через `/think:off` або скидання сесії через простій. +- Надсилається відповідь-підтвердження (`Рівень мислення встановлено на high.` / `Мислення вимкнено.`). Якщо рівень недійсний (наприклад, `/thinking big`), команда відхиляється з підказкою, а стан сесії залишається без змін. - Надішліть `/think` (або `/think:`) без аргументу, щоб побачити поточний рівень мислення. ## Застосування за агентом -- **Вбудований Pi**: визначений рівень передається в runtime агента Pi у межах процесу. +- **Вбудований Pi**: визначений рівень передається у внутрішній runtime агента Pi. ## Швидкий режим (/fast) - Рівні: `on|off`. -- Повідомлення лише з директивою перемикає перевизначення швидкого режиму для сесії та відповідає `Fast mode enabled.` / `Fast mode disabled.`. +- Повідомлення лише з директивою перемикає перевизначення швидкого режиму для сесії та повертає `Швидкий режим увімкнено.` / `Швидкий режим вимкнено.`. - Надішліть `/fast` (або `/fast status`) без режиму, щоб побачити поточний ефективний стан швидкого режиму. - OpenClaw визначає швидкий режим у такому порядку: - 1. Вбудоване/директивне `/fast on|off` + 1. Вбудована/директива-єдина `/fast on|off` 2. Перевизначення сесії 3. Значення за замовчуванням для агента (`agents.list[].fastModeDefault`) 4. Конфігурація для моделі: `agents.defaults.models["/"].params.fastMode` 5. Резервний варіант: `off` -- Для `openai/*` швидкий режим зіставляється з обробкою пріоритету OpenAI через надсилання `service_tier=priority` у підтримуваних запитах Responses. +- Для `openai/*` швидкий режим зіставляється з пріоритетною обробкою OpenAI через надсилання `service_tier=priority` у підтримуваних запитах Responses. - Для `openai-codex/*` швидкий режим надсилає той самий прапорець `service_tier=priority` у Codex Responses. OpenClaw зберігає один спільний перемикач `/fast` для обох шляхів автентифікації. -- Для прямих публічних запитів `anthropic/*`, включно з трафіком, автентифікованим через OAuth і надісланим до `api.anthropic.com`, швидкий режим зіставляється з рівнями сервісу Anthropic: `/fast on` встановлює `service_tier=auto`, `/fast off` встановлює `service_tier=standard_only`. +- Для прямих публічних запитів `anthropic/*`, включно з трафіком з OAuth-автентифікацією, надісланим до `api.anthropic.com`, швидкий режим зіставляється з рівнями сервісу Anthropic: `/fast on` встановлює `service_tier=auto`, `/fast off` встановлює `service_tier=standard_only`. - Для `minimax/*` на Anthropic-сумісному шляху `/fast on` (або `params.fastMode: true`) переписує `MiniMax-M2.7` на `MiniMax-M2.7-highspeed`. -- Явні параметри моделі Anthropic `serviceTier` / `service_tier` перевизначають значення швидкого режиму за замовчуванням, якщо встановлено обидва. OpenClaw, як і раніше, пропускає впровадження service tier Anthropic для не-Anthropic proxy base URL. -- `/status` показує `Fast` лише тоді, коли швидкий режим увімкнено. +- Явні параметри моделі Anthropic `serviceTier` / `service_tier` перевизначають значення швидкого режиму за замовчуванням, коли встановлено обидва. OpenClaw, як і раніше, пропускає інʼєкцію рівня сервісу Anthropic для базових URL проксі, що не належать Anthropic. +- `/status` показує `Fast` лише коли швидкий режим увімкнено. -## Докладні директиви (/verbose або /v) +## Директиви розширених відповідей (/verbose або /v) - Рівні: `on` (мінімальний) | `full` | `off` (за замовчуванням). -- Повідомлення лише з директивою перемикає докладність для сесії та відповідає `Verbose logging enabled.` / `Verbose logging disabled.`; недійсні рівні повертають підказку без зміни стану. -- `/verbose off` зберігає явне перевизначення сесії; очистіть його через інтерфейс Sessions, вибравши `inherit`. -- Вбудована директива впливає лише на це повідомлення; інакше застосовуються значення за замовчуванням для сесії/глобальні. -- Надішліть `/verbose` (або `/verbose:`) без аргументу, щоб побачити поточний рівень докладності. -- Коли verbose увімкнено, агенти, які видають структуровані результати інструментів (Pi, інші JSON-агенти), надсилають кожен виклик інструмента назад як окреме повідомлення лише з метаданими, з префіксом ` : `, коли доступно (path/command). Ці підсумки інструментів надсилаються щойно кожен інструмент запускається (окремими бульбашками), а не як потокові дельти. -- Підсумки збоїв інструментів залишаються видимими у звичайному режимі, але суфікси з необробленими деталями помилок приховуються, якщо verbose не дорівнює `on` або `full`. -- Коли verbose має значення `full`, після завершення також пересилаються виводи інструментів (окремою бульбашкою, скорочені до безпечної довжини). Якщо ви перемкнете `/verbose on|full|off`, поки виконання триває, наступні бульбашки інструментів врахують нове налаштування. +- Повідомлення лише з директивою перемикає розширені відповіді для сесії та повертає `Розширене логування ввімкнено.` / `Розширене логування вимкнено.`; недійсні рівні повертають підказку без зміни стану. +- `/verbose off` зберігає явне перевизначення сесії; очистьте його через інтерфейс Sessions, вибравши `inherit`. +- Вбудована директива впливає лише на це повідомлення; інакше застосовуються значення сесії/глобальні за замовчуванням. +- Надішліть `/verbose` (або `/verbose:`) без аргументу, щоб побачити поточний рівень розширеного режиму. +- Коли розширений режим увімкнено, агенти, які видають структуровані результати інструментів (Pi, інші JSON-агенти), надсилають кожен виклик інструмента назад як окреме повідомлення лише з метаданими, з префіксом ` : `, коли доступно (path/command). Ці зведення інструментів надсилаються щойно кожен інструмент запускається (окремими бульбашками), а не як streaming-дельти. +- Зведення про помилки інструментів залишаються видимими у звичайному режимі, але суфікси з сирими деталями помилок приховуються, якщо тільки `verbose` не має значення `on` або `full`. +- Коли `verbose` має значення `full`, вихідні дані інструментів також пересилаються після завершення (окрема бульбашка, обрізана до безпечної довжини). Якщо ви перемкнете `/verbose on|full|off`, поки виконання ще триває, наступні бульбашки інструментів врахують нове налаштування. ## Директиви трасування Plugin (/trace) - Рівні: `on` | `off` (за замовчуванням). -- Повідомлення лише з директивою перемикає вивід трасування Plugin для сесії та відповідає `Plugin trace enabled.` / `Plugin trace disabled.`. -- Вбудована директива впливає лише на це повідомлення; інакше застосовуються значення за замовчуванням для сесії/глобальні. +- Повідомлення лише з директивою перемикає вивід трасування Plugin для сесії та повертає `Трасування Plugin увімкнено.` / `Трасування Plugin вимкнено.`. +- Вбудована директива впливає лише на це повідомлення; інакше застосовуються значення сесії/глобальні за замовчуванням. - Надішліть `/trace` (або `/trace:`) без аргументу, щоб побачити поточний рівень трасування. -- `/trace` вужчий за `/verbose`: він показує лише рядки трасування/налагодження, що належать плагіну, як-от підсумки налагодження Active Memory. -- Рядки трасування можуть з’являтися в `/status` і як подальше діагностичне повідомлення після звичайної відповіді помічника. +- `/trace` вужчий за `/verbose`: він показує лише рядки трасування/налагодження, що належать плагінам, наприклад підсумки налагодження Active Memory. +- Рядки трасування можуть зʼявлятися в `/status` і як наступне діагностичне повідомлення після звичайної відповіді помічника. ## Видимість міркувань (/reasoning) - Рівні: `on|off|stream`. - Повідомлення лише з директивою перемикає, чи показуються блоки мислення у відповідях. -- Коли ввімкнено, reasoning надсилається як **окреме повідомлення** з префіксом `Reasoning:`. +- Коли цю функцію ввімкнено, reasoning надсилається як **окреме повідомлення** з префіксом `Reasoning:`. - `stream` (лише Telegram): транслює reasoning у чернетку бульбашки Telegram, поки генерується відповідь, а потім надсилає фінальну відповідь без reasoning. - Псевдонім: `/reason`. - Надішліть `/reasoning` (або `/reasoning:`) без аргументу, щоб побачити поточний рівень видимості міркувань. - Порядок визначення: вбудована директива, потім перевизначення сесії, потім значення за замовчуванням для агента (`agents.list[].reasoningDefault`), потім резервний варіант (`off`). -## Пов’язане +## Повʼязане -- Документація режиму elevated міститься в [Elevated mode](/uk/tools/elevated). +- Документація для elevated mode розміщена в [Elevated mode](/uk/tools/elevated). -## Heartbeat +## Heartbeats -- Тіло перевірки Heartbeat — це налаштований prompt heartbeat (типово: `Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`). Вбудовані директиви в повідомленні heartbeat застосовуються як зазвичай (але уникайте зміни значень сесії за замовчуванням через heartbeat). -- Доставка Heartbeat за замовчуванням надсилає лише фінальний payload. Щоб також надсилати окреме повідомлення `Reasoning:` (коли доступне), задайте `agents.defaults.heartbeat.includeReasoning: true` або `agents.list[].heartbeat.includeReasoning: true` для окремого агента. +- Тіло probe для Heartbeat — це налаштований prompt Heartbeat (за замовчуванням: `Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`). Вбудовані директиви в повідомленні Heartbeat застосовуються як зазвичай (але уникайте зміни значень сесії за замовчуванням із Heartbeat). +- Доставка Heartbeat за замовчуванням використовує лише фінальний payload. Щоб також надсилати окреме повідомлення `Reasoning:` (коли доступне), встановіть `agents.defaults.heartbeat.includeReasoning: true` або `agents.list[].heartbeat.includeReasoning: true` для конкретного агента. -## Веб-інтерфейс чату +## Інтерфейс вебчату -- Селектор мислення у веб-чаті відображає збережений рівень сесії зі сховища/конфігурації вхідної сесії під час завантаження сторінки. -- Вибір іншого рівня одразу записує перевизначення сесії через `sessions.patch`; він не чекає наступного надсилання і не є одноразовим перевизначенням `thinkingOnce`. -- Перший варіант завжди має вигляд `Default ()`, де визначене значення за замовчуванням надходить із профілю мислення провайдера для активної моделі сесії плюс та сама логіка резервного варіанта, яку використовують `/status` і `session_status`. -- Перемикач використовує `thinkingLevels`, повернуті рядком/defaults сесії Gateway, а `thinkingOptions` зберігаються як застарілий список міток. Інтерфейс браузера не зберігає власний список regex провайдерів; плагіни керують наборами рівнів, специфічними для моделі. -- `/think:` як і раніше працює та оновлює той самий збережений рівень сесії, тож директиви чату й перемикач залишаються синхронізованими. +- Селектор мислення у вебчаті відображає збережений для сесії рівень із вхідного сховища сесії/конфігурації під час завантаження сторінки. +- Вибір іншого рівня негайно записує перевизначення сесії через `sessions.patch`; він не чекає наступного надсилання і не є одноразовим перевизначенням `thinkingOnce`. +- Перший варіант завжди має вигляд `Default ()`, де визначене значення за замовчуванням походить із профілю мислення провайдера для активної моделі сесії плюс тієї самої резервної логіки, яку використовують `/status` і `session_status`. +- Перемикач використовує `thinkingLevels`, які повертаються рядком/defaults сесії Gateway, а `thinkingOptions` зберігається як застарілий список міток. Інтерфейс браузера не зберігає власний regex-список провайдерів; набори рівнів для конкретних моделей належать плагінам. +- `/think:` як і раніше працює та оновлює той самий збережений рівень сесії, тому директиви чату й перемикач залишаються синхронізованими. ## Профілі провайдерів - Плагіни провайдерів можуть надавати `resolveThinkingProfile(ctx)` для визначення підтримуваних рівнів моделі та значення за замовчуванням. - Кожен рівень профілю має збережений канонічний `id` (`off`, `minimal`, `low`, `medium`, `high`, `xhigh`, `adaptive` або `max`) і може містити відображувану `label`. Бінарні провайдери використовують `{ id: "low", label: "on" }`. -- Опубліковані застарілі хуки (`supportsXHighThinking`, `isBinaryThinking` і `resolveDefaultThinkingLevel`) залишаються адаптерами сумісності, але нові користувацькі набори рівнів слід реалізовувати через `resolveThinkingProfile`. -- Рядки/defaults Gateway надають `thinkingLevels`, `thinkingOptions` і `thinkingDefault`, щоб клієнти ACP/чату відображали ті самі id і label профілю, які використовує перевірка в runtime. +- Опубліковані застарілі хуки (`supportsXHighThinking`, `isBinaryThinking` і `resolveDefaultThinkingLevel`) залишаються як адаптери сумісності, але нові користувацькі набори рівнів мають використовувати `resolveThinkingProfile`. +- Рядки/defaults Gateway надають `thinkingLevels`, `thinkingOptions` і `thinkingDefault`, щоб клієнти ACP/чату відображали ті самі `id` і мітки профілю, які використовує валідація runtime.