Устранение неполадок 🔧

Когда OpenClaw ведёт себя неправильно, вот как это исправить.

Начните с Первые 60 секунд в FAQ, если вы просто хотите быстрый рецепт диагностики. Эта страница идёт глубже в сбои во время выполнения и диагностику.

Сокращения для конкретных провайдеров: /channels/troubleshooting

Статус и диагностика

Быстрые команды диагностики (по порядку):

КомандаЧто она говоритКогда использовать
openclaw statusЛокальная сводка: ОС + обновление, доступность/режим шлюза, сервис, агенты/сессии, состояние конфигурации провайдераПервая проверка, быстрый обзор
openclaw status --allПолная локальная диагностика (только чтение, можно вставить, относительно безопасна) включая хвост логовКогда нужно поделиться отчётом об отладке
openclaw status --deepВыполняет проверки работоспособности шлюза (включая пробы провайдеров; требует доступный шлюз)Когда "настроено" не означает "работает"
openclaw gateway probeОбнаружение шлюза + доступность (локальные + удалённые цели)Когда вы подозреваете, что пробуете не тот шлюз
openclaw channels status --probeСпрашивает работающий шлюз о статусе каналов (и опционально пробует)Когда шлюз доступен, но каналы неправильно себя ведут
openclaw gateway statusСостояние супервизора (launchd/systemd/schtasks), PID/выход во время выполнения, последняя ошибка шлюзаКогда сервис "выглядит загруженным", но ничего не работает
openclaw logs --followЖивые логи (лучший сигнал для проблем во время выполнения)Когда вам нужна фактическая причина сбоя

Обмен выводом: предпочитайте openclaw status --all (он редактирует токены). Если вы вставляете openclaw status, рассмотрите сначала установку OPENCLAW_SHOW_SECRETS=0 (предпросмотр токенов).

Смотрите также: Health checks и Logging.

Распространённые проблемы

Не найден API ключ для провайдера "anthropic"

Это означает, что хранилище аутентификации агента пусто или отсутствуют учётные данные Anthropic. Аутентификация для каждого агента, поэтому новый агент не унаследует ключи главного агента.

Варианты исправления:

  • Повторно запустите онбординг и выберите Anthropic для этого агента.
  • Или вставьте setup-token на хосте шлюза: 
    openclaw models auth setup-token --provider anthropic
  • Или скопируйте auth-profiles.json из директории главного агента в директорию нового агента.

Проверьте:

openclaw models status

Не удалось обновить OAuth токен (подписка Anthropic Claude)

Это означает, что сохранённый OAuth токен Anthropic истёк, и обновление не удалось. Если вы на подписке Claude (без API ключа), самое надёжное исправление — это переключиться на setup-token Claude Code и вставить его на хосте шлюза.

Рекомендуется (setup-token):

# Запустите на хосте шлюза (вставьте setup-token)
openclaw models auth setup-token --provider anthropic
openclaw models status

Если вы сгенерировали токен в другом месте:

openclaw models auth paste-token --provider anthropic
openclaw models status

Подробнее: Anthropic и OAuth.

Панель управления не работает по HTTP ("требуется идентификация устройства" / "не удалось подключиться")

