English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Start here

Загальне усунення неполадок

Якщо у вас є лише 2 хвилини, використовуйте цю сторінку як вхідну точку для triage.

Перші 60 секунд

Виконайте цю точну послідовність по порядку:

bash
OmeniaClaw statusOmeniaClaw status --allOmeniaClaw gateway probeOmeniaClaw gateway statusOmeniaClaw doctorOmeniaClaw channels status --probeOmeniaClaw logs --follow

Хороший вивід в один рядок:

  • OmeniaClaw status → показує налаштовані канали й не містить очевидних помилок автентифікації.
  • OmeniaClaw status --all → повний звіт наявний і придатний для поширення.
  • OmeniaClaw gateway probe → очікувана ціль gateway доступна (Reachable: yes). Capability: ... повідомляє, який рівень автентифікації зміг підтвердити probe, а Read probe: limited - missing scope: operator.read означає погіршену діагностику, а не збій підключення.
  • OmeniaClaw gateway status → Runtime: running, Connectivity probe: ok і правдоподібний рядок Capability: .... Використовуйте --require-rpc, якщо вам також потрібне підтвердження RPC зі scope читання.
  • OmeniaClaw doctor → немає блокувальних помилок конфігурації чи сервісу.
  • OmeniaClaw channels status --probe → доступний gateway повертає живий стан транспорту для кожного облікового запису плюс результати probe/audit, як-от works або audit ok; якщо gateway недоступний, команда повертається до зведень лише за конфігурацією.
  • OmeniaClaw logs --follow → стабільна активність, без повторюваних фатальних помилок.

Довгий контекст Anthropic 429

Якщо ви бачите: HTTP 429: rate_limit_error: Extra usage is required for long context requests, перейдіть до /gateway/troubleshooting#anthropic-429-extra-usage-required-for-long-context.

Локальний OpenAI-сумісний бекенд працює напряму, але дає збій в OmeniaClaw

Якщо ваш локальний або self-hosted бекенд /v1 відповідає на малі прямі probe /v1/chat/completions, але дає збій на OmeniaClaw infer model run або звичайних ходах агента:

  1. Якщо помилка згадує, що messages[].content очікує рядок, задайте models.providers.<provider>.models[].compat.requiresStringContent: true.
  2. Якщо бекенд усе ще дає збій лише на ходах агента OmeniaClaw, задайте models.providers.<provider>.models[].compat.supportsTools: false і повторіть спробу.
  3. Якщо крихітні прямі виклики все ще працюють, але більші prompts OmeniaClaw призводять до збою бекенду, розглядайте решту проблеми як обмеження upstream-моделі/сервера й продовжуйте в докладному runbook: /gateway/troubleshooting#local-openai-compatible-backend-passes-direct-probes-but-agent-runs-fail

Інсталяція Plugin завершується помилкою через відсутні OmeniaClaw extensions

Якщо інсталяція завершується помилкою package.json missing OmeniaClaw.extensions, пакет plugin використовує стару форму, яку OmeniaClaw більше не приймає.

Виправлення в пакеті plugin:

  1. Додайте OmeniaClaw.extensions до package.json.
  2. Спрямуйте записи на зібрані runtime-файли, зазвичай ./dist/index.js.
  3. Повторно опублікуйте plugin і знову запустіть OmeniaClaw plugins install <package>.

Приклад:

json
{  "name": "@OmeniaClaw/my-plugin",  "version": "1.2.3",  "OmeniaClaw": {    "extensions": ["./dist/index.js"]  }}

Довідка: Архітектура Plugin

Plugin наявний, але заблокований через підозріле володіння

Якщо OmeniaClaw doctor, налаштування або попередження під час запуску показують:

text
blocked plugin candidate: suspicious ownership (... uid=1000, expected uid=0 or root)plugin present but blocked

файли plugin належать іншому користувачу Unix, ніж процес, який їх завантажує. Не видаляйте конфігурацію plugin. Виправте володіння файлами або запускайте OmeniaClaw від того самого користувача, якому належить каталог стану.

Docker-інсталяції зазвичай працюють як node (uid 1000). Для стандартного налаштування Docker виправте bind mounts на хості:

bash
sudo chown -R 1000:1000 /path/to/OmeniaClaw-config /path/to/OmeniaClaw-workspaceOmeniaClaw doctor --fix

Якщо ви навмисно запускаєте OmeniaClaw як root, натомість виправте керований корінь plugin на володіння root:

bash
sudo chown -R root:root /path/to/OmeniaClaw-config/npmOmeniaClaw doctor --fix

Докладніша документація:

Дерево рішень

