Помощь

ЧаВо

Быстрые ответы плюс глубокое устранение неполадок для реальных сценариев (локальная разработка, VPS, мульти-агент, OAuth/API-ключи, отказоустойчивость моделей). Для диагностики во время выполнения см. Устранение неполадок. Для полного справочника по конфигурации см. Конфигурация.

Содержание

Первые 60 секунд, если что-то сломалось

  1. Быстрый статус (первая проверка)

    Копировать

    openclaw status

    Быстрая локальная сводка: ОС + обновление, доступность шлюза/службы, агенты/сессии, конфигурация провайдера + проблемы среды выполнения (когда шлюз доступен).

  2. Отчёт для вставки (безопасно делиться)

    Копировать

    openclaw status --all

    Диагностика только для чтения с хвостом логов (токены скрыты).

  3. Состояние демона + порта

    Копировать

    openclaw gateway status

    Показывает среду выполнения супервизора vs доступность RPC, целевой URL пробы и какой конфиг, вероятно, использовала служба.

  4. Глубокие пробы

    Копировать

    openclaw status --deep

    Запускает проверки здоровья шлюза + пробы провайдеров (требуется доступный шлюз). См. Здоровье.

  5. Хвост последнего лога

    Копировать

    openclaw logs --follow

    Если RPC не работает, откатиться на:

    Копировать

    tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"

    Файловые логи отделены от логов службы; см. Логирование и Устранение неполадок.

  6. Запустить доктора (исправления)

    Копировать

    openclaw doctor

    Исправляет/мигрирует конфиг/состояние + запускает проверки здоровья. См. Доктор.

  7. Снимок состояния Gateway

    Копировать

    openclaw health --json
openclaw health --verbose   # показывает целевой URL + путь к конфигу при ошибках

    Запрашивает у запущенного шлюза полный снимок состояния (только WS). См. Здоровье.

Быстрый старт и первоначальная настройка

Я застрял, какой самый быстрый способ выбраться

Используйте локального ИИ-агента, который может видеть вашу машину. Это гораздо эффективнее, чем спрашивать в Discord, потому что большинство случаев “я застрял” - это локальные проблемы конфигурации или окружения, которые удалённые помощники не могут проверить.

Эти инструменты могут читать репозиторий, выполнять команды, проверять логи и помогать исправлять настройки на уровне машины (PATH, службы, разрешения, файлы аутентификации). Дайте им полную локальную копию исходников через хакабельную (git) установку:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

Это устанавливает OpenClaw из git-репозитория, так что агент может читать код + документацию и рассуждать о точной версии, которую вы запускаете. Вы всегда можете вернуться к стабильной версии позже, повторно запустив установщик без --install-method git. Совет: попросите агента спланировать и проконтролировать исправление (шаг за шагом), затем выполните только необходимые команды. Это сохраняет изменения небольшими и более лёгкими для проверки. Если вы обнаружили настоящий баг или исправление, пожалуйста, создайте issue на GitHub или отправьте PR: https://github.com/openclaw/openclaw/issues https://github.com/openclaw/openclaw/pulls Начните с этих команд (делитесь выводом, когда просите помощи):

openclaw status
openclaw models status
openclaw doctor

Что они делают:

  • openclaw status: быстрый снимок состояния шлюза/агента + базовая конфигурация.
  • openclaw models status: проверяет аутентификацию провайдера + доступность моделей.
  • openclaw doctor: проверяет и исправляет распространённые проблемы конфигурации/состояния.