Если вы открываете панель управления по обычному HTTP (например, http://<lan-ip>:18789/ или http://<tailscale-ip>:18789/), браузер работает в небезопасном контексте и блокирует WebCrypto, поэтому идентификация устройства не может быть сгенерирована.

Исправление:

  • Предпочтите HTTPS через Tailscale Serve.
  • Или откройте локально на хосте шлюза: http://127.0.0.1:18789/.
  • Если вы должны остаться на HTTP, включите gateway.controlUi.allowInsecureAuth: true и используйте токен шлюза (только токен; без идентификации устройства/сопряжения). Смотрите Control UI.

Сканирование секретов CI не удалось

Это означает, что detect-secrets нашёл новых кандидатов, ещё не в базовой линии. Следуйте Secret scanning.

Сервис установлен, но ничего не работает

Если сервис шлюза установлен, но процесс немедленно завершается, сервис может выглядеть "загруженным", но ничего не работает.

Проверьте:

openclaw gateway status
openclaw doctor

Doctor/сервис покажет состояние во время выполнения (PID/последний выход) и подсказки из логов.

Логи:

  • Предпочтительно: openclaw logs --follow
  • Файловые логи (всегда): /tmp/openclaw/openclaw-YYYY-MM-DD.log (или ваш настроенный logging.file)
  • macOS LaunchAgent (если установлен): $OPENCLAW_STATE_DIR/logs/gateway.log и gateway.err.log
  • Linux systemd (если установлен): journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager
  • Windows: schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST

Включите больше логирования:

  • Увеличьте детализацию файлового лога (сохранённый JSONL): 
    { "logging": { "level": "debug" } }
  • Увеличьте подробность консоли (только вывод TTY): 
    { "logging": { "consoleLevel": "debug", "consoleStyle": "pretty" } }
  • Быстрый совет: --verbose влияет только на вывод консоли. Файловые логи остаются под контролем logging.level.

Смотрите /logging для полного обзора форматов, конфигурации и доступа.

"Запуск шлюза заблокирован: установите gateway.mode=local"

Это означает, что конфигурация существует, но gateway.mode не установлен (или не local), поэтому Шлюз отказывается запускаться.

Исправление (рекомендуется):

  • Запустите мастер и установите режим работы Шлюза на Local: 
    openclaw configure
  • Или установите его напрямую: 
    openclaw config set gateway.mode local

Если вы хотели запустить удалённый Шлюз вместо этого:

  • Установите удалённый URL и оставьте gateway.mode=remote: 
    openclaw config set gateway.mode remote
openclaw config set gateway.remote.url "wss://gateway.example.com"

Только для разработки: передайте --allow-unconfigured для запуска шлюза без gateway.mode=local.

Ещё нет файла конфигурации? Запустите openclaw setup для создания начальной конфигурации, затем перезапустите шлюз.

Окружение сервиса (PATH + runtime)

Сервис шлюза работает с минимальным PATH, чтобы избежать shell/manager cruft:

  • macOS: /opt/homebrew/bin, /usr/local/bin, /usr/bin, /bin
  • Linux: /usr/local/bin, /usr/bin, /bin

Это намеренно исключает менеджеры версий (nvm/fnm/volta/asdf) и менеджеры пакетов (pnpm/npm), потому что сервис не загружает ваш shell init. Переменные runtime, такие как DISPLAY, должны находиться в ~/.openclaw/.env (загружается рано шлюзом). Exec запускается на host=gateway и объединяет ваш login-shell PATH в окружение exec, поэтому отсутствующие инструменты обычно означают, что ваш shell init не экспортирует их (или установите tools.exec.pathPrepend). Смотрите /tools/exec.

WhatsApp + каналы Telegram требуют Node; Bun не поддерживается. Если ваш сервис был установлен с Bun или путём Node с управлением версиями, запустите openclaw doctor для миграции на установку системного Node.

Навыку не хватает API ключа в песочнице

Симптом: Навык работает на хосте, но терпит неудачу в песочнице с отсутствующим API ключом.

Почему: exec в песочнице работает внутри Docker и не наследует process.env хоста.

Исправление:

  • установите agents.defaults.sandbox.docker.env (или для отдельного агента agents.list[].sandbox.docker.env)
  • или вставьте ключ в ваш пользовательский образ песочницы
  • затем запустите openclaw sandbox recreate --agent <id> (или --all)

Сервис работает, но порт не слушает

Если сервис сообщает running, но ничего не слушает на порту шлюза, Шлюз, вероятно, отказался привязываться.

Что означает "running" здесь

  • Runtime: running означает, что ваш супервизор (launchd/systemd/schtasks) думает, что процесс жив.
  • RPC probe означает, что CLI смог фактически подключиться к WebSocket шлюза и вызвать status.
  • Всегда доверяйте Probe target: + Config (service): как линиям "что мы фактически попробовали?".

Проверьте:

  • gateway.mode должен быть local для openclaw gateway и сервиса.
  • Если вы установили gateway.mode=remote, CLI по умолчанию использует удалённый URL. Сервис всё ещё может работать локально, но ваш CLI может пробовать не то место. Используйте openclaw gateway status для просмотра разрешённого порта сервиса + цели пробы (или передайте --url).
  • openclaw gateway status и openclaw doctor выводят последнюю ошибку шлюза из логов, когда сервис выглядит работающим, но порт закрыт.
  • Привязки не к loopback (lan/tailnet/custom, или auto, когда loopback недоступен) требуют аутентификации: gateway.auth.token (или OPENCLAW_GATEWAY_TOKEN).
  • gateway.remote.token только для удалённых вызовов CLI; он не включает локальную аутентификацию.
  • gateway.token игнорируется; используйте gateway.auth.token.

Если openclaw gateway status показывает несоответствие конфигурации

  • Config (cli): ... и Config (service): ... обычно должны совпадать.
  • Если они не совпадают, вы почти наверняка редактируете одну конфигурацию, пока сервис запускает другую.
  • Исправление: повторно запустите openclaw gateway install --force из того же --profile / OPENCLAW_STATE_DIR, который вы хотите, чтобы использовал сервис.

Если openclaw gateway status сообщает о проблемах конфигурации сервиса

  • В конфигурации супервизора (launchd/systemd/schtasks) отсутствуют текущие настройки по умолчанию.
  • Исправление: запустите openclaw doctor для её обновления (или openclaw gateway install --force для полной перезаписи).

Если Last gateway error: упоминает "отказ привязки … без аутентификации"

  • Вы установили gateway.bind на режим не loopback (lan/tailnet/custom, или auto, когда loopback недоступен), но не настроили аутентификацию.
  • Исправление: установите gateway.auth.mode + gateway.auth.token (или экспортируйте OPENCLAW_GATEWAY_TOKEN) и перезапустите сервис.

Если openclaw gateway status говорит bind=tailnet, но интерфейс tailnet не найден

  • Шлюз попытался привязаться к IP Tailscale (100.64.0.0/10), но ни один не был обнаружен на хосте.
  • Исправление: поднимите Tailscale на этой машине (или измените gateway.bind на loopback/lan).

Если Probe note: говорит, что проба использует loopback

  • Это ожидается для bind=lan: шлюз слушает на 0.0.0.0 (все интерфейсы), и loopback всё равно должен подключаться локально.
  • Для удалённых клиентов используйте реальный LAN IP (не 0.0.0.0) плюс порт, и убедитесь, что аутентификация настроена.

Адрес уже используется (порт 18789)

Это означает, что что-то уже слушает на порту шлюза.

Проверьте:

openclaw gateway status

Он покажет слушателя(ей) и вероятные причины (шлюз уже работает, SSH туннель). При необходимости остановите сервис или выберите другой порт.

Обнаружены дополнительные папки рабочей области

Если вы обновились со старых установок, у вас всё ещё может быть ~/openclaw на диске. Несколько директорий рабочей области могут вызвать путаницу с аутентификацией или состоянием, потому что активна только одна рабочая область.

Исправление: держите одну активную рабочую область и архивируйте/удалите остальные. Смотрите Agent workspace.

Основной чат работает в рабочей области песочницы

Симптомы: pwd или инструменты файлов показывают ~/.openclaw/sandboxes/..., хотя вы ожидали рабочую область хоста.

Почему: agents.defaults.sandbox.mode: "non-main" ключи от session.mainKey (по умолчанию "main"). Сессии групп/каналов используют свои собственные ключи, поэтому они рассматриваются как non-main и получают рабочие области песочницы.

Варианты исправления:

  • Если вы хотите рабочие области хоста для агента: установите agents.list[].sandbox.mode: "off".
  • Если вы хотите доступ к рабочей области хоста внутри песочницы: установите workspaceAccess: "rw" для этого агента.

"Агент был прерван"

Агент был прерван во время ответа.

Причины:

  • Пользователь отправил stop, abort, esc, wait или exit
  • Превышен таймаут
  • Процесс упал

Исправление: Просто отправьте другое сообщение. Сессия продолжается.

"Агент не удался перед ответом: Неизвестная модель: anthropic/claude-haiku-3-5"

OpenClaw намеренно отклоняет старые/небезопасные модели (особенно те, которые более уязвимы для prompt injection). Если вы видите эту ошибку, имя модели больше не поддерживается.

Исправление:

  • Выберите последнюю модель для провайдера и обновите вашу конфигурацию или алиас модели.
  • Если вы не уверены, какие модели доступны, запустите openclaw models list или openclaw models scan и выберите поддерживаемую.
  • Проверьте логи шлюза для подробной причины сбоя.

Смотрите также: Models CLI и Model providers.

Сообщения не срабатывают

Проверка 1: Находится ли отправитель в белом списке?

openclaw status

Ищите AllowFrom: ... в выводе.

Проверка 2: Для групповых чатов требуется ли упоминание?

# Сообщение должно совпадать с mentionPatterns или явными упоминаниями; настройки по умолчанию находятся в группах/гильдиях каналов.
# Мульти-агент: `agents.list[].groupChat.mentionPatterns` переопределяет глобальные шаблоны.
grep -n "agents\\|groupChat\\|mentionPatterns\\|channels\\.whatsapp\\.groups\\|channels\\.telegram\\.groups\\|channels\\.imessage\\.groups\\|channels\\.discord\\.guilds" \
  "${OPENCLAW_CONFIG_PATH:-$HOME/.openclaw/openclaw.json}"

Проверка 3: Проверьте логи

openclaw logs --follow
# или если вы хотите быстрые фильтры:
tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)" | grep "blocked\\|skip\\|unauthorized"