flowchart TD
  A[OmeniaClaw не працює] --> B{Що ламається першим}
  B --> C[Немає відповідей]
  B --> D[Dashboard або Control UI не підключається]
  B --> E[Gateway не запускається або сервіс не працює]
  B --> F[Канал підключається, але повідомлення не проходять]
  B --> G[Cron або heartbeat не спрацював чи не доставив]
  B --> H[Node paired, але camera canvas screen exec дає збій]
  B --> I[Інструмент браузера дає збій]

  C --> C1[/Розділ «Немає відповідей»/]
  D --> D1[/Розділ Control UI/]
  E --> E1[/Розділ Gateway/]
  F --> F1[/Розділ потоку каналу/]
  G --> G1[/Розділ автоматизації/]
  H --> H1[/Розділ інструментів Node/]
  I --> I1[/Розділ браузера/]
No replies
bash
OmeniaClaw statusOmeniaClaw gateway statusOmeniaClaw channels status --probeOmeniaClaw pairing list --channel <channel> [--account <id>]OmeniaClaw logs --follow

Хороший вивід виглядає так:

  • Runtime: running
  • Connectivity probe: ok
  • Capability: read-only, write-capable або admin-capable
  • Ваш канал показує, що транспорт підключений, а де підтримується, works або audit ok у channels status --probe
  • Відправник виглядає схваленим або політика DM відкрита/allowlist

Поширені сигнатури в логах:

  • drop guild message (mention required → mention gating заблокував повідомлення в Discord.
  • pairing request → відправник не схвалений і очікує схвалення pairing у DM.
  • blocked / allowlist у логах каналу → відправник, кімната або група відфільтровані.

Докладні сторінки:

Dashboard or Control UI will not connect
bash
OmeniaClaw statusOmeniaClaw gateway statusOmeniaClaw logs --followOmeniaClaw doctorOmeniaClaw channels status --probe

Хороший вивід виглядає так:

  • Dashboard: http://... показано в OmeniaClaw gateway status
  • 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) → одна довірена повторна спроба з device-token може відбутися автоматично.
  • Ця повторна спроба з кешованим токеном повторно використовує кешований набір scope, збережений із paired device token. Викликачі з явним deviceToken / явними scopes натомість зберігають запитаний ними набір scope.
  • На асинхронному шляху Tailscale Serve Control UI невдалі спроби для тієї самої пари {scope, ip} серіалізуються до того, як limiter зафіксує невдачу, тож друга одночасна невдала повторна спроба вже може показати retry later.
  • too many failed authentication attempts (retry later) з localhost browser origin → повторні збої з того самого Origin тимчасово заблоковані; інший localhost origin використовує окремий bucket.
  • повторні unauthorized після цієї повторної спроби → неправильний token/password, невідповідність режиму auth або застарілий paired device token.
  • gateway connect failed: → UI спрямований на неправильний URL/порт або недоступний gateway.

Докладні сторінки:

Gateway will not start or service installed but not running
bash
OmeniaClaw statusOmeniaClaw gateway statusOmeniaClaw logs --followOmeniaClaw doctorOmeniaClaw channels status --probe

Хороший вивід виглядає так:

  • Service: ... (loaded)
  • Runtime: running
  • 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, або у файлі конфігурації відсутній штамп local-mode і його треба виправити.
  • refusing to bind gateway ... without auth → прив’язка не до loopback без дійсного шляху автентифікації gateway (token/password або trusted-proxy, де налаштовано).
  • another gateway instance is already listening або EADDRINUSE → порт уже зайнятий.

Докладні сторінки:

Channel connects but messages do not flow
bash
OmeniaClaw statusOmeniaClaw gateway statusOmeniaClaw logs --followOmeniaClaw doctorOmeniaClaw channels status --probe

Хороший вивід виглядає так:

  • Транспорт каналу підключений.
  • Перевірки pairing/allowlist проходять.
  • Mentions виявляються там, де це потрібно.

Поширені сигнатури в логах:

  • mention required → group mention gating заблокував обробку.
  • pairing / pending → відправник DM ще не схвалений.
  • not_in_channel, missing_scope, Forbidden, 401/403 → проблема з permission token каналу.

Докладні сторінки:

Cron or heartbeat did not fire or did not deliver
bash
OmeniaClaw statusOmeniaClaw gateway statusOmeniaClaw cron statusOmeniaClaw cron listOmeniaClaw cron runs --id <jobId> --limit 20OmeniaClaw logs --follow

Хороший вивід виглядає так:

  • cron.status показує, що увімкнено, із наступним wake.
  • cron runs показує нещодавні записи ok.
  • Heartbeat увімкнений і не поза active hours.

