FAQ и решение проблем

· 7 мин чтения · admin

Если что-то не работает — начните здесь. Статья объединяет FAQ, диагностику и troubleshooting из нескольких страниц документации.

Первые 60 секунд

Выполните эту лестницу команд по порядку:


openclaw status              # быстрый снимок: OS, Gateway, агенты, провайдеры
openclaw status --all        # полный отчёт (токены скрыты, можно делиться)
openclaw gateway status      # статус демона и подключения
openclaw doctor              # диагностика + авторемонт
openclaw channels status --probe  # статус каналов с проверкой
openclaw logs --follow       # логи в реальном времени

Что считать «здоровым»:

  • openclaw status — каналы настроены, нет ошибок auth
  • openclaw gateway status — Runtime: running, Connectivity probe: ok
  • openclaw doctor — нет блокирующих ошибок
  • openclaw channels status --probe — каналы подключены, works или audit ok

    • Что сломано? (дерево решений)

    Симптом Раздел
    Нет ответов от бота → Нет ответов
    Dashboard/Control UI не подключается → Control UI
    Gateway не запускается → Gateway не стартует
    Канал подключён, но сообщения не идут → Каналы
    Cron/heartbeat не сработал → Автоматизация
    Нода подключена, но камера/exec не работает → Ноды
    Браузер не работает → Браузер

    Нет ответов

    
openclaw status
openclaw gateway status
openclaw channels status --probe
openclaw pairing list --channel 
openclaw logs --follow

    Частые причины в логах:

  • pairing request — отправитель не одобрен. openclaw devices list → openclaw devices approve
  • drop guild message (mention required) — в группе нужно упомянуть бота
  • blocked / allowlist — отправитель заблокирован политикой

    • Control UI не подключается

    
openclaw gateway status
openclaw status
openclaw logs --follow
openclaw doctor

    Частые ошибки:

  • device identity required — HTTP без TLS, нет device auth. Используйте Tailscale Serve или SSH-туннель
  • origin not allowed — браузерный Origin не в gateway.controlUi.allowedOrigins
  • AUTH_TOKEN_MISMATCH — неверный token/password. Обновите в настройках UI
  • unauthorized после retry — проверьте token/password, совпадает ли с конфигом

    • Как получить/сбросить token:

    
openclaw config get gateway.auth.token
openclaw doctor --generate-gateway-token

    Gateway не запускается

    
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor

    Частые причины:

  • EADDRINUSE — порт занят. lsof -i :18789 → убить процесс или сменить порт
  • refusing to bind without auth — non-loopback bind без token/password
  • Gateway start blocked: set gateway.mode=local — конфиг повреждён. openclaw doctor --fix
  • existing config is missing gateway.mode — нужен режим local. openclaw doctor

    • Канал подключён, но сообщения не идут

    
openclaw status
openclaw channels status --probe
openclaw logs --follow

    Частые причины:

  • mention required — групповое сообщение без упоминания бота
  • pairing / pending — отправитель не одобрен для DM
  • not_in_channel / Forbidden / 401/403 — проблема с токеном канала

    • Cron и heartbeat не сработали

    
openclaw cron status
openclaw cron list
openclaw cron runs --id  --limit 20
openclaw logs --follow

    Чеклист:

  • Gateway работает 24/7? (без сна и перезагрузок)
  • Cron включён? (cron.enabled, нет OPENCLAW_SKIP_CRON)
  • Часовой пояс правильный? (--tz vs хост)
  • heartbeat skipped: quiet-hours — вне активных часов
  • heartbeat skipped: empty-heartbeat-file — HEARTBEAT.md пустой
  • requests-in-flight — основной lane занят, heartbeat отложен

    • Нода подключена, но инструменты не работают

    
openclaw nodes status
openclaw nodes describe --node 
openclaw approvals get --node 
openclaw logs --follow

    Частые ошибки:

    Ошибка Причина Решение
    NODE_BACKGROUND_UNAVAILABLE Приложение свёрнуто Откройте на передний план
    *_PERMISSION_REQUIRED Нет разрешения OS Дайте в настройках устройства
    SYSTEM_RUN_DENIED: approval required Exec не одобрен Настройте exec-approvals
    SYSTEM_RUN_DENIED: allowlist miss Команда не в allowlist Добавьте в allowlist

    Браузер не работает

    