Код сопряжения не приходит

Если dmPolicy — это pairing, неизвестные отправители должны получить код, и их сообщение игнорируется до одобрения.

Проверка 1: Уже ждёт ожидающий запрос?

openclaw pairing list <channel>

Ожидающие запросы сопряжения DM ограничены 3 на канал по умолчанию. Если список полон, новые запросы не сгенерируют код, пока один не будет одобрен или не истечёт.

Проверка 2: Был ли создан запрос, но ответ не был отправлен?

openclaw logs --follow | grep "pairing request"

Проверка 3: Подтвердите, что dmPolicy не open/allowlist для этого канала.

Изображение + Упоминание не работает

Известная проблема: Когда вы отправляете изображение с ТОЛЬКО упоминанием (без другого текста), WhatsApp иногда не включает метаданные упоминания.

Обходной путь: Добавьте какой-то текст с упоминанием:

  • ❌ @openclaw + изображение
  • ✅ @openclaw проверь это + изображение

Сессия не возобновляется

Проверка 1: Файл сессии там?

ls -la ~/.openclaw/agents/<agentId>/sessions/

Проверка 2: Окно сброса слишком короткое?

{
  "session": {
    "reset": {
      "mode": "daily",
      "atHour": 4,
      "idleMinutes": 10080  // 7 дней
    }
  }
}

