chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
b3901b9fb8
commit
8fd4ed1349
@ -1,19 +1,19 @@
|
||||
---
|
||||
read_when:
|
||||
- Транспорт каналу показує підключення, але відповіді не працюють
|
||||
- Вам потрібні перевірки, специфічні для каналу, перед глибшим зануренням у документацію провайдерів
|
||||
summary: Швидке усунення несправностей на рівні каналу з типовими збоями для кожного каналу та способами виправлення
|
||||
title: Усунення несправностей каналів
|
||||
- Транспорт каналу показує, що підключений, але відповіді не надсилаються
|
||||
- Перед поглибленим розглядом документації провайдера потрібні перевірки, специфічні для каналу
|
||||
summary: Швидке усунення несправностей на рівні каналу з типовими ознаками збоїв і способами виправлення
|
||||
title: Усунення несправностей каналу
|
||||
x-i18n:
|
||||
generated_at: "2026-04-05T17:59:39Z"
|
||||
generated_at: "2026-04-20T06:31:08Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: d45d8220505ea420d970b20bc66e65216c2d7024b5736db1936421ffc0676e1f
|
||||
source_hash: 0aef31742cd5cc4af3fa3d3ea1acba51875ad4a1423c0e8c87372c3df31b0528
|
||||
source_path: channels/troubleshooting.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Усунення несправностей каналів
|
||||
# Усунення несправностей каналу
|
||||
|
||||
Використовуйте цю сторінку, коли канал підключається, але працює неправильно.
|
||||
|
||||
@ -29,112 +29,113 @@ openclaw doctor
|
||||
openclaw channels status --probe
|
||||
```
|
||||
|
||||
Ознаки здорового базового стану:
|
||||
Ознаки справного базового стану:
|
||||
|
||||
- `Runtime: running`
|
||||
- `RPC probe: ok`
|
||||
- Перевірка каналу показує, що транспорт підключено і, де це підтримується, `works` або `audit ok`
|
||||
- `Connectivity probe: ok`
|
||||
- `Capability: read-only`, `write-capable` або `admin-capable`
|
||||
- Перевірка каналу показує, що транспорт підключений і, де це підтримується, `works` або `audit ok`
|
||||
|
||||
## WhatsApp
|
||||
|
||||
### Типові збої WhatsApp
|
||||
### Ознаки збоїв у WhatsApp
|
||||
|
||||
| Симптом | Найшвидша перевірка | Виправлення |
|
||||
| ------------------------------- | -------------------------------------------------- | ------------------------------------------------------ |
|
||||
| Підключено, але немає відповідей у приватних повідомленнях | `openclaw pairing list whatsapp` | Підтвердьте відправника або змініть політику приватних повідомлень/allowlist. |
|
||||
| Групові повідомлення ігноруються | Перевірте `requireMention` + шаблони згадок у конфігурації | Згадайте бота або послабте політику згадок для цієї групи. |
|
||||
| Випадкові цикли відключення/повторного входу | `openclaw channels status --probe` + журнали | Увійдіть знову й перевірте, що каталог облікових даних у належному стані. |
|
||||
| Симптом | Найшвидша перевірка | Виправлення |
|
||||
| ------------------------------- | -------------------------------------------------- | ------------------------------------------------------------ |
|
||||
| Підключено, але немає відповідей у DM | `openclaw pairing list whatsapp` | Підтвердьте відправника або змініть політику DM/список дозволених. |
|
||||
| Повідомлення в групі ігноруються | Перевірте `requireMention` і шаблони згадок у конфігурації | Згадайте бота або послабте політику згадок для цієї групи. |
|
||||
| Випадкові цикли відключення/повторного входу | `openclaw channels status --probe` + журнали | Увійдіть знову та переконайтеся, що каталог облікових даних справний. |
|
||||
|
||||
Повне усунення несправностей: [/channels/whatsapp#troubleshooting](/channels/whatsapp#troubleshooting)
|
||||
Повне усунення несправностей: [/channels/whatsapp#troubleshooting](/uk/channels/whatsapp#troubleshooting)
|
||||
|
||||
## Telegram
|
||||
|
||||
### Типові збої Telegram
|
||||
### Ознаки збоїв у Telegram
|
||||
|
||||
| Симптом | Найшвидша перевірка | Виправлення |
|
||||
| ----------------------------------- | ------------------------------------------- | --------------------------------------------------------------------------- |
|
||||
| `/start`, але немає придатного сценарію відповіді | `openclaw pairing list telegram` | Підтвердьте прив’язку або змініть політику приватних повідомлень. |
|
||||
| Бот онлайн, але в групі мовчить | Перевірте вимогу згадки та режим приватності бота | Вимкніть режим приватності для видимості в групі або згадайте бота. |
|
||||
| Збої надсилання з мережевими помилками | Перегляньте журнали на предмет збоїв викликів API Telegram | Виправте DNS/IPv6/маршрутизацію через проксі до `api.telegram.org`. |
|
||||
| `setMyCommands` відхиляється під час запуску | Перегляньте журнали на предмет `BOT_COMMANDS_TOO_MUCH` | Зменште кількість команд Telegram від plugins/Skills/користувацьких команд або вимкніть рідні меню. |
|
||||
| Після оновлення allowlist блокує вас | `openclaw security audit` і allowlist у конфігурації | Запустіть `openclaw doctor --fix` або замініть `@username` на числові ID відправників. |
|
||||
| Симптом | Найшвидша перевірка | Виправлення |
|
||||
| ----------------------------------- | ------------------------------------------- | ------------------------------------------------------------------------ |
|
||||
| `/start`, але немає придатного для використання потоку відповідей | `openclaw pairing list telegram` | Підтвердьте сполучення або змініть політику DM. |
|
||||
| Бот онлайн, але група мовчить | Перевірте вимогу згадки та режим приватності бота | Вимкніть режим приватності для видимості в групі або згадайте бота. |
|
||||
| Помилки надсилання з мережевими помилками | Перегляньте журнали на помилки викликів Telegram API | Виправте маршрутизацію DNS/IPv6/proxy до `api.telegram.org`. |
|
||||
| `setMyCommands` відхиляється під час запуску | Перегляньте журнали на `BOT_COMMANDS_TOO_MUCH` | Зменште кількість команд Telegram від Plugin/Skills/власних команд або вимкніть вбудовані меню. |
|
||||
| Після оновлення список дозволених вас блокує | `openclaw security audit` і списки дозволених у конфігурації | Виконайте `openclaw doctor --fix` або замініть `@username` на числові ідентифікатори відправників. |
|
||||
|
||||
Повне усунення несправностей: [/channels/telegram#troubleshooting](/channels/telegram#troubleshooting)
|
||||
Повне усунення несправностей: [/channels/telegram#troubleshooting](/uk/channels/telegram#troubleshooting)
|
||||
|
||||
## Discord
|
||||
|
||||
### Типові збої Discord
|
||||
### Ознаки збоїв у Discord
|
||||
|
||||
| Симптом | Найшвидша перевірка | Виправлення |
|
||||
| ------------------------------- | ---------------------------------------- | -------------------------------------------------------- |
|
||||
| Бот онлайн, але немає відповідей у guild | `openclaw channels status --probe` | Дозвольте guild/канал і перевірте intent вмісту повідомлень. |
|
||||
| Групові повідомлення ігноруються | Перевірте журнали на відхилення через керування згадками | Згадайте бота або встановіть `requireMention: false` для guild/каналу. |
|
||||
| Немає відповідей у приватних повідомленнях | `openclaw pairing list discord` | Підтвердьте прив’язку приватних повідомлень або змініть політику приватних повідомлень. |
|
||||
| Симптом | Найшвидша перевірка | Виправлення |
|
||||
| ------------------------------- | -------------------------------- | -------------------------------------------------------- |
|
||||
| Бот онлайн, але не відповідає в guild | `openclaw channels status --probe` | Дозвольте guild/channel і перевірте intent вмісту повідомлень. |
|
||||
| Повідомлення в групі ігноруються | Перевірте журнали на відхилення через згадки | Згадайте бота або встановіть `requireMention: false` для guild/channel. |
|
||||
| Немає відповідей у DM | `openclaw pairing list discord` | Підтвердьте сполучення DM або скоригуйте політику DM. |
|
||||
|
||||
Повне усунення несправностей: [/channels/discord#troubleshooting](/channels/discord#troubleshooting)
|
||||
Повне усунення несправностей: [/channels/discord#troubleshooting](/uk/channels/discord#troubleshooting)
|
||||
|
||||
## Slack
|
||||
|
||||
### Типові збої Slack
|
||||
### Ознаки збоїв у Slack
|
||||
|
||||
| Симптом | Найшвидша перевірка | Виправлення |
|
||||
| -------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Socket mode підключено, але немає відповідей | `openclaw channels status --probe` | Перевірте токен застосунку + токен бота і потрібні дозволи; зверніть увагу на `botTokenStatus` / `appTokenStatus = configured_unavailable` у конфігураціях на основі SecretRef. |
|
||||
| Приватні повідомлення заблоковано | `openclaw pairing list slack` | Підтвердьте прив’язку або послабте політику приватних повідомлень. |
|
||||
| Повідомлення в каналі ігноруються | Перевірте `groupPolicy` і allowlist каналів | Дозвольте канал або змініть політику на `open`. |
|
||||
| Симптом | Найшвидша перевірка | Виправлення |
|
||||
| -------------------------------------- | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Socket mode підключено, але немає відповідей | `openclaw channels status --probe` | Перевірте токен застосунку, токен бота та потрібні дозволи; зверніть увагу на `botTokenStatus` / `appTokenStatus = configured_unavailable` у налаштуваннях на основі SecretRef. |
|
||||
| DM заблоковані | `openclaw pairing list slack` | Підтвердьте сполучення або послабте політику DM. |
|
||||
| Повідомлення в каналі ігнорується | Перевірте `groupPolicy` і список дозволених каналів | Дозвольте канал або перемкніть політику на `open`. |
|
||||
|
||||
Повне усунення несправностей: [/channels/slack#troubleshooting](/channels/slack#troubleshooting)
|
||||
Повне усунення несправностей: [/channels/slack#troubleshooting](/uk/channels/slack#troubleshooting)
|
||||
|
||||
## iMessage і BlueBubbles
|
||||
|
||||
### Типові збої iMessage і BlueBubbles
|
||||
### Ознаки збоїв у iMessage і BlueBubbles
|
||||
|
||||
| Симптом | Найшвидша перевірка | Виправлення |
|
||||
| -------------------------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------- |
|
||||
| Немає вхідних подій | Перевірте доступність webhook/сервера та дозволи застосунку | Виправте URL webhook або стан сервера BlueBubbles. |
|
||||
| Можна надсилати, але не отримувати на macOS | Перевірте дозволи конфіденційності macOS для автоматизації Messages | Повторно надайте дозволи TCC і перезапустіть процес каналу. |
|
||||
| Відправника приватних повідомлень заблоковано | `openclaw pairing list imessage` або `openclaw pairing list bluebubbles` | Підтвердьте прив’язку або оновіть allowlist. |
|
||||
| Симптом | Найшвидша перевірка | Виправлення |
|
||||
| -------------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------- |
|
||||
| Немає вхідних подій | Перевірте доступність Webhook/сервера та дозволи застосунку | Виправте URL Webhook або стан сервера BlueBubbles. |
|
||||
| Можна надсилати, але немає прийому на macOS | Перевірте дозволи конфіденційності macOS для автоматизації Messages | Повторно надайте дозволи TCC і перезапустіть процес каналу. |
|
||||
| Відправника DM заблоковано | `openclaw pairing list imessage` або `openclaw pairing list bluebubbles` | Підтвердьте сполучення або оновіть список дозволених. |
|
||||
|
||||
Повне усунення несправностей:
|
||||
|
||||
- [/channels/imessage#troubleshooting](/channels/imessage#troubleshooting)
|
||||
- [/channels/bluebubbles#troubleshooting](/channels/bluebubbles#troubleshooting)
|
||||
- [/channels/imessage#troubleshooting](/uk/channels/imessage#troubleshooting)
|
||||
- [/channels/bluebubbles#troubleshooting](/uk/channels/bluebubbles#troubleshooting)
|
||||
|
||||
## Signal
|
||||
|
||||
### Типові збої Signal
|
||||
### Ознаки збоїв у Signal
|
||||
|
||||
| Симптом | Найшвидша перевірка | Виправлення |
|
||||
| ------------------------------- | --------------------------------------- | ------------------------------------------------------- |
|
||||
| Демон доступний, але бот мовчить | `openclaw channels status --probe` | Перевірте URL/обліковий запис демона `signal-cli` і режим отримання. |
|
||||
| Приватні повідомлення заблоковано | `openclaw pairing list signal` | Підтвердьте відправника або змініть політику приватних повідомлень. |
|
||||
| Відповіді в групі не запускаються | Перевірте allowlist групи та шаблони згадок | Додайте відправника/групу або послабте керування. |
|
||||
| Симптом | Найшвидша перевірка | Виправлення |
|
||||
| ------------------------------- | ----------------------------------- | ------------------------------------------------------- |
|
||||
| Демон доступний, але бот мовчить | `openclaw channels status --probe` | Перевірте URL/обліковий запис демона `signal-cli` і режим прийому. |
|
||||
| DM заблоковано | `openclaw pairing list signal` | Підтвердьте відправника або скоригуйте політику DM. |
|
||||
| Відповіді в групі не спрацьовують | Перевірте список дозволених груп і шаблони згадок | Додайте відправника/групу або послабте фільтрацію. |
|
||||
|
||||
Повне усунення несправностей: [/channels/signal#troubleshooting](/channels/signal#troubleshooting)
|
||||
Повне усунення несправностей: [/channels/signal#troubleshooting](/uk/channels/signal#troubleshooting)
|
||||
|
||||
## QQ Bot
|
||||
|
||||
### Типові збої QQ Bot
|
||||
### Ознаки збоїв у QQ Bot
|
||||
|
||||
| Симптом | Найшвидша перевірка | Виправлення |
|
||||
| ------------------------------- | ---------------------------------------- | -------------------------------------------------------------- |
|
||||
| Бот відповідає "gone to Mars" | Перевірте `appId` і `clientSecret` у конфігурації | Задайте облікові дані або перезапустіть gateway. |
|
||||
| Немає вхідних повідомлень | `openclaw channels status --probe` | Перевірте облікові дані на QQ Open Platform. |
|
||||
| Голос не транскрибується | Перевірте конфігурацію провайдера STT | Налаштуйте `channels.qqbot.stt` або `tools.media.audio`. |
|
||||
| Проактивні повідомлення не надходять | Перевірте вимоги платформи QQ до взаємодії | QQ може блокувати повідомлення, ініційовані ботом, без нещодавньої взаємодії. |
|
||||
| Симптом | Найшвидша перевірка | Виправлення |
|
||||
| ------------------------------- | -------------------------------------------- | -------------------------------------------------------------------- |
|
||||
| Бот відповідає "gone to Mars" | Перевірте `appId` і `clientSecret` у конфігурації | Налаштуйте облікові дані або перезапустіть Gateway. |
|
||||
| Немає вхідних повідомлень | `openclaw channels status --probe` | Перевірте облікові дані на QQ Open Platform. |
|
||||
| Голос не транскрибується | Перевірте конфігурацію провайдера STT | Налаштуйте `channels.qqbot.stt` або `tools.media.audio`. |
|
||||
| Проактивні повідомлення не надходять | Перевірте вимоги платформи QQ щодо взаємодії | QQ може блокувати повідомлення, ініційовані ботом, без недавньої взаємодії. |
|
||||
|
||||
Повне усунення несправностей: [/channels/qqbot#troubleshooting](/channels/qqbot#troubleshooting)
|
||||
Повне усунення несправностей: [/channels/qqbot#troubleshooting](/uk/channels/qqbot#troubleshooting)
|
||||
|
||||
## Matrix
|
||||
|
||||
### Типові збої Matrix
|
||||
### Ознаки збоїв у Matrix
|
||||
|
||||
| Симптом | Найшвидша перевірка | Виправлення |
|
||||
| ----------------------------------- | ------------------------------------ | ---------------------------------------------------------------------------- |
|
||||
| Вхід виконано, але повідомлення в кімнаті ігноруються | `openclaw channels status --probe` | Перевірте `groupPolicy`, allowlist кімнат і керування згадками. |
|
||||
| Приватні повідомлення не обробляються | `openclaw pairing list matrix` | Підтвердьте відправника або змініть політику приватних повідомлень. |
|
||||
| Зашифровані кімнати не працюють | `openclaw matrix verify status` | Повторно підтвердьте пристрій, потім перевірте `openclaw matrix verify backup status`. |
|
||||
| Відновлення резервної копії очікує/зламане | `openclaw matrix verify backup status` | Запустіть `openclaw matrix verify backup restore` або повторіть із ключем відновлення. |
|
||||
| Cross-signing/bootstrap виглядає неправильно | `openclaw matrix verify bootstrap` | Виправте secret storage, cross-signing і стан резервної копії за один прохід. |
|
||||
| Симптом | Найшвидша перевірка | Виправлення |
|
||||
| ----------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------ |
|
||||
| Вхід виконано, але повідомлення кімнати ігноруються | `openclaw channels status --probe` | Перевірте `groupPolicy`, список дозволених кімнат і фільтрацію за згадками. |
|
||||
| DM не обробляються | `openclaw pairing list matrix` | Підтвердьте відправника або скоригуйте політику DM. |
|
||||
| Зашифровані кімнати не працюють | `openclaw matrix verify status` | Повторно верифікуйте пристрій, потім перевірте `openclaw matrix verify backup status`. |
|
||||
| Відновлення резервної копії очікується/зламане | `openclaw matrix verify backup status` | Виконайте `openclaw matrix verify backup restore` або повторіть із ключем відновлення. |
|
||||
| Cross-signing/bootstrap виглядає неправильно | `openclaw matrix verify bootstrap` | За один прохід виправте секретне сховище, cross-signing і стан резервної копії. |
|
||||
|
||||
Повне налаштування й конфігурація: [Matrix](/channels/matrix)
|
||||
Повне налаштування і конфігурація: [Matrix](/uk/channels/matrix)
|
||||
|
||||
@ -1,33 +1,33 @@
|
||||
---
|
||||
read_when:
|
||||
- Запуск або налагодження процесу gateway
|
||||
summary: Операційний посібник для служби Gateway, її життєвого циклу та експлуатації
|
||||
title: Операційний посібник Gateway
|
||||
summary: Посібник з експлуатації для служби Gateway, її життєвого циклу та операцій
|
||||
title: Посібник з експлуатації Gateway
|
||||
x-i18n:
|
||||
generated_at: "2026-04-06T15:28:26Z"
|
||||
generated_at: "2026-04-20T06:31:08Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: fd2c21036e88612861ef2195b8ff7205aca31386bb11558614ade8d1a54fdebd
|
||||
source_hash: e1004cdd43b1db6794f3ca83da38dbdb231a1976329d9d6d851e2b02405278d8
|
||||
source_path: gateway/index.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Операційний посібник Gateway
|
||||
# Посібник з експлуатації Gateway
|
||||
|
||||
Використовуйте цю сторінку для запуску Gateway у перший день і для операційної роботи надалі.
|
||||
Використовуйте цю сторінку для запуску в перший день і операцій другого дня для служби Gateway.
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Поглиблене усунення неполадок" icon="siren" href="/uk/gateway/troubleshooting">
|
||||
Діагностика за симптомами з точними послідовностями команд і сигнатурами журналів.
|
||||
<Card title="Поглиблене усунення несправностей" icon="siren" href="/uk/gateway/troubleshooting">
|
||||
Діагностика, що починається із симптому, з точними послідовностями команд і сигнатурами журналів.
|
||||
</Card>
|
||||
<Card title="Configuration" icon="sliders" href="/uk/gateway/configuration">
|
||||
Практичний посібник із налаштування + повний довідник конфігурації.
|
||||
<Card title="Конфігурація" icon="sliders" href="/uk/gateway/configuration">
|
||||
Посібник із налаштування, орієнтований на завдання, + повний довідник з конфігурації.
|
||||
</Card>
|
||||
<Card title="Керування секретами" icon="key-round" href="/uk/gateway/secrets">
|
||||
Контракт SecretRef, поведінка знімків під час виконання та операції міграції/перезавантаження.
|
||||
</Card>
|
||||
<Card title="Контракт плану секретів" icon="shield-check" href="/uk/gateway/secrets-plan-contract">
|
||||
Точні правила target/path для `secrets apply` і поведінка профілю автентифікації лише з посиланнями.
|
||||
Точні правила target/path для `secrets apply` і поведінка auth-profile лише з ref.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
@ -38,9 +38,9 @@ x-i18n:
|
||||
|
||||
```bash
|
||||
openclaw gateway --port 18789
|
||||
# debug/trace дзеркально виводяться у stdio
|
||||
# debug/trace дзеркаляться в stdio
|
||||
openclaw gateway --port 18789 --verbose
|
||||
# примусово завершує процес, що слухає вибраний порт, а потім запускає
|
||||
# примусово вбити listener на вибраному порту, потім запустити
|
||||
openclaw gateway --force
|
||||
```
|
||||
|
||||
@ -54,7 +54,7 @@ openclaw status
|
||||
openclaw logs --follow
|
||||
```
|
||||
|
||||
Базовий справний стан: `Runtime: running` і `RPC probe: ok`.
|
||||
Базовий здоровий стан: `Runtime: running`, `Connectivity probe: ok` і `Capability: ...`, що відповідає вашим очікуванням. Використовуйте `openclaw gateway status --require-rpc`, коли вам потрібне підтвердження RPC з областю читання, а не лише досяжність.
|
||||
|
||||
</Step>
|
||||
|
||||
@ -64,35 +64,35 @@ openclaw logs --follow
|
||||
openclaw channels status --probe
|
||||
```
|
||||
|
||||
За доступного gateway ця команда виконує живі перевірки каналів для кожного облікового запису та необов’язкові аудити.
|
||||
Якщо gateway недоступний, CLI повертається до зведень каналів лише за конфігурацією
|
||||
замість виводу живих probe-перевірок.
|
||||
За наявності доступного gateway це виконує живі зондування каналів для кожного облікового запису та необов’язкові аудити.
|
||||
Якщо gateway недоступний, CLI повертається до зведень каналів лише з конфігурації
|
||||
замість виводу живого зондування.
|
||||
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
<Note>
|
||||
Перезавантаження конфігурації Gateway відстежує активний шлях до файла конфігурації (визначений із типових значень профілю/стану або через `OPENCLAW_CONFIG_PATH`, якщо його задано).
|
||||
Типовий режим — `gateway.reload.mode="hybrid"`.
|
||||
Після першого успішного завантаження запущений процес обслуговує активний знімок конфігурації в пам’яті; успішне перезавантаження атомарно підміняє цей знімок.
|
||||
Перезавантаження конфігурації Gateway відстежує активний шлях до файла конфігурації (визначений із профілю/стану за замовчуванням або через `OPENCLAW_CONFIG_PATH`, якщо його задано).
|
||||
Режим за замовчуванням — `gateway.reload.mode="hybrid"`.
|
||||
Після першого успішного завантаження запущений процес обслуговує активний знімок конфігурації в пам’яті; успішне перезавантаження атомарно замінює цей знімок.
|
||||
</Note>
|
||||
|
||||
## Модель виконання
|
||||
|
||||
- Один постійно активний процес для маршрутизації, control plane та підключень каналів.
|
||||
- Один постійно запущений процес для маршрутизації, control plane і підключень каналів.
|
||||
- Один мультиплексований порт для:
|
||||
- контролю WebSocket/RPC
|
||||
- WebSocket control/RPC
|
||||
- HTTP API, сумісних з OpenAI (`/v1/models`, `/v1/embeddings`, `/v1/chat/completions`, `/v1/responses`, `/tools/invoke`)
|
||||
- Control UI та hooks
|
||||
- Типовий режим прив’язки: `loopback`.
|
||||
- Автентифікація за замовчуванням обов’язкова. Налаштування зі спільним секретом використовують
|
||||
- Control UI і hooks
|
||||
- Режим прив’язки за замовчуванням: `loopback`.
|
||||
- Автентифікація обов’язкова за замовчуванням. У конфігураціях зі спільним секретом використовуйте
|
||||
`gateway.auth.token` / `gateway.auth.password` (або
|
||||
`OPENCLAW_GATEWAY_TOKEN` / `OPENCLAW_GATEWAY_PASSWORD`), а конфігурації
|
||||
reverse proxy поза loopback можуть використовувати `gateway.auth.mode: "trusted-proxy"`.
|
||||
`OPENCLAW_GATEWAY_TOKEN` / `OPENCLAW_GATEWAY_PASSWORD`), а для конфігурацій
|
||||
reverse proxy не на `loopback` можна використовувати `gateway.auth.mode: "trusted-proxy"`.
|
||||
|
||||
## Кінцеві точки, сумісні з OpenAI
|
||||
## Сумісні з OpenAI endpoint-и
|
||||
|
||||
Найважливіша поверхня сумісності OpenClaw тепер така:
|
||||
Найцінніша поверхня сумісності OpenClaw зараз:
|
||||
|
||||
- `GET /v1/models`
|
||||
- `GET /v1/models/{id}`
|
||||
@ -104,31 +104,31 @@ openclaw channels status --probe
|
||||
|
||||
- Більшість інтеграцій Open WebUI, LobeChat і LibreChat спочатку перевіряють `/v1/models`.
|
||||
- Багато конвеєрів RAG і пам’яті очікують `/v1/embeddings`.
|
||||
- Клієнти, орієнтовані на агентів, дедалі частіше надають перевагу `/v1/responses`.
|
||||
- Клієнти, орієнтовані на агентів, дедалі частіше віддають перевагу `/v1/responses`.
|
||||
|
||||
Примітка щодо планування:
|
||||
|
||||
- `/v1/models` орієнтований насамперед на агентів: він повертає `openclaw`, `openclaw/default` і `openclaw/<agentId>`.
|
||||
- `/v1/models` орієнтований на агентів: він повертає `openclaw`, `openclaw/default` і `openclaw/<agentId>`.
|
||||
- `openclaw/default` — це стабільний псевдонім, який завжди вказує на налаштованого агента за замовчуванням.
|
||||
- Використовуйте `x-openclaw-model`, якщо вам потрібно перевизначити постачальника/модель бекенда; інакше вибраний агент і надалі керуватиме звичайним налаштуванням моделі та вбудовувань.
|
||||
- Використовуйте `x-openclaw-model`, якщо вам потрібно перевизначити backend provider/model; інакше керування зберігають звичайні налаштування моделі та embeddings вибраного агента.
|
||||
|
||||
Усе це працює на основному порту Gateway і використовує той самий довірений периметр автентифікації оператора, що й решта HTTP API Gateway.
|
||||
Усе це працює на основному порту Gateway і використовує ту саму межу автентифікації довіреного оператора, що й решта HTTP API Gateway.
|
||||
|
||||
### Пріоритет порту та режиму прив’язки
|
||||
### Пріоритет порту і режиму прив’язки
|
||||
|
||||
| Параметр | Порядок визначення |
|
||||
| -------- | ------------------ |
|
||||
| Порт Gateway | `--port` → `OPENCLAW_GATEWAY_PORT` → `gateway.port` → `18789` |
|
||||
| Режим прив’язки | CLI/override → `gateway.bind` → `loopback` |
|
||||
| Налаштування | Порядок визначення |
|
||||
| ------------ | -------------------------------------------------------------- |
|
||||
| Порт Gateway | `--port` → `OPENCLAW_GATEWAY_PORT` → `gateway.port` → `18789` |
|
||||
| Режим прив’язки | CLI/override → `gateway.bind` → `loopback` |
|
||||
|
||||
### Режими гарячого перезавантаження
|
||||
|
||||
| `gateway.reload.mode` | Поведінка |
|
||||
| --------------------- | --------- |
|
||||
| `off` | Без перезавантаження конфігурації |
|
||||
| `hot` | Застосовує лише зміни, безпечні для hot-reload |
|
||||
| `restart` | Перезапускає за змін, що вимагають перезапуску |
|
||||
| `hybrid` (типово) | Гаряче застосовує, коли безпечно, і перезапускає, коли потрібно |
|
||||
| `gateway.reload.mode` | Поведінка |
|
||||
| --------------------- | ----------------------------------------- |
|
||||
| `off` | Без перезавантаження конфігурації |
|
||||
| `hot` | Застосовувати лише безпечні для hot зміни |
|
||||
| `restart` | Перезапуск при змінах, що вимагають reload |
|
||||
| `hybrid` (за замовчуванням) | Hot-застосування, коли безпечно, перезапуск, коли потрібно |
|
||||
|
||||
## Набір команд оператора
|
||||
|
||||
@ -145,14 +145,14 @@ openclaw doctor
|
||||
```
|
||||
|
||||
`gateway status --deep` призначено для додаткового виявлення служб (LaunchDaemons/systemd system
|
||||
units/schtasks), а не для глибшої RPC-перевірки стану.
|
||||
units/schtasks), а не для глибшого RPC-зондування стану.
|
||||
|
||||
## Кілька gateway на одному хості
|
||||
|
||||
У більшості встановлень має працювати один gateway на машину. Один gateway може обслуговувати кількох
|
||||
У більшості інсталяцій має працювати один gateway на машину. Один gateway може обслуговувати кількох
|
||||
агентів і канали.
|
||||
|
||||
Кілька gateway потрібні лише тоді, коли вам навмисно потрібна ізоляція або резервний бот.
|
||||
Кілька gateway потрібні лише тоді, коли ви навмисно хочете ізоляцію або резервного бота.
|
||||
|
||||
Корисні перевірки:
|
||||
|
||||
@ -164,35 +164,35 @@ openclaw gateway probe
|
||||
Що очікувати:
|
||||
|
||||
- `gateway status --deep` може повідомити `Other gateway-like services detected (best effort)`
|
||||
і вивести підказки з очищення, якщо навколо лишилися застарілі встановлення launchd/systemd/schtasks.
|
||||
- `gateway probe` може попередити про `multiple reachable gateways`, коли відповідає
|
||||
більше однієї цілі.
|
||||
- Якщо це навмисно, ізолюйте порти, config/state і корені workspace для кожного gateway окремо.
|
||||
і вивести підказки з очищення, якщо все ще присутні застарілі інсталяції launchd/systemd/schtasks.
|
||||
- `gateway probe` може попередити про `multiple reachable gateways`, якщо відповідає більше
|
||||
ніж одна ціль.
|
||||
- Якщо це навмисно, ізолюйте порти, конфігурацію/стан і корені workspace для кожного gateway.
|
||||
|
||||
Детальне налаштування: [/gateway/multiple-gateways](/uk/gateway/multiple-gateways).
|
||||
Докладне налаштування: [/gateway/multiple-gateways](/uk/gateway/multiple-gateways).
|
||||
|
||||
## Віддалений доступ
|
||||
|
||||
Рекомендовано: Tailscale/VPN.
|
||||
Резервний варіант: SSH-тунель.
|
||||
Запасний варіант: SSH-тунель.
|
||||
|
||||
```bash
|
||||
ssh -N -L 18789:127.0.0.1:18789 user@host
|
||||
```
|
||||
|
||||
Потім підключайте клієнти локально до `ws://127.0.0.1:18789`.
|
||||
Потім підключайте клієнтів локально до `ws://127.0.0.1:18789`.
|
||||
|
||||
<Warning>
|
||||
SSH-тунелі не обходять автентифікацію gateway. Для автентифікації зі спільним секретом клієнти все одно
|
||||
мають надсилати `token`/`password` навіть через тунель. Для режимів з ідентифікацією
|
||||
запит усе одно має задовольняти цей шлях автентифікації.
|
||||
мають надсилати `token`/`password` навіть через тунель. Для режимів з ідентичністю
|
||||
запит усе одно має відповідати цьому шляху автентифікації.
|
||||
</Warning>
|
||||
|
||||
Див.: [Remote Gateway](/uk/gateway/remote), [Authentication](/uk/gateway/authentication), [Tailscale](/uk/gateway/tailscale).
|
||||
|
||||
## Нагляд і життєвий цикл служби
|
||||
|
||||
Для надійності на рівні production використовуйте запуск під наглядом.
|
||||
Для надійності, подібної до production, використовуйте керовані запуски.
|
||||
|
||||
<Tabs>
|
||||
<Tab title="macOS (launchd)">
|
||||
@ -204,7 +204,7 @@ openclaw gateway restart
|
||||
openclaw gateway stop
|
||||
```
|
||||
|
||||
Мітки LaunchAgent: `ai.openclaw.gateway` (типово) або `ai.openclaw.<profile>` (іменований профіль). `openclaw doctor` перевіряє і виправляє дрейф конфігурації служби.
|
||||
Мітки LaunchAgent: `ai.openclaw.gateway` (за замовчуванням) або `ai.openclaw.<profile>` (іменований профіль). `openclaw doctor` перевіряє та виправляє дрейф конфігурації служби.
|
||||
|
||||
</Tab>
|
||||
|
||||
@ -216,13 +216,13 @@ systemctl --user enable --now openclaw-gateway[-<profile>].service
|
||||
openclaw gateway status
|
||||
```
|
||||
|
||||
Щоб служба лишалася активною після виходу з сеансу, увімкніть lingering:
|
||||
Для збереження після виходу із системи ввімкніть lingering:
|
||||
|
||||
```bash
|
||||
sudo loginctl enable-linger <user>
|
||||
```
|
||||
|
||||
Приклад user-unit вручну, коли потрібен власний шлях встановлення:
|
||||
Приклад ручного user-unit, коли потрібен власний шлях інсталяції:
|
||||
|
||||
```ini
|
||||
[Unit]
|
||||
@ -254,25 +254,25 @@ openclaw gateway restart
|
||||
openclaw gateway stop
|
||||
```
|
||||
|
||||
Керований нативний автозапуск у Windows використовує Scheduled Task з назвою `OpenClaw Gateway`
|
||||
Керований автозапуск у Windows використовує Scheduled Task з назвою `OpenClaw Gateway`
|
||||
(або `OpenClaw Gateway (<profile>)` для іменованих профілів). Якщо створення Scheduled Task
|
||||
заборонено, OpenClaw переходить до launcher у Startup-folder для поточного користувача,
|
||||
заборонене, OpenClaw повертається до launcher у Startup-folder для поточного користувача,
|
||||
який вказує на `gateway.cmd` у каталозі стану.
|
||||
|
||||
</Tab>
|
||||
|
||||
<Tab title="Linux (system service)">
|
||||
|
||||
Використовуйте системний unit для багатокористувацьких/постійно активних хостів.
|
||||
Використовуйте system unit для багатокористувацьких/постійно активних хостів.
|
||||
|
||||
```bash
|
||||
sudo systemctl daemon-reload
|
||||
sudo systemctl enable --now openclaw-gateway[-<profile>].service
|
||||
```
|
||||
|
||||
Використовуйте той самий вміст служби, що й для user unit, але встановіть його в
|
||||
`/etc/systemd/system/openclaw-gateway[-<profile>].service` і скоригуйте
|
||||
`ExecStart=`, якщо ваш бінарний файл `openclaw` розташований в іншому місці.
|
||||
Використовуйте той самий вміст служби, що й для user unit, але встановлюйте його в
|
||||
`/etc/systemd/system/openclaw-gateway[-<profile>].service` і за потреби змініть
|
||||
`ExecStart=`, якщо ваш бінарний файл `openclaw` розміщений в іншому місці.
|
||||
|
||||
</Tab>
|
||||
</Tabs>
|
||||
@ -280,7 +280,7 @@ sudo systemctl enable --now openclaw-gateway[-<profile>].service
|
||||
## Кілька gateway на одному хості
|
||||
|
||||
У більшості конфігурацій має працювати **один** Gateway.
|
||||
Використовуйте кілька лише для суворої ізоляції/резервування (наприклад, профіль відновлення).
|
||||
Використовуйте кілька лише для суворої ізоляції/надлишковості (наприклад, резервний профіль).
|
||||
|
||||
Контрольний список для кожного екземпляра:
|
||||
|
||||
@ -298,7 +298,7 @@ OPENCLAW_CONFIG_PATH=~/.openclaw/b.json OPENCLAW_STATE_DIR=~/.openclaw-b opencla
|
||||
|
||||
Див.: [Multiple gateways](/uk/gateway/multiple-gateways).
|
||||
|
||||
### Швидкий шлях для dev-профілю
|
||||
### Швидкий шлях для dev profile
|
||||
|
||||
```bash
|
||||
openclaw --dev setup
|
||||
@ -308,32 +308,32 @@ openclaw --dev status
|
||||
|
||||
Типові значення включають ізольовані state/config і базовий порт gateway `19001`.
|
||||
|
||||
## Коротка довідка з протоколу (погляд оператора)
|
||||
## Короткий довідник з протоколу (погляд оператора)
|
||||
|
||||
- Перший кадр клієнта має бути `connect`.
|
||||
- Першим кадром клієнта має бути `connect`.
|
||||
- Gateway повертає знімок `hello-ok` (`presence`, `health`, `stateVersion`, `uptimeMs`, limits/policy).
|
||||
- `hello-ok.features.methods` / `events` — це консервативний список виявлення, а не
|
||||
згенерований дамп усіх доступних маршрутів helper.
|
||||
згенерований дамп кожного доступного допоміжного маршруту.
|
||||
- Запити: `req(method, params)` → `res(ok/payload|error)`.
|
||||
- До поширених подій належать `connect.challenge`, `agent`, `chat`,
|
||||
- Поширені події включають `connect.challenge`, `agent`, `chat`,
|
||||
`session.message`, `session.tool`, `sessions.changed`, `presence`, `tick`,
|
||||
`health`, `heartbeat`, події життєвого циклу pairing/approval і `shutdown`.
|
||||
|
||||
Запуски агентів складаються з двох етапів:
|
||||
Запуски агентів мають дві стадії:
|
||||
|
||||
1. Негайне підтвердження прийняття (`status:"accepted"`)
|
||||
2. Остаточна відповідь завершення (`status:"ok"|"error"`), із потоковими подіями `agent` між ними.
|
||||
1. Негайне підтвердження accepted (`status:"accepted"`)
|
||||
2. Фінальна відповідь про завершення (`status:"ok"|"error"`), з потоковими подіями `agent` між ними.
|
||||
|
||||
Повну документацію з протоколу див.: [Gateway Protocol](/uk/gateway/protocol).
|
||||
Повна документація з протоколу: [Gateway Protocol](/uk/gateway/protocol).
|
||||
|
||||
## Операційні перевірки
|
||||
|
||||
### Перевірка доступності
|
||||
### Живучість
|
||||
|
||||
- Відкрийте WS і надішліть `connect`.
|
||||
- Очікуйте відповідь `hello-ok` зі знімком.
|
||||
|
||||
### Перевірка готовності
|
||||
### Готовність
|
||||
|
||||
```bash
|
||||
openclaw gateway status
|
||||
@ -343,28 +343,28 @@ openclaw health
|
||||
|
||||
### Відновлення після пропусків
|
||||
|
||||
Події не відтворюються повторно. За пропусків у послідовності оновіть стан (`health`, `system-presence`), перш ніж продовжувати.
|
||||
Події не відтворюються повторно. У разі пропусків послідовності оновіть стан (`health`, `system-presence`), перш ніж продовжувати.
|
||||
|
||||
## Типові сигнатури збоїв
|
||||
|
||||
| Сигнатура | Імовірна проблема |
|
||||
| --------- | ----------------- |
|
||||
| `refusing to bind gateway ... without auth` | Прив’язка не до loopback без дійсного шляху автентифікації gateway |
|
||||
| `another gateway instance is already listening` / `EADDRINUSE` | Конфлікт порту |
|
||||
| `Gateway start blocked: set gateway.mode=local` | У конфігурації встановлено remote mode або в пошкодженій конфігурації відсутній штамп local-mode |
|
||||
| `unauthorized` during connect | Невідповідність автентифікації між клієнтом і gateway |
|
||||
| Сигнатура | Ймовірна проблема |
|
||||
| ------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
|
||||
| `refusing to bind gateway ... without auth` | Прив’язка не до loopback без дійсного шляху автентифікації gateway |
|
||||
| `another gateway instance is already listening` / `EADDRINUSE` | Конфлікт порту |
|
||||
| `Gateway start blocked: set gateway.mode=local` | У конфігурації встановлено remote mode або в пошкодженій конфігурації відсутній штамп local-mode |
|
||||
| `unauthorized` during connect | Невідповідність автентифікації між клієнтом і gateway |
|
||||
|
||||
Щоб отримати повні послідовності діагностики, скористайтеся [Gateway Troubleshooting](/uk/gateway/troubleshooting).
|
||||
Для повних послідовностей діагностики використовуйте [Gateway Troubleshooting](/uk/gateway/troubleshooting).
|
||||
|
||||
## Гарантії безпеки
|
||||
|
||||
- Клієнти протоколу Gateway швидко завершуються з помилкою, коли Gateway недоступний (без неявного fallback на прямий канал).
|
||||
- Некоректні перші кадри або кадри не типу `connect` відхиляються, і з’єднання закривається.
|
||||
- Клієнти протоколу Gateway швидко завершуються з помилкою, коли Gateway недоступний (без неявного fallback на direct-channel).
|
||||
- Неприпустимі перші кадри або кадри не `connect` відхиляються, а з’єднання закривається.
|
||||
- Коректне завершення роботи надсилає подію `shutdown` перед закриттям сокета.
|
||||
|
||||
---
|
||||
|
||||
Пов’язані сторінки:
|
||||
Пов’язане:
|
||||
|
||||
- [Troubleshooting](/uk/gateway/troubleshooting)
|
||||
- [Background Process](/uk/gateway/background-process)
|
||||
|
||||
@ -1,26 +1,26 @@
|
||||
---
|
||||
read_when:
|
||||
- Центр усунення неполадок направив вас сюди для глибшої діагностики
|
||||
- Вам потрібні стабільні розділи посібника з діагностики за симптомами з точними командами
|
||||
summary: Детальний посібник з усунення неполадок для gateway, каналів, автоматизації, вузлів і браузера
|
||||
title: Усунення неполадок
|
||||
- Центр усунення несправностей направив вас сюди для глибшої діагностики
|
||||
- Вам потрібні стабільні розділи посібника на основі симптомів із точними командами
|
||||
summary: Детальний посібник з усунення несправностей для Gateway, каналів, автоматизації, Node і браузера
|
||||
title: Усунення несправностей
|
||||
x-i18n:
|
||||
generated_at: "2026-04-10T20:41:23Z"
|
||||
generated_at: "2026-04-20T06:31:09Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 7ef2faccba26ede307861504043a6415bc1f12dc64407771106f63ddc5b107f5
|
||||
source_hash: 853275aaf4ebddb9d2fd358df2e9fdc893dafdc7960d69c4f145ce615d5cbc1e
|
||||
source_path: gateway/troubleshooting.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Усунення неполадок gateway
|
||||
# Усунення несправностей Gateway
|
||||
|
||||
Ця сторінка є детальним посібником.
|
||||
Почніть із [/help/troubleshooting](/uk/help/troubleshooting), якщо спочатку хочете пройти швидкий потік первинної діагностики.
|
||||
Ця сторінка — детальний посібник.
|
||||
Почніть із [/help/troubleshooting](/uk/help/troubleshooting), якщо спочатку хочете швидкий сценарій первинної діагностики.
|
||||
|
||||
## Послідовність команд
|
||||
## Командна послідовність
|
||||
|
||||
Спочатку виконайте ці команди в такому порядку:
|
||||
Спочатку виконайте ці команди саме в такому порядку:
|
||||
|
||||
```bash
|
||||
openclaw status
|
||||
@ -30,16 +30,16 @@ openclaw doctor
|
||||
openclaw channels status --probe
|
||||
```
|
||||
|
||||
Очікувані ознаки справного стану:
|
||||
Очікувані ознаки нормального стану:
|
||||
|
||||
- `openclaw gateway status` показує `Runtime: running` і `RPC probe: ok`.
|
||||
- `openclaw doctor` не повідомляє про блокувальні проблеми конфігурації/служб.
|
||||
- `openclaw channels status --probe` показує живий стан транспорту для кожного облікового запису та,
|
||||
де це підтримується, результати probe/audit, як-от `works` або `audit ok`.
|
||||
- `openclaw gateway status` показує `Runtime: running`, `Connectivity probe: ok` і рядок `Capability: ...`.
|
||||
- `openclaw doctor` не повідомляє про блокувальні проблеми конфігурації/сервісів.
|
||||
- `openclaw channels status --probe` показує живий статус транспорту для кожного облікового запису і,
|
||||
де це підтримується, результати probe/audit на кшталт `works` або `audit ok`.
|
||||
|
||||
## Anthropic 429: для довгого контексту потрібне додаткове використання
|
||||
|
||||
Використовуйте це, коли логи/помилки містять:
|
||||
Використовуйте це, коли журнали/помилки містять:
|
||||
`HTTP 429: rate_limit_error: Extra usage is required for long context requests`.
|
||||
|
||||
```bash
|
||||
@ -52,13 +52,13 @@ openclaw config get agents.defaults.models
|
||||
|
||||
- Вибрана модель Anthropic Opus/Sonnet має `params.context1m: true`.
|
||||
- Поточні облікові дані Anthropic не мають права на використання довгого контексту.
|
||||
- Запити збійно завершуються лише для довгих сесій/запусків моделі, яким потрібен beta-шлях 1M.
|
||||
- Запити падають лише в довгих сесіях/запусках моделі, яким потрібен шлях 1M beta.
|
||||
|
||||
Варіанти виправлення:
|
||||
|
||||
1. Вимкніть `context1m` для цієї моделі, щоб повернутися до звичайного вікна контексту.
|
||||
2. Використайте облікові дані Anthropic, які мають право на запити з довгим контекстом, або перейдіть на ключ Anthropic API.
|
||||
3. Налаштуйте резервні моделі, щоб виконання продовжувалося, коли запити Anthropic з довгим контекстом відхиляються.
|
||||
3. Налаштуйте резервні моделі, щоб запуски продовжувалися, коли запити Anthropic із довгим контекстом відхиляються.
|
||||
|
||||
Пов’язане:
|
||||
|
||||
@ -66,13 +66,13 @@ openclaw config get agents.defaults.models
|
||||
- [/reference/token-use](/uk/reference/token-use)
|
||||
- [/help/faq#why-am-i-seeing-http-429-ratelimiterror-from-anthropic](/uk/help/faq#why-am-i-seeing-http-429-ratelimiterror-from-anthropic)
|
||||
|
||||
## Локальний OpenAI-compatible backend проходить прямі probe, але збоять запуски агента
|
||||
## Локальний OpenAI-сумісний бекенд проходить прямі probe, але запуски агента не працюють
|
||||
|
||||
Використовуйте це, коли:
|
||||
|
||||
- `curl ... /v1/models` працює
|
||||
- малі прямі виклики `/v1/chat/completions` працюють
|
||||
- запуски моделі OpenClaw збоять лише під час звичайних ходів агента
|
||||
- запуски моделей OpenClaw падають лише на звичайних ходах агента
|
||||
|
||||
```bash
|
||||
curl http://127.0.0.1:1234/v1/models
|
||||
@ -85,34 +85,34 @@ openclaw logs --follow
|
||||
|
||||
Зверніть увагу на таке:
|
||||
|
||||
- прямі малі виклики успішні, але запуски OpenClaw збоять лише на більших prompt
|
||||
- помилки backend про те, що `messages[].content` очікує рядок
|
||||
- збої backend, які з’являються лише при більшій кількості токенів у prompt або в повних
|
||||
prompt середовища виконання агента
|
||||
- прямі малі виклики успішні, але запуски OpenClaw падають лише на більших prompt
|
||||
- помилки бекенда про те, що `messages[].content` очікує рядок
|
||||
- збої бекенда, які виникають лише за більшої кількості prompt-token або з повними
|
||||
prompt середовища агента
|
||||
|
||||
Поширені ознаки:
|
||||
|
||||
- `messages[...].content: invalid type: sequence, expected a string` → backend
|
||||
відхиляє структуровані частини вмісту Chat Completions. Виправлення: встановіть
|
||||
- `messages[...].content: invalid type: sequence, expected a string` → бекенд
|
||||
відхиляє структуровані частини content у Chat Completions. Виправлення: встановіть
|
||||
`models.providers.<provider>.models[].compat.requiresStringContent: true`.
|
||||
- прямі малі запити успішні, але ходи агента OpenClaw збоять через збої backend/моделі
|
||||
(наприклад, Gemma у деяких збірках `inferrs`) → транспорт OpenClaw
|
||||
імовірно вже налаштований правильно; проблема в тому, що backend не справляється з більшою формою
|
||||
prompt середовища виконання агента.
|
||||
- після вимкнення tools збоїв стає менше, але вони не зникають → схеми tools були
|
||||
частиною навантаження, але решта проблеми все ще пов’язана з upstream місткістю моделі/сервера
|
||||
або помилкою backend.
|
||||
- прямі малі запити успішні, але запуски агента OpenClaw падають через збої бекенда/моделі
|
||||
(наприклад Gemma у деяких збірках `inferrs`) → транспорт OpenClaw,
|
||||
найімовірніше, уже налаштований правильно; бекенд падає через форму більших
|
||||
prompt середовища агента.
|
||||
- збої зменшуються після вимкнення інструментів, але не зникають → схеми інструментів
|
||||
були частиною навантаження, але решта проблеми все одно пов’язана з обмеженням
|
||||
моделі/сервера вище за рівнем або з багом бекенда.
|
||||
|
||||
Варіанти виправлення:
|
||||
|
||||
1. Встановіть `compat.requiresStringContent: true` для backend Chat Completions, які підтримують лише рядковий вміст.
|
||||
2. Встановіть `compat.supportsTools: false` для моделей/backend, які не можуть
|
||||
надійно обробляти поверхню схем tools OpenClaw.
|
||||
3. За можливості зменште навантаження prompt: менший bootstrap workspace, коротша
|
||||
історія сесії, легша локальна модель або backend із кращою підтримкою довгого контексту.
|
||||
4. Якщо прямі малі запити й далі проходять, а ходи агента OpenClaw усе ще збоять
|
||||
всередині backend, розглядайте це як обмеження upstream сервера/моделі й створіть
|
||||
там repro з формою payload, яка приймається.
|
||||
1. Встановіть `compat.requiresStringContent: true` для бекендів Chat Completions, які підтримують лише рядки.
|
||||
2. Встановіть `compat.supportsTools: false` для моделей/бекендів, які не можуть
|
||||
надійно обробляти поверхню схем інструментів OpenClaw.
|
||||
3. За можливості зменште навантаження prompt: менший bootstrap робочого простору, коротша
|
||||
історія сесії, легша локальна модель або бекенд із кращою підтримкою довгого контексту.
|
||||
4. Якщо малі прямі запити й далі проходять, а ходи агента OpenClaw все ще спричиняють збій
|
||||
усередині бекенда, розглядайте це як обмеження сервера/моделі вище за рівнем і створіть
|
||||
там repro із прийнятою формою payload.
|
||||
|
||||
Пов’язане:
|
||||
|
||||
@ -122,7 +122,7 @@ openclaw logs --follow
|
||||
|
||||
## Немає відповідей
|
||||
|
||||
Якщо канали працюють, але ніхто не відповідає, перевірте маршрутизацію та політики перед тим, як щось перепідключати.
|
||||
Якщо канали працюють, але нічого не відповідає, перевірте маршрутизацію та політики, перш ніж щось перепідключати.
|
||||
|
||||
```bash
|
||||
openclaw status
|
||||
@ -134,15 +134,15 @@ openclaw logs --follow
|
||||
|
||||
Зверніть увагу на таке:
|
||||
|
||||
- Pairing очікує на розгляд для відправників у DM.
|
||||
- Обмеження згадок у групах (`requireMention`, `mentionPatterns`).
|
||||
- Pairing у стані очікування для відправників у DM.
|
||||
- Обмеження згадками в групах (`requireMention`, `mentionPatterns`).
|
||||
- Невідповідності allowlist каналу/групи.
|
||||
|
||||
Поширені ознаки:
|
||||
|
||||
- `drop guild message (mention required` → повідомлення групи ігнорується, доки немає згадки.
|
||||
- `pairing request` → відправнику потрібне схвалення.
|
||||
- `blocked` / `allowlist` → відправника/канал відфільтровано політикою.
|
||||
- `drop guild message (mention required` → повідомлення в групі ігнорується, доки не буде згадки.
|
||||
- `pairing request` → відправник потребує схвалення.
|
||||
- `blocked` / `allowlist` → відправника/канал було відфільтровано політикою.
|
||||
|
||||
Пов’язане:
|
||||
|
||||
@ -152,7 +152,7 @@ openclaw logs --follow
|
||||
|
||||
## Підключення dashboard/control UI
|
||||
|
||||
Коли dashboard/control UI не може підключитися, перевірте URL, режим auth і припущення про безпечний контекст.
|
||||
Коли dashboard/control UI не підключається, перевірте URL, режим автентифікації та припущення щодо безпечного контексту.
|
||||
|
||||
```bash
|
||||
openclaw gateway status
|
||||
@ -165,47 +165,47 @@ openclaw gateway status --json
|
||||
Зверніть увагу на таке:
|
||||
|
||||
- Правильний URL probe і URL dashboard.
|
||||
- Невідповідність режиму auth/токена між клієнтом і gateway.
|
||||
- Невідповідність режиму автентифікації/токена між клієнтом і Gateway.
|
||||
- Використання HTTP там, де потрібна ідентичність пристрою.
|
||||
|
||||
Поширені ознаки:
|
||||
|
||||
- `device identity required` → небезпечний контекст або відсутня auth пристрою.
|
||||
- `device identity required` → небезпечний контекст або відсутня автентифікація пристрою.
|
||||
- `origin not allowed` → `Origin` браузера відсутній у `gateway.controlUi.allowedOrigins`
|
||||
(або ви підключаєтеся з browser origin не на loopback без явного
|
||||
(або ви підключаєтеся з браузерного origin не на loopback без явного
|
||||
allowlist).
|
||||
- `device nonce required` / `device nonce mismatch` → клієнт не завершує
|
||||
flow auth пристрою на основі challenge (`connect.challenge` + `device.nonce`).
|
||||
challenge-базований потік автентифікації пристрою (`connect.challenge` + `device.nonce`).
|
||||
- `device signature invalid` / `device signature expired` → клієнт підписав неправильний
|
||||
payload (або використав застарілу часову мітку) для поточного handshake.
|
||||
- `AUTH_TOKEN_MISMATCH` з `canRetryWithDeviceToken=true` → клієнт може виконати одну довірену повторну спробу з кешованим токеном пристрою.
|
||||
- Ця повторна спроба з кешованим токеном повторно використовує кешований набір scope, збережений разом із paired
|
||||
токеном пристрою. Виклики з явними `deviceToken` / явними `scopes` зберігають
|
||||
запитаний ними набір scope.
|
||||
- Поза цим шляхом повторної спроби пріоритет auth для connect такий:
|
||||
спочатку явний shared token/password, потім явний `deviceToken`, потім збережений токен пристрою,
|
||||
- Ця повторна спроба з кешованим токеном повторно використовує кешований набір scope, збережений разом
|
||||
зі спареним токеном пристрою. Виклики з явним `deviceToken` / явними `scopes` зберігають
|
||||
свій запитаний набір scope.
|
||||
- Поза цим шляхом повторної спроби пріоритет автентифікації під час підключення такий: спочатку явний спільний
|
||||
token/password, потім явний `deviceToken`, потім збережений токен пристрою,
|
||||
потім bootstrap token.
|
||||
- На асинхронному шляху Tailscale Serve Control UI невдалі спроби для того самого
|
||||
`{scope, ip}` серіалізуються до того, як limiter зафіксує збій. Тому дві хибні
|
||||
- В асинхронному шляху Tailscale Serve Control UI невдалі спроби для того самого
|
||||
`{scope, ip}` серіалізуються до того, як лімітатор зафіксує невдачу. Тому дві невдалі
|
||||
одночасні повторні спроби від того самого клієнта можуть призвести до `retry later`
|
||||
для другої спроби замість двох звичайних невідповідностей.
|
||||
у другій спробі замість двох звичайних невідповідностей.
|
||||
- `too many failed authentication attempts (retry later)` від loopback-клієнта з browser-origin
|
||||
→ повторні збої з того самого нормалізованого `Origin` тимчасово блокуються; інший localhost origin використовує окремий bucket.
|
||||
- повторюване `unauthorized` після цієї повторної спроби → розсинхронізація shared token/device token; оновіть конфігурацію токена та за потреби повторно схваліть/перегенеруйте токен пристрою.
|
||||
- `gateway connect failed:` → неправильний host/port/url призначення.
|
||||
- повторні `unauthorized` після цієї повторної спроби → розсинхронізація shared token/device token; оновіть конфігурацію токена та за потреби повторно схваліть/перевипустіть токен пристрою.
|
||||
- `gateway connect failed:` → неправильна ціль host/port/url.
|
||||
|
||||
### Швидка таблиця кодів деталей auth
|
||||
### Коротка карта кодів деталей автентифікації
|
||||
|
||||
Використовуйте `error.details.code` з невдалої відповіді `connect`, щоб вибрати наступну дію:
|
||||
Використовуйте `error.details.code` з невдалого response `connect`, щоб вибрати наступну дію:
|
||||
|
||||
| Код деталей | Значення | Рекомендована дія |
|
||||
| ---------------------------- | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `AUTH_TOKEN_MISSING` | Клієнт не надіслав обов’язковий shared token. | Вставте/задайте токен у клієнті та повторіть спробу. Для шляхів dashboard: `openclaw config get gateway.auth.token`, а потім вставте його в налаштуваннях Control UI. |
|
||||
| `AUTH_TOKEN_MISMATCH` | Shared token не збігся з токеном auth gateway. | Якщо `canRetryWithDeviceToken=true`, дозвольте одну довірену повторну спробу. Повторні спроби з кешованим токеном повторно використовують збережені схвалені scope; виклики з явними `deviceToken` / `scopes` зберігають запитані scope. Якщо й далі не вдається, виконайте [контрольний список відновлення після розсинхронізації токена](/cli/devices#token-drift-recovery-checklist). |
|
||||
| `AUTH_DEVICE_TOKEN_MISMATCH` | Кешований токен для конкретного пристрою застарів або відкликаний. | Перегенеруйте/повторно схваліть токен пристрою через [CLI devices](/cli/devices), а потім перепідключіться. |
|
||||
| `PAIRING_REQUIRED` | Ідентичність пристрою відома, але не схвалена для цієї ролі. | Схваліть запит, що очікує: `openclaw devices list`, потім `openclaw devices approve <requestId>`. |
|
||||
| `AUTH_TOKEN_MISSING` | Клієнт не надіслав обов’язковий спільний token. | Вставте/встановіть token у клієнті та повторіть спробу. Для шляхів dashboard: `openclaw config get gateway.auth.token`, потім вставте його в налаштуваннях Control UI. |
|
||||
| `AUTH_TOKEN_MISMATCH` | Спільний token не збігся з токеном автентифікації gateway. | Якщо `canRetryWithDeviceToken=true`, дозвольте одну довірену повторну спробу. Повторні спроби з кешованим токеном повторно використовують збережені схвалені scope; виклики з явним `deviceToken` / `scopes` зберігають запитаний набір scope. Якщо все одно не працює, виконайте [контрольний список відновлення після drift токенів](/cli/devices#token-drift-recovery-checklist). |
|
||||
| `AUTH_DEVICE_TOKEN_MISMATCH` | Кешований токен для конкретного пристрою застарів або відкликаний. | Перевипустіть/повторно схваліть токен пристрою через [CLI devices](/cli/devices), потім перепідключіться. |
|
||||
| `PAIRING_REQUIRED` | Ідентичність пристрою відома, але не схвалена для цієї ролі. | Схваліть запит, що очікує: `openclaw devices list`, потім `openclaw devices approve <requestId>`. |
|
||||
|
||||
Перевірка міграції auth пристрою v2:
|
||||
Перевірка міграції device auth v2:
|
||||
|
||||
```bash
|
||||
openclaw --version
|
||||
@ -213,53 +213,53 @@ openclaw doctor
|
||||
openclaw gateway status
|
||||
```
|
||||
|
||||
Якщо логи показують помилки nonce/signature, оновіть клієнт, що підключається, і перевірте, що він:
|
||||
Якщо журнали показують помилки nonce/signature, оновіть клієнт, що підключається, і перевірте, що він:
|
||||
|
||||
1. чекає на `connect.challenge`
|
||||
2. підписує payload, прив’язаний до challenge
|
||||
3. надсилає `connect.params.device.nonce` з тим самим nonce challenge
|
||||
3. надсилає `connect.params.device.nonce` з тим самим challenge nonce
|
||||
|
||||
Якщо `openclaw devices rotate` / `revoke` / `remove` неочікувано заборонено:
|
||||
Якщо `openclaw devices rotate` / `revoke` / `remove` неочікувано відхиляється:
|
||||
|
||||
- сесії з токеном paired-device можуть керувати лише **власним** пристроєм, якщо
|
||||
- сесії з paired-device token можуть керувати лише **своїм власним** пристроєм, якщо
|
||||
виклик також не має `operator.admin`
|
||||
- `openclaw devices rotate --scope ...` може запитувати лише ті operator scope,
|
||||
які вже має сесія виклику
|
||||
які сесія виклику вже має
|
||||
|
||||
Пов’язане:
|
||||
|
||||
- [/web/control-ui](/web/control-ui)
|
||||
- [/gateway/configuration](/uk/gateway/configuration) (режими auth gateway)
|
||||
- [/gateway/configuration](/uk/gateway/configuration) (режими автентифікації gateway)
|
||||
- [/gateway/trusted-proxy-auth](/uk/gateway/trusted-proxy-auth)
|
||||
- [/gateway/remote](/uk/gateway/remote)
|
||||
- [/cli/devices](/cli/devices)
|
||||
|
||||
## Служба gateway не працює
|
||||
## Сервіс Gateway не запущений
|
||||
|
||||
Використовуйте це, коли службу встановлено, але процес не залишається активним.
|
||||
Використовуйте це, коли сервіс установлено, але процес не залишається запущеним.
|
||||
|
||||
```bash
|
||||
openclaw gateway status
|
||||
openclaw status
|
||||
openclaw logs --follow
|
||||
openclaw doctor
|
||||
openclaw gateway status --deep # також сканує служби на рівні системи
|
||||
openclaw gateway status --deep # also scan system-level services
|
||||
```
|
||||
|
||||
Зверніть увагу на таке:
|
||||
|
||||
- `Runtime: stopped` з підказками щодо виходу.
|
||||
- Невідповідність конфігурації служби (`Config (cli)` vs `Config (service)`).
|
||||
- Конфлікти портів/слухачів.
|
||||
- `Runtime: stopped` із підказками щодо завершення.
|
||||
- Невідповідність конфігурації сервісу (`Config (cli)` проти `Config (service)`).
|
||||
- Конфлікти порту/слухача.
|
||||
- Додаткові встановлення launchd/systemd/schtasks при використанні `--deep`.
|
||||
- Підказки для очищення `Other gateway-like services detected (best effort)`.
|
||||
- Підказки очищення `Other gateway-like services detected (best effort)`.
|
||||
|
||||
Поширені ознаки:
|
||||
|
||||
- `Gateway start blocked: set gateway.mode=local` або `existing config is missing gateway.mode` → локальний режим gateway не ввімкнено, або файл конфігурації було пошкоджено й у ньому втрачено `gateway.mode`. Виправлення: задайте `gateway.mode="local"` у своїй конфігурації або повторно запустіть `openclaw onboard --mode local` / `openclaw setup`, щоб знову проставити очікувану конфігурацію локального режиму. Якщо ви запускаєте OpenClaw через Podman, стандартний шлях до конфігурації — `~/.openclaw/openclaw.json`.
|
||||
- `refusing to bind gateway ... without auth` → прив’язка не до loopback без коректного шляху auth gateway (token/password або trusted-proxy, якщо налаштовано).
|
||||
- `Gateway start blocked: set gateway.mode=local` або `existing config is missing gateway.mode` → локальний режим gateway не увімкнено, або файл конфігурації було пошкоджено, і він втратив `gateway.mode`. Виправлення: встановіть `gateway.mode="local"` у своїй конфігурації або повторно виконайте `openclaw onboard --mode local` / `openclaw setup`, щоб знову записати очікувану конфігурацію локального режиму. Якщо ви запускаєте OpenClaw через Podman, типовий шлях до конфігурації — `~/.openclaw/openclaw.json`.
|
||||
- `refusing to bind gateway ... without auth` → прив’язка не до loopback без дійсного шляху автентифікації gateway (token/password або trusted-proxy, де це налаштовано).
|
||||
- `another gateway instance is already listening` / `EADDRINUSE` → конфлікт порту.
|
||||
- `Other gateway-like services detected (best effort)` → існують застарілі або паралельні модулі launchd/systemd/schtasks. У більшості конфігурацій має бути один gateway на машину; якщо вам справді потрібно більше одного, ізолюйте порти + конфігурацію/стан/workspace. Див. [/gateway#multiple-gateways-same-host](/uk/gateway#multiple-gateways-same-host).
|
||||
- `Other gateway-like services detected (best effort)` → існують застарілі або паралельні launchd/systemd/schtasks units. У більшості сценаріїв варто тримати один gateway на машину; якщо вам справді потрібно більше одного, ізолюйте порти + конфігурацію/стан/робочий простір. Див. [/gateway#multiple-gateways-same-host](/uk/gateway#multiple-gateways-same-host).
|
||||
|
||||
Пов’язане:
|
||||
|
||||
@ -267,7 +267,7 @@ openclaw gateway status --deep # також сканує служби на р
|
||||
- [/gateway/configuration](/uk/gateway/configuration)
|
||||
- [/gateway/doctor](/uk/gateway/doctor)
|
||||
|
||||
## Попередження gateway probe
|
||||
## Попередження probe Gateway
|
||||
|
||||
Використовуйте це, коли `openclaw gateway probe` до чогось дістається, але все одно виводить блок попереджень.
|
||||
|
||||
@ -280,14 +280,15 @@ openclaw gateway probe --ssh user@gateway-host
|
||||
Зверніть увагу на таке:
|
||||
|
||||
- `warnings[].code` і `primaryTargetId` у JSON-виводі.
|
||||
- Чи пов’язане попередження з резервним переходом через SSH, кількома gateway, відсутніми scope або нерозв’язаними auth refs.
|
||||
- Чи пов’язане попередження з резервним переходом через SSH, кількома gateway, відсутніми scope або нерозв’язаними auth ref.
|
||||
|
||||
Поширені ознаки:
|
||||
|
||||
- `SSH tunnel failed to start; falling back to direct probes.` → налаштування SSH не вдалося, але команда все одно спробувала прямі налаштовані/loopback-цілі.
|
||||
- `multiple reachable gateways detected` → відповіла більше ніж одна ціль. Зазвичай це означає навмисну конфігурацію з кількома gateway або застарілі/дубльовані listeners.
|
||||
- `Probe diagnostics are limited by gateway scopes (missing operator.read)` → підключення спрацювало, але детальний RPC обмежений scope; виконайте pairing ідентичності пристрою або використайте облікові дані з `operator.read`.
|
||||
- нерозв’язаний текст попередження `gateway.auth.*` / `gateway.remote.*` SecretRef → auth-матеріал був недоступний у цьому шляху команди для цілі, що не пройшла перевірку.
|
||||
- `multiple reachable gateways detected` → відповіло більше однієї цілі. Зазвичай це означає навмисну конфігурацію з кількома gateway або застарілі/дубльовані listener.
|
||||
- `Read-probe diagnostics are limited by gateway scopes (missing operator.read)` → підключення спрацювало, але деталізований RPC обмежений scope; спарте ідентичність пристрою або використайте облікові дані з `operator.read`.
|
||||
- `Capability: pairing-pending` або `gateway closed (1008): pairing required` → gateway відповів, але цьому клієнту все ще потрібне pairing/схвалення перед звичайним доступом operator.
|
||||
- нерозв’язаний текст попередження `gateway.auth.*` / `gateway.remote.*` SecretRef → auth-матеріал був недоступний у цьому шляху команди для цілі, що не вдалася.
|
||||
|
||||
Пов’язане:
|
||||
|
||||
@ -297,7 +298,7 @@ openclaw gateway probe --ssh user@gateway-host
|
||||
|
||||
## Канал підключено, але повідомлення не проходять
|
||||
|
||||
Якщо стан каналу — connected, але потік повідомлень не працює, зосередьтеся на політиках, дозволах і правилах доставки, специфічних для каналу.
|
||||
Якщо стан каналу — connected, але потік повідомлень не працює, зосередьтеся на політиці, дозволах і правилах доставки, специфічних для каналу.
|
||||
|
||||
```bash
|
||||
openclaw channels status --probe
|
||||
@ -315,7 +316,7 @@ openclaw config get channels
|
||||
|
||||
Поширені ознаки:
|
||||
|
||||
- `mention required` → повідомлення ігнорується через політику згадок у групі.
|
||||
- `mention required` → повідомлення ігнорується політикою згадок у групі.
|
||||
- `pairing` / сліди очікування схвалення → відправника не схвалено.
|
||||
- `missing_scope`, `not_in_channel`, `Forbidden`, `401/403` → проблема з auth/дозволами каналу.
|
||||
|
||||
@ -326,9 +327,9 @@ openclaw config get channels
|
||||
- [/channels/telegram](/uk/channels/telegram)
|
||||
- [/channels/discord](/uk/channels/discord)
|
||||
|
||||
## Доставка cron і heartbeat
|
||||
## Доставка Cron і Heartbeat
|
||||
|
||||
Якщо cron або heartbeat не запустився чи не доставився, спочатку перевірте стан scheduler, а вже потім ціль доставки.
|
||||
Якщо Cron або Heartbeat не запустився чи не доставився, спочатку перевірте стан планувальника, а потім ціль доставки.
|
||||
|
||||
```bash
|
||||
openclaw cron status
|
||||
@ -340,19 +341,19 @@ openclaw logs --follow
|
||||
|
||||
Зверніть увагу на таке:
|
||||
|
||||
- Cron увімкнений і присутній час наступного пробудження.
|
||||
- Стан історії запусків job (`ok`, `skipped`, `error`).
|
||||
- Причини пропуску heartbeat (`quiet-hours`, `requests-in-flight`, `alerts-disabled`, `empty-heartbeat-file`, `no-tasks-due`).
|
||||
- Cron увімкнено і наявний наступний запуск.
|
||||
- Статус історії запусків завдання (`ok`, `skipped`, `error`).
|
||||
- Причини пропуску Heartbeat (`quiet-hours`, `requests-in-flight`, `alerts-disabled`, `empty-heartbeat-file`, `no-tasks-due`).
|
||||
|
||||
Поширені ознаки:
|
||||
|
||||
- `cron: scheduler disabled; jobs will not run automatically` → cron вимкнено.
|
||||
- `cron: timer tick failed` → збій tick scheduler; перевірте помилки файлів/логів/runtime.
|
||||
- `heartbeat skipped` з `reason=quiet-hours` → поза межами вікна активних годин.
|
||||
- `heartbeat skipped` з `reason=empty-heartbeat-file` → `HEARTBEAT.md` існує, але містить лише порожні рядки / markdown-заголовки, тому OpenClaw пропускає виклик моделі.
|
||||
- `heartbeat skipped` з `reason=no-tasks-due` → `HEARTBEAT.md` містить блок `tasks:`, але на цьому tick жодне із завдань не підлягає виконанню.
|
||||
- `heartbeat: unknown accountId` → недійсний account id для цілі доставки heartbeat.
|
||||
- `heartbeat skipped` з `reason=dm-blocked` → ціль heartbeat була визначена як призначення у стилі DM, тоді як `agents.defaults.heartbeat.directPolicy` (або перевизначення для конкретного агента) має значення `block`.
|
||||
- `cron: scheduler disabled; jobs will not run automatically` → Cron вимкнено.
|
||||
- `cron: timer tick failed` → помилка тіку планувальника; перевірте помилки файлів/журналів/середовища виконання.
|
||||
- `heartbeat skipped` з `reason=quiet-hours` → поза вікном активних годин.
|
||||
- `heartbeat skipped` з `reason=empty-heartbeat-file` → `HEARTBEAT.md` існує, але містить лише порожні рядки / заголовки markdown, тому OpenClaw пропускає виклик моделі.
|
||||
- `heartbeat skipped` з `reason=no-tasks-due` → `HEARTBEAT.md` містить блок `tasks:`, але жодне із завдань не має виконуватися на цьому тікові.
|
||||
- `heartbeat: unknown accountId` → недійсний id облікового запису для цілі доставки Heartbeat.
|
||||
- `heartbeat skipped` з `reason=dm-blocked` → ціль Heartbeat було зіставлено з призначенням у стилі DM, тоді як `agents.defaults.heartbeat.directPolicy` (або перевизначення для конкретного агента) встановлено в `block`.
|
||||
|
||||
Пов’язане:
|
||||
|
||||
@ -360,9 +361,9 @@ openclaw logs --follow
|
||||
- [/automation/cron-jobs](/uk/automation/cron-jobs)
|
||||
- [/gateway/heartbeat](/uk/gateway/heartbeat)
|
||||
|
||||
## Збій paired tool вузла
|
||||
## Збій інструмента спареного Node
|
||||
|
||||
Якщо вузол paired, але tools не працюють, ізолюйте стан foreground, дозволи та схвалення.
|
||||
Якщо Node спарений, але інструменти не працюють, ізолюйте стан foreground, дозволи та схвалення.
|
||||
|
||||
```bash
|
||||
openclaw nodes status
|
||||
@ -374,15 +375,15 @@ openclaw status
|
||||
|
||||
Зверніть увагу на таке:
|
||||
|
||||
- Вузол online з очікуваними capability.
|
||||
- Надані дозволи ОС для camera/mic/location/screen.
|
||||
- Стан exec approvals і allowlist.
|
||||
- Node онлайн з очікуваними можливостями.
|
||||
- Надані дозволи ОС на камеру/мікрофон/геолокацію/екран.
|
||||
- Стан схвалень exec і allowlist.
|
||||
|
||||
Поширені ознаки:
|
||||
|
||||
- `NODE_BACKGROUND_UNAVAILABLE` → застосунок вузла має бути у foreground.
|
||||
- `NODE_BACKGROUND_UNAVAILABLE` → застосунок Node має бути на передньому плані.
|
||||
- `*_PERMISSION_REQUIRED` / `LOCATION_PERMISSION_REQUIRED` → відсутній дозвіл ОС.
|
||||
- `SYSTEM_RUN_DENIED: approval required` → схвалення exec очікує.
|
||||
- `SYSTEM_RUN_DENIED: approval required` → очікує схвалення exec.
|
||||
- `SYSTEM_RUN_DENIED: allowlist miss` → команду заблоковано через allowlist.
|
||||
|
||||
Пов’язане:
|
||||
@ -393,7 +394,7 @@ openclaw status
|
||||
|
||||
## Збій browser tool
|
||||
|
||||
Використовуйте це, коли дії browser tool завершуються з помилкою, хоча сам gateway справний.
|
||||
Використовуйте це, коли дії browser tool не працюють, хоча сам Gateway справний.
|
||||
|
||||
```bash
|
||||
openclaw browser status
|
||||
@ -405,30 +406,30 @@ openclaw doctor
|
||||
|
||||
Зверніть увагу на таке:
|
||||
|
||||
- Чи задано `plugins.allow` і чи включає воно `browser`.
|
||||
- Чи встановлено `plugins.allow` і чи містить він `browser`.
|
||||
- Коректний шлях до виконуваного файла браузера.
|
||||
- Досяжність профілю CDP.
|
||||
- Наявність локального Chrome для профілів `existing-session` / `user`.
|
||||
- Доступність локального Chrome для профілів `existing-session` / `user`.
|
||||
|
||||
Поширені ознаки:
|
||||
|
||||
- `unknown command "browser"` або `unknown command 'browser'` → bundled browser plugin виключено через `plugins.allow`.
|
||||
- browser tool відсутній / недоступний, хоча `browser.enabled=true` → `plugins.allow` виключає `browser`, тому plugin ніколи не завантажувався.
|
||||
- `Failed to start Chrome CDP on port` → процес браузера не вдалося запустити.
|
||||
- `unknown command "browser"` або `unknown command 'browser'` → вбудований browser Plugin виключено через `plugins.allow`.
|
||||
- browser tool відсутній / недоступний, хоча `browser.enabled=true` → `plugins.allow` виключає `browser`, тому Plugin ніколи не завантажувався.
|
||||
- `Failed to start Chrome CDP on port` → процес браузера не зміг запуститися.
|
||||
- `browser.executablePath not found` → налаштований шлях недійсний.
|
||||
- `browser.cdpUrl must be http(s) or ws(s)` → налаштований URL CDP використовує непідтримувану схему, наприклад `file:` або `ftp:`.
|
||||
- `browser.cdpUrl has invalid port` → налаштований URL CDP має некоректний або неприпустимий порт.
|
||||
- `No Chrome tabs found for profile="user"` → у профілі приєднання Chrome MCP немає відкритих локальних вкладок Chrome.
|
||||
- `Remote CDP for profile "<name>" is not reachable` → налаштована віддалена кінцева точка CDP недосяжна з хоста gateway.
|
||||
- `Browser attachOnly is enabled ... not reachable` або `Browser attachOnly is enabled and CDP websocket ... is not reachable` → профіль лише для приєднання не має досяжної цілі, або HTTP endpoint відповів, але CDP WebSocket усе одно не вдалося відкрити.
|
||||
- `Playwright is not available in this gateway build; '<feature>' is unsupported.` → у поточному встановленні gateway відсутній повний пакет Playwright; знімки ARIA і базові знімки сторінки все ще можуть працювати, але навігація, AI snapshots, знімки елементів за CSS-селекторами та експорт PDF залишаються недоступними.
|
||||
- `fullPage is not supported for element screenshots` → запит screenshot поєднав `--full-page` з `--ref` або `--element`.
|
||||
- `element screenshots are not supported for existing-session profiles; use ref from snapshot.` → виклики screenshot для Chrome MCP / `existing-session` мають використовувати захоплення сторінки або snapshot `--ref`, а не CSS `--element`.
|
||||
- `existing-session file uploads do not support element selectors; use ref/inputRef.` → hooks завантаження файлів у Chrome MCP потребують snapshot refs, а не CSS-селекторів.
|
||||
- `existing-session file uploads currently support one file at a time.` → для профілів Chrome MCP надсилайте одне завантаження за виклик.
|
||||
- `existing-session dialog handling does not support timeoutMs.` → hooks діалогів у профілях Chrome MCP не підтримують перевизначення timeout.
|
||||
- `response body is not supported for existing-session profiles yet.` → `responsebody` поки що потребує керованого браузера або сирого профілю CDP.
|
||||
- застарілі перевизначення viewport / dark-mode / locale / offline для профілів лише для приєднання або віддалених CDP-профілів → виконайте `openclaw browser stop --browser-profile <name>`, щоб закрити активну сесію керування та скинути стан емуляції Playwright/CDP без перезапуску всього gateway.
|
||||
- `browser.cdpUrl must be http(s) or ws(s)` → налаштований URL CDP використовує непідтримувану схему, таку як `file:` або `ftp:`.
|
||||
- `browser.cdpUrl has invalid port` → налаштований URL CDP має неправильний або недопустимий порт.
|
||||
- `No Chrome tabs found for profile="user"` → профіль підключення Chrome MCP не має відкритих локальних вкладок Chrome.
|
||||
- `Remote CDP for profile "<name>" is not reachable` → налаштований віддалений endpoint CDP недосяжний із хоста Gateway.
|
||||
- `Browser attachOnly is enabled ... not reachable` або `Browser attachOnly is enabled and CDP websocket ... is not reachable` → профіль лише-підключення не має досяжної цілі, або HTTP endpoint відповів, але CDP WebSocket все одно не вдалося відкрити.
|
||||
- `Playwright is not available in this gateway build; '<feature>' is unsupported.` → у поточному встановленні gateway відсутній повний пакет Playwright; ARIA snapshots і базові знімки сторінок ще можуть працювати, але навігація, AI snapshots, знімки елементів за CSS-selector і експорт PDF залишаються недоступними.
|
||||
- `fullPage is not supported for element screenshots` → запит на знімок екрана поєднав `--full-page` з `--ref` або `--element`.
|
||||
- `element screenshots are not supported for existing-session profiles; use ref from snapshot.` → виклики знімків екрана Chrome MCP / `existing-session` мають використовувати захоплення сторінки або `--ref` зі snapshot, а не CSS `--element`.
|
||||
- `existing-session file uploads do not support element selectors; use ref/inputRef.` → хуки завантаження файлів у Chrome MCP потребують snapshot ref, а не CSS selectors.
|
||||
- `existing-session file uploads currently support one file at a time.` → надсилайте одне завантаження за виклик у профілях Chrome MCP.
|
||||
- `existing-session dialog handling does not support timeoutMs.` → хуки діалогів у профілях Chrome MCP не підтримують перевизначення timeout.
|
||||
- `response body is not supported for existing-session profiles yet.` → `responsebody` усе ще потребує керованого браузера або сирого профілю CDP.
|
||||
- застарілі перевизначення viewport / dark-mode / locale / offline у профілях лише-підключення або віддаленого CDP → виконайте `openclaw browser stop --browser-profile <name>`, щоб закрити активну сесію керування і звільнити стан емуляції Playwright/CDP без перезапуску всього gateway.
|
||||
|
||||
Пов’язане:
|
||||
|
||||
@ -437,7 +438,7 @@ openclaw doctor
|
||||
|
||||
## Якщо ви оновилися і щось раптово зламалося
|
||||
|
||||
Більшість проблем після оновлення — це дрейф конфігурації або суворіші стандартні значення, які тепер застосовуються.
|
||||
Більшість збоїв після оновлення — це drift конфігурації або жорсткіші типові значення, які тепер застосовуються.
|
||||
|
||||
### 1) Змінилася поведінка auth і перевизначення URL
|
||||
|
||||
@ -450,15 +451,15 @@ openclaw config get gateway.auth.mode
|
||||
|
||||
Що перевірити:
|
||||
|
||||
- Якщо `gateway.mode=remote`, виклики CLI можуть спрямовуватися на remote, тоді як ваша локальна служба працює нормально.
|
||||
- Явні виклики `--url` не переходять до збережених облікових даних.
|
||||
- Якщо `gateway.mode=remote`, виклики CLI можуть бути націлені на віддалений вузол, тоді як ваш локальний сервіс працює нормально.
|
||||
- Явні виклики `--url` не використовують резервний перехід до збережених облікових даних.
|
||||
|
||||
Поширені ознаки:
|
||||
|
||||
- `gateway connect failed:` → неправильна URL-ціль.
|
||||
- `unauthorized` → endpoint досяжний, але auth неправильна.
|
||||
- `gateway connect failed:` → неправильна ціль URL.
|
||||
- `unauthorized` → endpoint досяжний, але auth неправильний.
|
||||
|
||||
### 2) Guardrails для bind і auth стали суворішими
|
||||
### 2) Обмеження bind і auth стали суворішими
|
||||
|
||||
```bash
|
||||
openclaw config get gateway.bind
|
||||
@ -470,13 +471,13 @@ openclaw logs --follow
|
||||
|
||||
Що перевірити:
|
||||
|
||||
- Bind не до loopback (`lan`, `tailnet`, `custom`) потребують коректного шляху auth gateway: shared token/password auth або правильно налаштованого розгортання `trusted-proxy` не на loopback.
|
||||
- Прив’язки не до loopback (`lan`, `tailnet`, `custom`) потребують дійсного шляху auth gateway: спільна автентифікація token/password або правильно налаштоване розгортання `trusted-proxy` не на loopback.
|
||||
- Старі ключі на кшталт `gateway.token` не замінюють `gateway.auth.token`.
|
||||
|
||||
Поширені ознаки:
|
||||
|
||||
- `refusing to bind gateway ... without auth` → bind не до loopback без коректного шляху auth gateway.
|
||||
- `RPC probe: failed` коли runtime працює → gateway живий, але недоступний із поточними auth/url.
|
||||
- `refusing to bind gateway ... without auth` → прив’язка не до loopback без дійсного шляху auth gateway.
|
||||
- `Connectivity probe: failed` коли середовище виконання працює → gateway живий, але недоступний із поточними auth/url.
|
||||
|
||||
### 3) Змінився стан pairing та ідентичності пристрою
|
||||
|
||||
@ -489,15 +490,15 @@ openclaw doctor
|
||||
|
||||
Що перевірити:
|
||||
|
||||
- Pending-схвалення пристроїв для dashboard/nodes.
|
||||
- Pending-схвалення pairing для DM після змін політики або ідентичності.
|
||||
- Очікують схвалення пристрої для dashboard/nodes.
|
||||
- Очікують схвалення DM pairing після змін політики або ідентичності.
|
||||
|
||||
Поширені ознаки:
|
||||
|
||||
- `device identity required` → auth пристрою не виконано.
|
||||
- `device identity required` → не виконано device auth.
|
||||
- `pairing required` → відправника/пристрій потрібно схвалити.
|
||||
|
||||
Якщо після перевірок конфігурація служби й runtime усе ще не збігаються, перевстановіть метадані служби з того самого каталогу профілю/стану:
|
||||
Якщо конфігурація сервісу та середовище виконання все ще не збігаються після перевірок, перевстановіть метадані сервісу з того самого каталогу профілю/стану:
|
||||
|
||||
```bash
|
||||
openclaw gateway install --force
|
||||
|
||||
1923
docs/uk/help/faq.md
1923
docs/uk/help/faq.md
File diff suppressed because it is too large
Load Diff
@ -1,25 +1,25 @@
|
||||
---
|
||||
read_when:
|
||||
- OpenClaw не працює, і вам потрібен найшвидший шлях до виправлення
|
||||
- Вам потрібен процес первинної діагностики, перш ніж переходити до детальних інструкцій
|
||||
- Ви хочете пройти потік тріажу, перш ніж занурюватися в детальні інструкції щодо усунення проблем
|
||||
summary: Центр усунення несправностей OpenClaw за симптомами
|
||||
title: Загальне усунення несправностей
|
||||
x-i18n:
|
||||
generated_at: "2026-04-10T20:41:24Z"
|
||||
generated_at: "2026-04-20T06:31:12Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 16b38920dbfdc8d4a79bbb5d6fab2c67c9f218a97c36bb4695310d7db9c4614a
|
||||
source_hash: cc5d8c9f804084985c672c5a003ce866e8142ab99fe81abb7a0d38e22aea4b88
|
||||
source_path: help/troubleshooting.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Усунення несправностей
|
||||
|
||||
Якщо у вас є лише 2 хвилини, використайте цю сторінку як початкову точку діагностики.
|
||||
Якщо у вас є лише 2 хвилини, використайте цю сторінку як початкову точку тріажу.
|
||||
|
||||
## Перші 60 секунд
|
||||
|
||||
Запустіть цю точну послідовність команд у вказаному порядку:
|
||||
Виконайте цю точну послідовність команд по порядку:
|
||||
|
||||
```bash
|
||||
openclaw status
|
||||
@ -31,19 +31,17 @@ openclaw channels status --probe
|
||||
openclaw logs --follow
|
||||
```
|
||||
|
||||
Хороший результат в одному рядку:
|
||||
Ознаки коректного виводу в одному рядку:
|
||||
|
||||
- `openclaw status` → показує налаштовані канали та відсутність очевидних помилок автентифікації.
|
||||
- `openclaw status --all` → повний звіт наявний і ним можна поділитися.
|
||||
- `openclaw gateway probe` → очікувана ціль gateway доступна (`Reachable: yes`). `RPC: limited - missing scope: operator.read` означає погіршену діагностику, а не збій підключення.
|
||||
- `openclaw gateway status` → `Runtime: running` і `RPC probe: ok`.
|
||||
- `openclaw doctor` → немає блокувальних помилок конфігурації або сервісу.
|
||||
- `openclaw channels status --probe` → доступний gateway повертає поточний
|
||||
стан транспорту для кожного облікового запису разом із результатами probe/audit, такими як `works` або `audit ok`; якщо
|
||||
gateway недоступний, команда переходить до зведень лише за конфігурацією.
|
||||
- `openclaw status` → показує налаштовані канали й відсутність очевидних помилок автентифікації.
|
||||
- `openclaw status --all` → повний звіт присутній і ним можна поділитися.
|
||||
- `openclaw gateway probe` → очікуваний Gateway призначення доступний (`Reachable: yes`). `Capability: ...` показує, який рівень автентифікації змогла підтвердити перевірка, а `Read probe: limited - missing scope: operator.read` означає погіршену діагностику, а не збій з’єднання.
|
||||
- `openclaw gateway status` → `Runtime: running`, `Connectivity probe: ok` і правдоподібний рядок `Capability: ...`. Використовуйте `--require-rpc`, якщо вам також потрібне підтвердження RPC з доступом на читання.
|
||||
- `openclaw doctor` → немає блокувальних помилок конфігурації/сервісу.
|
||||
- `openclaw channels status --probe` → доступний Gateway повертає поточний стан транспорту для кожного облікового запису разом із результатами перевірки/аудиту, наприклад `works` або `audit ok`; якщо Gateway недоступний, команда повертається до зведень лише за конфігурацією.
|
||||
- `openclaw logs --follow` → стабільна активність, без повторюваних фатальних помилок.
|
||||
|
||||
## Anthropic long context 429
|
||||
## 429 для довгого контексту Anthropic
|
||||
|
||||
Якщо ви бачите:
|
||||
`HTTP 429: rate_limit_error: Extra usage is required for long context requests`,
|
||||
@ -51,29 +49,29 @@ openclaw logs --follow
|
||||
|
||||
## Локальний OpenAI-compatible бекенд працює напряму, але не працює в OpenClaw
|
||||
|
||||
Якщо ваш локальний або самостійно розміщений `/v1` бекенд відповідає на малі прямі
|
||||
перевірки `/v1/chat/completions`, але завершується помилкою в `openclaw infer model run` або під час звичайних
|
||||
Якщо ваш локальний або self-hosted бекенд `/v1` відповідає на малі прямі перевірки
|
||||
`/v1/chat/completions`, але завершується помилкою на `openclaw infer model run` або під час звичайних
|
||||
ходів агента:
|
||||
|
||||
1. Якщо помилка згадує, що `messages[].content` очікує рядок, встановіть
|
||||
1. Якщо в помилці згадується, що `messages[].content` очікує рядок, установіть
|
||||
`models.providers.<provider>.models[].compat.requiresStringContent: true`.
|
||||
2. Якщо бекенд усе ще не працює лише під час ходів агента OpenClaw, встановіть
|
||||
2. Якщо бекенд і далі дає збій лише під час ходів агента OpenClaw, установіть
|
||||
`models.providers.<provider>.models[].compat.supportsTools: false` і повторіть спробу.
|
||||
3. Якщо крихітні прямі виклики все ще працюють, але більші запити OpenClaw призводять до збою
|
||||
бекенда, розглядайте решту проблеми як обмеження моделі/сервера на стороні джерела
|
||||
і перейдіть до детальної інструкції:
|
||||
3. Якщо крихітні прямі виклики все ще працюють, але більші запити OpenClaw аварійно завершують
|
||||
бекенд, вважайте решту проблеми обмеженням моделі/сервера на боці вищого рівня і
|
||||
продовжуйте в детальній інструкції:
|
||||
[/gateway/troubleshooting#local-openai-compatible-backend-passes-direct-probes-but-agent-runs-fail](/uk/gateway/troubleshooting#local-openai-compatible-backend-passes-direct-probes-but-agent-runs-fail)
|
||||
|
||||
## Не вдається встановити плагін через відсутні openclaw extensions
|
||||
## Не вдається встановити Plugin через відсутні openclaw extensions
|
||||
|
||||
Якщо встановлення завершується помилкою `package.json missing openclaw.extensions`, пакет плагіна
|
||||
Якщо встановлення завершується помилкою `package.json missing openclaw.extensions`, пакет Plugin
|
||||
використовує стару структуру, яку OpenClaw більше не приймає.
|
||||
|
||||
Виправлення в пакеті плагіна:
|
||||
Виправлення в пакеті Plugin:
|
||||
|
||||
1. Додайте `openclaw.extensions` до `package.json`.
|
||||
2. Спрямуйте записи на зібрані runtime-файли (зазвичай `./dist/index.js`).
|
||||
3. Повторно опублікуйте плагін і знову виконайте `openclaw plugins install <package>`.
|
||||
3. Повторно опублікуйте Plugin і знову виконайте `openclaw plugins install <package>`.
|
||||
|
||||
Приклад:
|
||||
|
||||
@ -87,7 +85,7 @@ openclaw logs --follow
|
||||
}
|
||||
```
|
||||
|
||||
Довідка: [Архітектура плагінів](/uk/plugins/architecture)
|
||||
Довідка: [Архітектура Plugin](/uk/plugins/architecture)
|
||||
|
||||
## Дерево рішень
|
||||
|
||||
@ -96,19 +94,19 @@ flowchart TD
|
||||
A[OpenClaw не працює] --> B{Що ламається першим}
|
||||
B --> C[Немає відповідей]
|
||||
B --> D[Dashboard або Control UI не підключається]
|
||||
B --> E[Gateway не запускається або сервіс не запущено]
|
||||
B --> E[Gateway не запускається або сервіс не працює]
|
||||
B --> F[Канал підключається, але повідомлення не проходять]
|
||||
B --> G[Cron або heartbeat не спрацював чи не доставив]
|
||||
B --> H[Node з'єднано, але інструмент camera canvas screen exec не працює]
|
||||
B --> I[Не працює інструмент браузера]
|
||||
B --> G[Cron або Heartbeat не спрацював чи не доставив повідомлення]
|
||||
B --> H[Node спарено, але не працює інструмент camera canvas screen exec]
|
||||
B --> I[Не працює інструмент browser]
|
||||
|
||||
C --> C1[/Розділ Немає відповідей/]
|
||||
D --> D1[/Розділ Control UI/]
|
||||
E --> E1[/Розділ Gateway/]
|
||||
F --> F1[/Розділ Потік каналу/]
|
||||
G --> G1[/Розділ Автоматизація/]
|
||||
H --> H1[/Розділ Інструменти node/]
|
||||
I --> I1[/Розділ Браузер/]
|
||||
C --> C1[/Розділ «Немає відповідей»/]
|
||||
D --> D1[/Розділ «Control UI»/]
|
||||
E --> E1[/Розділ «Gateway»/]
|
||||
F --> F1[/Розділ «Потік каналу»/]
|
||||
G --> G1[/Розділ «Автоматизація»/]
|
||||
H --> H1[/Розділ «Інструменти Node»/]
|
||||
I --> I1[/Розділ «Browser»/]
|
||||
```
|
||||
|
||||
<AccordionGroup>
|
||||
@ -121,18 +119,19 @@ flowchart TD
|
||||
openclaw logs --follow
|
||||
```
|
||||
|
||||
Хороший результат виглядає так:
|
||||
Коректний вивід виглядає так:
|
||||
|
||||
- `Runtime: running`
|
||||
- `RPC probe: ok`
|
||||
- `Connectivity probe: ok`
|
||||
- `Capability: read-only`, `write-capable` або `admin-capable`
|
||||
- Ваш канал показує підключений транспорт і, де це підтримується, `works` або `audit ok` у `channels status --probe`
|
||||
- Відправника показано як схваленого (або політика DM є відкритою/зі списком дозволених)
|
||||
- Відправника показано як схваленого (або політика DM відкрита/є в allowlist)
|
||||
|
||||
Поширені сигнатури в логах:
|
||||
Типові сигнатури в журналах:
|
||||
|
||||
- `drop guild message (mention required` → обмеження за згадкою заблокувало повідомлення в Discord.
|
||||
- `pairing request` → відправник не схвалений і очікує схвалення DM pairing.
|
||||
- `blocked` / `allowlist` у логах каналу → відправник, кімната або група відфільтровані.
|
||||
- `drop guild message (mention required` → обробку повідомлення було заблоковано вимогою згадки в Discord.
|
||||
- `pairing request` → відправника не схвалено, він очікує на схвалення спарювання в DM.
|
||||
- `blocked` / `allowlist` у журналах каналу → відправника, кімнату або групу відфільтровано.
|
||||
|
||||
Детальні сторінки:
|
||||
|
||||
@ -151,27 +150,23 @@ flowchart TD
|
||||
openclaw channels status --probe
|
||||
```
|
||||
|
||||
Хороший результат виглядає так:
|
||||
Коректний вивід виглядає так:
|
||||
|
||||
- `Dashboard: http://...` показано в `openclaw gateway status`
|
||||
- `RPC probe: ok`
|
||||
- У логах немає циклу автентифікації
|
||||
- `Connectivity probe: ok`
|
||||
- `Capability: read-only`, `write-capable` або `admin-capable`
|
||||
- У журналах немає циклу автентифікації
|
||||
|
||||
Поширені сигнатури в логах:
|
||||
Типові сигнатури в журналах:
|
||||
|
||||
- `device identity required` → HTTP/незахищений контекст не може завершити автентифікацію пристрою.
|
||||
- `origin not allowed` → `Origin` браузера не дозволений для цілі gateway у Control UI.
|
||||
- `AUTH_TOKEN_MISMATCH` із підказками повторної спроби (`canRetryWithDeviceToken=true`) → одна повторна спроба з довіреним токеном пристрою може виконуватися автоматично.
|
||||
- Ця повторна спроба з кешованим токеном повторно використовує кешований набір scope, збережений разом із прив’язаним
|
||||
токеном пристрою. Виклики з явним `deviceToken` / явними `scopes` натомість зберігають
|
||||
свій запитаний набір scope.
|
||||
- На асинхронному шляху Tailscale Serve Control UI невдалі спроби для того самого
|
||||
`{scope, ip}` серіалізуються до того, як limiter фіксує збій, тож
|
||||
друга одночасна невдала повторна спроба вже може показати `retry later`.
|
||||
- `too many failed authentication attempts (retry later)` з браузерного origin localhost → повторні
|
||||
невдалі спроби з того самого `Origin` тимчасово блокуються; інший origin localhost використовує окремий bucket.
|
||||
- повторювані `unauthorized` після цієї повторної спроби → неправильний токен/пароль, невідповідність режиму автентифікації або застарілий токен прив’язаного пристрою.
|
||||
- `gateway connect failed:` → UI націлений на неправильний URL/порт або gateway недоступний.
|
||||
- `origin not allowed` → `Origin` браузера не дозволений для Gateway призначення Control UI.
|
||||
- `AUTH_TOKEN_MISMATCH` із підказками повторної спроби (`canRetryWithDeviceToken=true`) → автоматично може відбутися одна повторна спроба з довіреним токеном пристрою.
|
||||
- Ця повторна спроба з кешованим токеном повторно використовує кешований набір scope, збережений разом зі спареним токеном пристрою. Виклики з явним `deviceToken` / явними `scopes` натомість зберігають запитаний ними набір scope.
|
||||
- На асинхронному шляху Tailscale Serve для Control UI невдалі спроби для одного й того ж `{scope, ip}` серіалізуються до того, як лімітер зафіксує збій, тому друга одночасна хибна повторна спроба вже може показувати `retry later`.
|
||||
- `too many failed authentication attempts (retry later)` з браузерного localhost-origin → повторні невдалі спроби з того самого `Origin` тимчасово блокуються; інший localhost-origin використовує окремий bucket.
|
||||
- повторювані `unauthorized` після цієї повторної спроби → неправильний токен/пароль, невідповідність режиму автентифікації або застарілий спарений токен пристрою.
|
||||
- `gateway connect failed:` → UI націлено на неправильний URL/порт або Gateway недоступний.
|
||||
|
||||
Детальні сторінки:
|
||||
|
||||
@ -181,7 +176,7 @@ flowchart TD
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Gateway не запускається або сервіс встановлено, але він не запущений">
|
||||
<Accordion title="Gateway не запускається або сервіс встановлено, але він не працює">
|
||||
```bash
|
||||
openclaw status
|
||||
openclaw gateway status
|
||||
@ -190,16 +185,17 @@ flowchart TD
|
||||
openclaw channels status --probe
|
||||
```
|
||||
|
||||
Хороший результат виглядає так:
|
||||
Коректний вивід виглядає так:
|
||||
|
||||
- `Service: ... (loaded)`
|
||||
- `Runtime: running`
|
||||
- `RPC probe: ok`
|
||||
- `Connectivity probe: ok`
|
||||
- `Capability: read-only`, `write-capable` або `admin-capable`
|
||||
|
||||
Поширені сигнатури в логах:
|
||||
Типові сигнатури в журналах:
|
||||
|
||||
- `Gateway start blocked: set gateway.mode=local` або `existing config is missing gateway.mode` → режим gateway є remote, або у файлі конфігурації відсутня позначка локального режиму, і його слід відновити.
|
||||
- `refusing to bind gateway ... without auth` → прив’язування не до loopback без дійсного шляху автентифікації gateway (токен/пароль або trusted-proxy, якщо налаштовано).
|
||||
- `Gateway start blocked: set gateway.mode=local` або `existing config is missing gateway.mode` → режим Gateway встановлено як remote, або у файлі конфігурації відсутня позначка local-mode і його слід виправити.
|
||||
- `refusing to bind gateway ... without auth` → прив’язка не до loopback без дійсного шляху автентифікації Gateway (token/password або trusted-proxy, де налаштовано).
|
||||
- `another gateway instance is already listening` або `EADDRINUSE` → порт уже зайнято.
|
||||
|
||||
Детальні сторінки:
|
||||
@ -219,16 +215,16 @@ flowchart TD
|
||||
openclaw channels status --probe
|
||||
```
|
||||
|
||||
Хороший результат виглядає так:
|
||||
Коректний вивід виглядає так:
|
||||
|
||||
- Транспорт каналу підключений.
|
||||
- Перевірки pairing/allowlist проходять.
|
||||
- Згадки виявляються там, де це потрібно.
|
||||
- Згадки визначаються там, де вони обов’язкові.
|
||||
|
||||
Поширені сигнатури в логах:
|
||||
Типові сигнатури в журналах:
|
||||
|
||||
- `mention required` → обмеження за згадкою в групі заблокувало обробку.
|
||||
- `pairing` / `pending` → відправник DM ще не схвалений.
|
||||
- `mention required` → обробку заблоковано вимогою згадки в групі.
|
||||
- `pairing` / `pending` → відправника DM ще не схвалено.
|
||||
- `not_in_channel`, `missing_scope`, `Forbidden`, `401/403` → проблема з токеном дозволів каналу.
|
||||
|
||||
Детальні сторінки:
|
||||
@ -238,7 +234,7 @@ flowchart TD
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Cron або heartbeat не спрацював чи не доставив">
|
||||
<Accordion title="Cron або Heartbeat не спрацював чи не доставив повідомлення">
|
||||
```bash
|
||||
openclaw status
|
||||
openclaw gateway status
|
||||
@ -248,21 +244,21 @@ flowchart TD
|
||||
openclaw logs --follow
|
||||
```
|
||||
|
||||
Хороший результат виглядає так:
|
||||
Коректний вивід виглядає так:
|
||||
|
||||
- `cron.status` показує, що його ввімкнено, і вказує наступне пробудження.
|
||||
- `cron.status` показує, що його ввімкнено, і вказує час наступного пробудження.
|
||||
- `cron runs` показує нещодавні записи `ok`.
|
||||
- Heartbeat увімкнено, і він не поза активними годинами.
|
||||
- Heartbeat увімкнено й він не поза межами активних годин.
|
||||
|
||||
Поширені сигнатури в логах:
|
||||
Типові сигнатури в журналах:
|
||||
|
||||
- `cron: scheduler disabled; jobs will not run automatically` → cron вимкнено.
|
||||
- `cron: scheduler disabled; jobs will not run automatically` → Cron вимкнено.
|
||||
- `heartbeat skipped` з `reason=quiet-hours` → поза налаштованими активними годинами.
|
||||
- `heartbeat skipped` з `reason=empty-heartbeat-file` → `HEARTBEAT.md` існує, але містить лише порожній каркас або лише заголовки.
|
||||
- `heartbeat skipped` з `reason=no-tasks-due` → режим завдань `HEARTBEAT.md` активний, але жоден із інтервалів завдань ще не настав.
|
||||
- `heartbeat skipped` з `reason=alerts-disabled` → усю видимість heartbeat вимкнено (`showOk`, `showAlerts` і `useIndicator` усі вимкнені).
|
||||
- `requests-in-flight` → основна лінія зайнята; пробудження heartbeat було відкладено.
|
||||
- `unknown accountId` → цільовий обліковий запис доставки heartbeat не існує.
|
||||
- `heartbeat skipped` з `reason=empty-heartbeat-file` → `HEARTBEAT.md` існує, але містить лише порожній/header-only каркас.
|
||||
- `heartbeat skipped` з `reason=no-tasks-due` → увімкнено режим завдань `HEARTBEAT.md`, але час для жодного з інтервалів завдань ще не настав.
|
||||
- `heartbeat skipped` з `reason=alerts-disabled` → усю видимість Heartbeat вимкнено (`showOk`, `showAlerts` і `useIndicator` усі вимкнені).
|
||||
- `requests-in-flight` → основна смуга зайнята; пробудження Heartbeat було відкладено.
|
||||
- `unknown accountId` → цільовий account доставки Heartbeat не існує.
|
||||
|
||||
Детальні сторінки:
|
||||
|
||||
@ -272,7 +268,7 @@ flowchart TD
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Node з'єднано, але інструмент не працює: camera canvas screen exec">
|
||||
<Accordion title="Node спарено, але інструмент не працює: camera canvas screen exec">
|
||||
```bash
|
||||
openclaw status
|
||||
openclaw gateway status
|
||||
@ -281,18 +277,18 @@ flowchart TD
|
||||
openclaw logs --follow
|
||||
```
|
||||
|
||||
Хороший результат виглядає так:
|
||||
Коректний вивід виглядає так:
|
||||
|
||||
- Node вказано як підключений і прив’язаний для ролі `node`.
|
||||
- Для команди, яку ви викликаєте, наявна capability.
|
||||
- Для інструмента надано потрібний стан дозволів.
|
||||
- Node показано як підключений і спарений для ролі `node`.
|
||||
- Для команди, яку ви викликаєте, існує Capability.
|
||||
- Для інструмента надано стан дозволу.
|
||||
|
||||
Поширені сигнатури в логах:
|
||||
Типові сигнатури в журналах:
|
||||
|
||||
- `NODE_BACKGROUND_UNAVAILABLE` → переведіть застосунок node на передній план.
|
||||
- `*_PERMISSION_REQUIRED` → дозвіл ОС було відхилено або його бракує.
|
||||
- `SYSTEM_RUN_DENIED: approval required` → схвалення exec очікує підтвердження.
|
||||
- `SYSTEM_RUN_DENIED: allowlist miss` → команда відсутня у списку дозволених для exec.
|
||||
- `NODE_BACKGROUND_UNAVAILABLE` → переведіть застосунок Node на передній план.
|
||||
- `*_PERMISSION_REQUIRED` → дозвіл ОС було відхилено/він відсутній.
|
||||
- `SYSTEM_RUN_DENIED: approval required` → очікується схвалення exec.
|
||||
- `SYSTEM_RUN_DENIED: allowlist miss` → команди немає в allowlist для exec.
|
||||
|
||||
Детальні сторінки:
|
||||
|
||||
@ -302,7 +298,7 @@ flowchart TD
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Exec раптом почав вимагати схвалення">
|
||||
<Accordion title="Exec раптом почав просити схвалення">
|
||||
```bash
|
||||
openclaw config get tools.exec.host
|
||||
openclaw config get tools.exec.security
|
||||
@ -312,14 +308,14 @@ flowchart TD
|
||||
|
||||
Що змінилося:
|
||||
|
||||
- Якщо `tools.exec.host` не задано, значенням за замовчуванням є `auto`.
|
||||
- `host=auto` розв’язується в `sandbox`, коли активне sandbox runtime, і в `gateway` у протилежному разі.
|
||||
- `host=auto` відповідає лише за маршрутизацію; поведінка "YOLO" без запиту зумовлюється `security=full` разом із `ask=off` на gateway/node.
|
||||
- У `gateway` і `node` незадане `tools.exec.security` за замовчуванням має значення `full`.
|
||||
- Незадане `tools.exec.ask` за замовчуванням має значення `off`.
|
||||
- Результат: якщо ви бачите схвалення, якийсь локальний для хоста або для сеансу policy посилив exec порівняно з поточними значеннями за замовчуванням.
|
||||
- Якщо `tools.exec.host` не встановлено, значенням за замовчуванням є `auto`.
|
||||
- `host=auto` визначається як `sandbox`, коли активне sandbox runtime, і як `gateway` в іншому разі.
|
||||
- `host=auto` впливає лише на маршрутизацію; поведінка "YOLO" без запитів походить від `security=full` разом із `ask=off` на gateway/node.
|
||||
- Для `gateway` і `node`, якщо `tools.exec.security` не встановлено, значенням за замовчуванням є `full`.
|
||||
- Якщо `tools.exec.ask` не встановлено, значенням за замовчуванням є `off`.
|
||||
- Результат: якщо ви бачите запити на схвалення, значить якась локальна для хоста або поточної сесії політика зробила exec суворішим порівняно з поточними значеннями за замовчуванням.
|
||||
|
||||
Відновити поточну типову поведінку без схвалення:
|
||||
Відновіть поточну поведінку без схвалень за замовчуванням:
|
||||
|
||||
```bash
|
||||
openclaw config set tools.exec.host gateway
|
||||
@ -330,15 +326,15 @@ flowchart TD
|
||||
|
||||
Безпечніші альтернативи:
|
||||
|
||||
- Встановіть лише `tools.exec.host=gateway`, якщо вам потрібна просто стабільна маршрутизація хоста.
|
||||
- Використовуйте `security=allowlist` разом із `ask=on-miss`, якщо хочете виконання на хості, але все ще бажаєте перевірку у випадках промаху по allowlist.
|
||||
- Увімкніть режим sandbox, якщо хочете, щоб `host=auto` знову розв’язувався в `sandbox`.
|
||||
- Установіть лише `tools.exec.host=gateway`, якщо вам потрібна просто стабільна маршрутизація хоста.
|
||||
- Використовуйте `security=allowlist` разом із `ask=on-miss`, якщо хочете exec на хості, але все одно хочете перевірку для промахів повз allowlist.
|
||||
- Увімкніть sandbox mode, якщо хочете, щоб `host=auto` знову визначався як `sandbox`.
|
||||
|
||||
Поширені сигнатури в логах:
|
||||
Типові сигнатури в журналах:
|
||||
|
||||
- `Approval required.` → команда очікує на `/approve ...`.
|
||||
- `SYSTEM_RUN_DENIED: approval required` → очікує схвалення для node-host exec.
|
||||
- `exec host=sandbox requires a sandbox runtime for this session` → неявно або явно вибрано sandbox, але режим sandbox вимкнено.
|
||||
- `SYSTEM_RUN_DENIED: approval required` → очікується схвалення exec на вузлі-хості.
|
||||
- `exec host=sandbox requires a sandbox runtime for this session` → неявний/явний вибір sandbox, але sandbox mode вимкнено.
|
||||
|
||||
Детальні сторінки:
|
||||
|
||||
@ -348,7 +344,7 @@ flowchart TD
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Не працює інструмент браузера">
|
||||
<Accordion title="Не працює інструмент browser">
|
||||
```bash
|
||||
openclaw status
|
||||
openclaw gateway status
|
||||
@ -357,22 +353,22 @@ flowchart TD
|
||||
openclaw doctor
|
||||
```
|
||||
|
||||
Хороший результат виглядає так:
|
||||
Коректний вивід виглядає так:
|
||||
|
||||
- Статус браузера показує `running: true` і вибраний браузер/профіль.
|
||||
- Статус browser показує `running: true` і вибраний browser/profile.
|
||||
- `openclaw` запускається, або `user` може бачити локальні вкладки Chrome.
|
||||
|
||||
Поширені сигнатури в логах:
|
||||
Типові сигнатури в журналах:
|
||||
|
||||
- `unknown command "browser"` або `unknown command 'browser'` → задано `plugins.allow`, і воно не містить `browser`.
|
||||
- `Failed to start Chrome CDP on port` → не вдалося запустити локальний Chrome CDP на порту.
|
||||
- `browser.executablePath not found` → указаний шлях до виконуваного файла неправильний.
|
||||
- `browser.cdpUrl must be http(s) or ws(s)` → налаштований URL CDP використовує непідтримувану схему.
|
||||
- `browser.cdpUrl has invalid port` → налаштований URL CDP має неправильний або неприпустимий порт.
|
||||
- `No Chrome tabs found for profile="user"` → у профілі приєднання Chrome MCP немає відкритих локальних вкладок Chrome.
|
||||
- `unknown command "browser"` або `unknown command 'browser'` → встановлено `plugins.allow`, і воно не містить `browser`.
|
||||
- `Failed to start Chrome CDP on port` → не вдалося запустити локальний browser Chrome.
|
||||
- `browser.executablePath not found` → налаштований шлях до бінарного файла неправильний.
|
||||
- `browser.cdpUrl must be http(s) or ws(s)` → налаштований CDP URL використовує непідтримувану схему.
|
||||
- `browser.cdpUrl has invalid port` → налаштований CDP URL має неправильний або неприпустимий порт.
|
||||
- `No Chrome tabs found for profile="user"` → профіль приєднання Chrome MCP не має відкритих локальних вкладок Chrome.
|
||||
- `Remote CDP for profile "<name>" is not reachable` → налаштована віддалена кінцева точка CDP недоступна з цього хоста.
|
||||
- `Browser attachOnly is enabled ... not reachable` або `Browser attachOnly is enabled and CDP websocket ... is not reachable` → профіль attach-only не має живої цілі CDP.
|
||||
- застарілі перевизначення viewport / dark-mode / locale / offline у профілях attach-only або remote CDP → виконайте `openclaw browser stop --browser-profile <name>`, щоб закрити активний сеанс керування й скинути стан емуляції без перезапуску gateway.
|
||||
- `Browser attachOnly is enabled ... not reachable` або `Browser attachOnly is enabled and CDP websocket ... is not reachable` → профіль attach-only не має активної цілі CDP.
|
||||
- застарілі перевизначення viewport / dark-mode / locale / offline на профілях attach-only або remote CDP → виконайте `openclaw browser stop --browser-profile <name>`, щоб закрити активну керовану сесію й скинути стан емуляції без перезапуску gateway.
|
||||
|
||||
Детальні сторінки:
|
||||
|
||||
@ -388,7 +384,7 @@ flowchart TD
|
||||
## Пов’язане
|
||||
|
||||
- [FAQ](/uk/help/faq) — поширені запитання
|
||||
- [Усунення несправностей Gateway](/uk/gateway/troubleshooting) — проблеми, пов’язані з gateway
|
||||
- [Doctor](/uk/gateway/doctor) — автоматизовані перевірки стану та виправлення
|
||||
- [Усунення несправностей Gateway](/uk/gateway/troubleshooting) — проблеми, пов’язані з Gateway
|
||||
- [Doctor](/uk/gateway/doctor) — автоматизовані перевірки стану й виправлення
|
||||
- [Усунення несправностей каналів](/uk/channels/troubleshooting) — проблеми з підключенням каналів
|
||||
- [Усунення несправностей автоматизації](/uk/automation/cron-jobs#troubleshooting) — проблеми з cron і heartbeat
|
||||
- [Усунення несправностей автоматизації](/uk/automation/cron-jobs#troubleshooting) — проблеми з Cron і Heartbeat
|
||||
|
||||
Loading…
Reference in New Issue
Block a user