openclaw browser status
openclaw logs --follow
openclaw doctor

    Частые причины:

  • unknown command "browser" — плагин browser не в plugins.allow
  • Failed to start Chrome CDP — Chrome не запустился
  • browser.executablePath not found — неверный путь к браузеру
  • No Chrome tabs found — нет открытых вкладок Chrome для profile=»user»

    • Exec вдруг просит одобрение

    Если раньше работало без вопросов, а теперь требует approval:

    
openclaw config get tools.exec.host
openclaw config get tools.exec.security
openclaw config get tools.exec.ask

    Вернуть без审批 поведение:

    
openclaw config set tools.exec.host gateway
openclaw config set tools.exec.security full
openclaw config set tools.exec.ask off
openclaw gateway restart

    FAQ: часто задаваемые вопросы

    Что такое OpenClaw?

    Персональный ИИ-ассистент, который работает на ваших устройствах и отвечает в мессенджерах, которые вы уже используете (Telegram, WhatsApp, Slack, Discord, Signal, iMessage). Gateway — это always-on контрольная плоскость; ассистент — это продукт.

    Какую модель выбрать?

  • Для начала: любую с API (OpenAI, Anthropic, OpenRouter)
  • Для экономии: локальные модели через Ollama
  • Для сложных задач: Claude Opus / GPT-4o с failover на дешёвую модель
  • Per-task: разные модели для разных агентов или cron-задач

    • Бот завис при тяжёлой задаче

    Используйте субагентов — они работают в своей сессии, возвращают результат, не блокируя основной чат.

    Cron не отправляет в канал

    Проверьте delivery mode:

  • delivery.mode: "none" — ничего не отправит
  • Нет channel/to в announce — runner пропустит доставку
  • Ошибка Forbidden — проблема с токеном канала

    • Как перенести настройки на новый сервер?

  • Установить OpenClaw на новой машине
  • Скопировать ~/.openclaw (state dir) + workspace
  • openclaw doctor
  • Перезапустить Gateway

    • ⚠️ Workspace Git хранит только memory + bootstrap, но НЕ сессии и auth. Они в ~/.openclaw/agents//sessions/.

    Raspberry Pi?

    Работает. Нужно 512MB–1GB RAM, 1 ядро, ~500MB диска. Рекомендации:

  • 64-bit OS, Node >= 22
  • Git-установка для быстрого обновления
  • Начать без каналов/скиллов, потом добавлять по одному

    • Stable vs Beta?

    latest = стабильная, beta = ранняя сборка для тестирования. Обычно stable сначала попадает в beta, потом в latest.

    
# Бета
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta
# Dev (из git)
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

    Где логи?

    
openclaw logs --follow          # через RPC
# Если RPC недоступен:
tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"

    Split brain после обновления

    Если Gateway падает после обновления с ошибкой версии:

    
which openclaw                  # какой бинарник используется
openclaw --version              # его версия
openclaw config get meta.lastTouchedVersion  # версия конфига

    Если конфиг написан новой версией, а запускается старая — обновите PATH:

    
openclaw gateway install --force
openclaw gateway restart

    Anthropic 429: long context

    Если видите HTTP 429: rate_limit_error: Extra usage is required for long context requests:

  • Отключить context1m для модели
  • Использовать credential с доступом к long context
  • Настроить fallback модели

    • Отладка (debugging)

    Runtime debug overrides

    /debug в чате — runtime-only переопределения конфига (не пишутся на диск).

    
/debug show
/debug set messages.responsePrefix="[openclaw]"
/debug unset messages.responsePrefix
/debug reset

    Включить: commands.debug: true в конфиге.

    Session trace

    /trace — плагиновые trace/debug строки без полного verbose режима.

    
/trace on
/trace off

    Raw stream logging

    Логирование необработанного потока ассистента (до фильтрации). Лучший способ увидеть, приходит ли reasoning как plain text:

    
OPENCLAW_RAW_STREAM=1 openclaw gateway
# Или
pnpm gateway:watch --raw-stream

    Файл: ~/.openclaw/logs/raw-stream.jsonl

    ⚠️ Raw stream логи содержат полные промпты, tool output и пользовательские данные. Храните локально, удаляйте после отладки.

    Что дальше

  • Конфигурация Gateway — настройки сервера
  • Безопасность и доступ — авторизация
  • Troubleshooting каналов — проблемы с мессенджерами
  • Установка OpenClaw — инструкции по установке