Проверка 3: Кто-то отправил /new, /reset или триггер сброса?

Таймаут агента

Таймаут по умолчанию 30 минут. Для длинных задач:

{
  "reply": {
    "timeoutSeconds": 3600  // 1 час
  }
}

Или используйте инструмент process для фоновых длинных команд.

WhatsApp отключён

# Проверьте локальный статус (creds, сессии, очередь событий)
openclaw status
# Пробуйте работающий шлюз + каналы (WA подключение + Telegram + Discord API)
openclaw status --deep

# Просмотрите недавние события подключения
openclaw logs --limit 200 | grep "connection\\|disconnect\\|logout"

Исправление: Обычно переподключается автоматически, как только Шлюз работает. Если вы застряли, перезапустите процесс Шлюза (как бы вы его ни контролировали), или запустите его вручную с подробным выводом:

openclaw gateway --verbose

Если вы вышли / отключились:

openclaw channels logout
trash "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/credentials" # если logout не может чисто всё удалить
openclaw channels login --verbose       # повторное сканирование QR

Отправка медиа не удаётся

Проверка 1: Путь к файлу действителен?

ls -la /path/to/your/image.jpg

Проверка 2: Слишком большой?

  • Изображения: макс 6MB
  • Аудио/Видео: макс 16MB
  • Документы: макс 100MB