Поширені сигнатури в логах:

  • cron: scheduler disabled; jobs will not run automatically → cron вимкнений.
  • heartbeat skipped з reason=quiet-hours → поза налаштованими active hours.
  • heartbeat skipped з reason=empty-heartbeat-file → HEARTBEAT.md існує, але містить лише порожній/header-only scaffold.
  • heartbeat skipped з reason=no-tasks-due → task mode у HEARTBEAT.md активний, але жоден із task intervals ще не настав.
  • heartbeat skipped з reason=alerts-disabled → уся видимість heartbeat вимкнена (showOk, showAlerts і useIndicator усі вимкнені).
  • requests-in-flight → main lane зайнятий; wake heartbeat було відкладено.
  • unknown accountId → цільовий обліковий запис доставки heartbeat не існує.

Докладні сторінки:

Node is paired but tool fails camera canvas screen exec
bash
OmeniaClaw statusOmeniaClaw gateway statusOmeniaClaw nodes statusOmeniaClaw nodes describe --node <idOrNameOrIp>OmeniaClaw logs --follow

Хороший вивід виглядає так:

  • Node зазначено як підключений і paired для ролі node.
  • Capability існує для команди, яку ви викликаєте.
  • Стан permission для інструмента надано.

Поширені сигнатури в логах:

  • NODE_BACKGROUND_UNAVAILABLE → виведіть застосунок Node на передній план.
  • *_PERMISSION_REQUIRED → дозвіл ОС було відхилено або він відсутній.
  • SYSTEM_RUN_DENIED: approval required → очікується схвалення exec.
  • SYSTEM_RUN_DENIED: allowlist miss → команди немає в allowlist exec.

Докладні сторінки:

Exec раптово запитує схвалення
bash
OmeniaClaw config get tools.exec.hostOmeniaClaw config get tools.exec.securityOmeniaClaw config get tools.exec.askOmeniaClaw gateway restart

Що змінилося:

  • Якщо tools.exec.host не задано, стандартне значення — auto.
  • host=auto розв’язується в sandbox, коли активне середовище виконання sandbox, і в gateway в інших випадках.
  • host=auto відповідає лише за маршрутизацію; поведінку без запитів "YOLO" забезпечує security=full разом із ask=off на Gateway/Node.
  • На gateway і node незаданий tools.exec.security за замовчуванням має значення full.
  • Незаданий tools.exec.ask за замовчуванням має значення off.
  • Результат: якщо ви бачите схвалення, певна локальна для хоста або посеансова політика зробила exec суворішим за поточні стандартні значення.

Відновіть поточну стандартну поведінку без схвалень:

bash
OmeniaClaw config set tools.exec.host gatewayOmeniaClaw config set tools.exec.security fullOmeniaClaw config set tools.exec.ask offOmeniaClaw gateway restart

Безпечніші альтернативи:

  • Задайте лише tools.exec.host=gateway, якщо вам потрібна тільки стабільна маршрутизація хоста.
  • Використовуйте security=allowlist з ask=on-miss, якщо вам потрібен host exec, але ви все одно хочете перевірку для промахів allowlist.
  • Увімкніть режим sandbox, якщо хочете, щоб host=auto знову розв’язувався в sandbox.

Поширені сигнатури журналу:

  • Approval required. → команда очікує на /approve ....
  • SYSTEM_RUN_DENIED: approval required → очікується схвалення exec на хості Node.
  • exec host=sandbox requires a sandbox runtime for this session → неявний або явний вибір sandbox, але режим sandbox вимкнено.

Докладні сторінки:

Інструмент браузера не працює
bash
OmeniaClaw statusOmeniaClaw gateway statusOmeniaClaw browser statusOmeniaClaw logs --followOmeniaClaw doctor

Коректний вивід виглядає так:

  • Стан браузера показує running: true і вибраний браузер/профіль.
  • OmeniaClaw запускається, або user може бачити локальні вкладки Chrome.

Поширені сигнатури журналу:

  • unknown command "browser" або unknown command 'browser' → plugins.allow задано, і він не містить browser.
  • Failed to start Chrome CDP on port → не вдалося запустити локальний браузер.
  • 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 → профіль лише для приєднання не має активної цілі CDP.
  • застарілі перевизначення viewport / dark-mode / locale / offline у профілях лише для приєднання або віддалених профілях CDP → виконайте OmeniaClaw browser stop --browser-profile <name>, щоб закрити активний сеанс керування й звільнити стан емуляції без перезапуску gateway.

Докладні сторінки:

Пов’язане

Was this useful?
On this page

On this page