Проверка 3: Проверьте логи медиа

grep "media\\|fetch\\|download" "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)" | tail -20

Высокое использование памяти

OpenClaw хранит историю разговоров в памяти.

Исправление: Периодически перезапускайте или установите лимиты сессии:

{
  "session": {
    "historyLimit": 100  // Макс сообщений для хранения
  }
}

Общее устранение неполадок

"Шлюз не запускается — конфигурация недействительна"

OpenClaw теперь отказывается запускаться, когда конфигурация содержит неизвестные ключи, искажённые значения или недопустимые типы. Это намеренно для безопасности.

Исправьте это с помощью Doctor:

openclaw doctor
openclaw doctor --fix

Примечания:

  • openclaw doctor сообщает о каждой недопустимой записи.
  • openclaw doctor --fix применяет миграции/ремонт и перезаписывает конфигурацию.
  • Диагностические команды, такие как openclaw logs, openclaw health, openclaw status, openclaw gateway status и openclaw gateway probe, всё ещё работают, даже если конфигурация недействительна.

"Все модели не удались" — что мне проверить сначала?

  • Учётные данные присутствуют для провайдера(ов), которые пытаются (профили аутентификации + env vars).
  • Маршрутизация модели: подтвердите, что agents.defaults.model.primary и резервные варианты — это модели, к которым у вас есть доступ.
  • Логи шлюза в /tmp/openclaw/… для точной ошибки провайдера.
  • Статус модели: используйте /model status (чат) или openclaw models status (CLI).

Я работаю на своём личном номере WhatsApp — почему self-chat странный?

Включите режим self-chat и добавьте в белый список свой собственный номер:

{
  channels: {
    whatsapp: {
      selfChatMode: true,
      dmPolicy: "allowlist",
      allowFrom: ["+15555550123"]
    }
  }
}

Смотрите WhatsApp setup.

WhatsApp вышел из системы. Как мне переаутентифицироваться?

Запустите команду входа снова и отсканируйте QR код:

openclaw channels login

Ошибки сборки на main — какой стандартный путь исправления?

  1. git pull origin main && pnpm install
  2. openclaw doctor
  3. Проверьте проблемы GitHub или Discord
  4. Временное обходное решение: проверьте более старый коммит

npm install терпит неудачу (allow-build-scripts / отсутствует tar или yargs). Что теперь?

Если вы работаете из исходников, используйте менеджер пакетов репозитория: pnpm (предпочтительно). Репозиторий объявляет packageManager: "pnpm@…".

Типичное восстановление:

git status   # убедитесь, что вы в корне репозитория
pnpm install
pnpm build
openclaw doctor
openclaw gateway restart

Почему: pnpm — это настроенный менеджер пакетов для этого репозитория.

Как переключаться между git установками и npm установками?

Используйте установщик сайта и выберите метод установки с флагом. Он обновляется на месте и перезаписывает сервис шлюза, чтобы указывать на новую установку.

Переключение на git install:

curl -fsSL https://openclaw.bot/install.sh | bash -s -- --install-method git --no-onboard

Переключение на npm global:

curl -fsSL https://openclaw.bot/install.sh | bash

Примечания:

  • Поток git перебазируется только если репозиторий чист. Сначала закоммитьте или спрячьте изменения.
  • После переключения запустите: 
    openclaw doctor
openclaw gateway restart

Блочная потоковая передача Telegram не разделяет текст между вызовами инструментов. Почему?

Блочная потоковая передача отправляет только завершённые текстовые блоки. Общие причины, почему вы видите одно сообщение:

  • agents.defaults.blockStreamingDefault всё ещё "off".
  • channels.telegram.blockStreaming установлен в false.
  • channels.telegram.streamMode — это partial или block и активна потоковая передача черновика (личный чат + темы). Потоковая передача черновика отключает блочную потоковую передачу в этом случае.
  • Ваши настройки minChars / coalesce слишком высоки, поэтому куски объединяются.
  • Модель выдаёт один большой текстовый блок (без точек сброса в середине ответа).

Контрольный список исправлений:

  1. Поместите настройки блочной потоковой передачи под agents.defaults, а не в корень.
  2. Установите channels.telegram.streamMode: "off", если вы хотите реальные многосообщенческие блочные ответы.
  3. Используйте меньшие пороги кусков/coalesce при отладке.

Смотрите Streaming.

Discord не отвечает на моём сервере даже с requireMention: false. Почему?

requireMention контролирует только управление упоминаниями после того, как канал проходит белые списки. По умолчанию channels.discord.groupPolicy — allowlist, поэтому гильдии должны быть явно включены. Если вы установите channels.discord.guilds.<guildId>.channels, разрешены только перечисленные каналы; опустите это для разрешения всех каналов в гильдии.

Контрольный список исправлений:

  1. Установите channels.discord.groupPolicy: "open" или добавьте запись белого списка гильдии (и опционально белый список каналов).
  2. Используйте числовые ID каналов в channels.discord.guilds.<guildId>.channels.
  3. Поместите requireMention: false под channels.discord.guilds (глобально или для каждого канала). channels.discord.requireMention верхнего уровня не является поддерживаемым ключом.
  4. Убедитесь, что бот имеет Message Content Intent и разрешения канала.
  5. Запустите openclaw channels status --probe для подсказок аудита.

Документы: Discord, Channels troubleshooting.

Ошибка API Cloud Code Assist: недопустимая схема инструмента (400). Что теперь?

Это почти всегда проблема совместимости схемы инструмента. Конечная точка Cloud Code Assist принимает строгое подмножество JSON Schema. OpenClaw очищает/нормализует схемы инструментов в текущем main, но исправление ещё не в последнем релизе (по состоянию на 13 января 2026).

Контрольный список исправлений:

  1. Обновите OpenClaw:
    • Если вы можете запускать из исходников, потяните main и перезапустите шлюз.
    • В противном случае дождитесь следующего релиза, который включает очиститель схем.
  2. Избегайте неподдерживаемых ключевых слов, таких как anyOf/oneOf/allOf, patternProperties, additionalProperties, minLength, maxLength, format и т.д.
  3. Если вы определяете пользовательские инструменты, держите схему верхнего уровня как type: "object" с properties и простыми перечислениями.

Смотрите Tools и TypeBox schemas.

Специфичные проблемы macOS

Приложение вылетает при предоставлении разрешений (речь/микрофон)

Если приложение исчезает или показывает "Abort trap 6", когда вы нажимаете "Разрешить" на запросе конфиденциальности:

Исправление 1: Сброс кеша TCC

tccutil reset All bot.molt.mac.debug

Исправление 2: Принудительный новый Bundle ID Если сброс не работает, измените BUNDLE_ID в scripts/package-mac-app.sh (например, добавьте суффикс .test) и пересоберите. Это заставляет macOS рассматривать его как новое приложение.

Шлюз застрял на "Starting..."

Приложение подключается к локальному шлюзу на порту 18789. Если оно остаётся застрявшим:

Исправление 1: Остановите супервизор (предпочтительно) Если шлюз контролируется launchd, убийство PID просто возродит его. Сначала остановите супервизор:

openclaw gateway status
openclaw gateway stop
# Или: launchctl bootout gui/$UID/bot.molt.gateway (замените на bot.molt.<profile>; legacy com.openclaw.* всё ещё работает)

Исправление 2: Порт занят (найдите слушателя)

lsof -nP -iTCP:18789 -sTCP:LISTEN

Если это неконтролируемый процесс, попробуйте изящную остановку сначала, затем эскалацию:

kill -TERM <PID>
sleep 1
kill -9 <PID> # последнее средство

Исправление 3: Проверьте установку CLI Убедитесь, что глобальный CLI openclaw установлен и соответствует версии приложения:

openclaw --version
npm install -g openclaw@<version>

Режим отладки

Получите подробное логирование:

# Включите трассировочное логирование в конфигурации:
#   ${OPENCLAW_CONFIG_PATH:-$HOME/.openclaw/openclaw.json} -> { logging: { level: "trace" } }
#
# Затем запустите подробные команды для зеркалирования вывода отладки в stdout:
openclaw gateway --verbose
openclaw channels login --verbose

Расположения логов

ЛогРасположение
Файловые логи шлюза (структурированные)/tmp/openclaw/openclaw-YYYY-MM-DD.log (или logging.file)
Логи сервиса шлюза (супервизор)macOS: $OPENCLAW_STATE_DIR/logs/gateway.log + gateway.err.log (по умолчанию: ~/.openclaw/logs/...; профили используют ~/.openclaw-<profile>/logs/...)
Linux: journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager
Windows: schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST
Файлы сессий$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/
Кеш медиа$OPENCLAW_STATE_DIR/media/
Учётные данные$OPENCLAW_STATE_DIR/credentials/

Проверка работоспособности

# Супервизор + цель пробы + пути конфигурации
openclaw gateway status
# Включить сканирования на уровне системы (legacy/extra сервисы, слушатели портов)
openclaw gateway status --deep

# Доступен ли шлюз?
openclaw health --json
# Если терпит неудачу, перезапустите с деталями подключения:
openclaw health --verbose

# Слушает ли что-то на порту по умолчанию?
lsof -nP -iTCP:18789 -sTCP:LISTEN

# Недавняя активность (хвост RPC лога)
openclaw logs --follow
# Резерв, если RPC не работает
tail -20 /tmp/openclaw/openclaw-*.log

Сброс всего

Ядерная опция:

openclaw gateway stop
# Если вы установили сервис и хотите чистую установку:
# openclaw gateway uninstall

trash "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
openclaw channels login         # повторное сопряжение WhatsApp
openclaw gateway restart           # или: openclaw gateway

⚠️ Это теряет все сессии и требует повторного сопряжения WhatsApp.

Получение помощи

  1. Сначала проверьте логи: /tmp/openclaw/ (по умолчанию: openclaw-YYYY-MM-DD.log, или ваш настроенный logging.file)
  2. Ищите существующие проблемы на GitHub
  3. Откройте новую проблему с:
    • Версией OpenClaw
    • Релевантными фрагментами логов
    • Шагами для воспроизведения
    • Вашей конфигурацией (редактируйте секреты!)

"Вы пробовали выключить и снова включить?" — Каждый IT-специалист

🦞🔧

Браузер не запускается (Linux)

Если вы видите "Failed to start Chrome CDP on port 18800":

Наиболее вероятная причина: Snap-упакованный Chromium на Ubuntu.

Быстрое исправление: Установите Google Chrome вместо этого:

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb

Затем установите в конфигурации:

{
  "browser": {
    "executablePath": "/usr/bin/google-chrome-stable"
  }
}

Полное руководство: Смотрите browser-linux-troubleshooting

← Назад к документации