Перейти к основному содержанию

​
FAQ

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

​
Содержание

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

  1. Быстрый статус (первая проверка) 
    openclaw status
    Быстрое локальное резюме: ОС + обновления, доступность gateway/сервиса, агенты/сеансы, конфигурация провайдеров + проблемы выполнения (когда gateway доступен).
  2. Отчёт, который можно вставить (безопасен для шаринга) 
    openclaw status --all
    Диагностика только для чтения с хвостом логов (токены скрыты).
  3. Состояние демона и портов 
    openclaw gateway status
    Показывает состояние supervisor vs доступность RPC, целевой URL probe и какой конфиг, вероятно, использовал сервис.
  4. Глубокие проверки 
    openclaw status --deep
    Запускает проверки здоровья gateway + проверки провайдеров (требуется доступный gateway). См. Health.
  5. Хвост последнего лога 
    openclaw logs --follow
    Если RPC недоступен, используйте: 
    tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"
    Файловые логи отделены от логов сервиса; см. Logging и Troubleshooting.
  6. Запуск doctor (ремонт) 
    openclaw doctor
    Ремонт/миграция конфига/состояния + проверки здоровья. См. Doctor.
  7. Снимок Gateway 
    openclaw health --json
openclaw health --verbose   # shows the target URL + config path on errors
    Запрашивает у работающего gateway полный снимок (только WS). См. Health.

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

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

Используйте локальный AI‑агент, который может видеть вашу машину. Это гораздо эффективнее, чем просить помощи в Discord, потому что большинство случаев «я застрял» — это проблемы локальной конфигурации или окружения, которые удалённые помощники не могут проверить. Эти инструменты могут читать репозиторий, выполнять команды, просматривать логи и помогать исправлять настройку на уровне машины (PATH, сервисы, права, файлы аутентификации). Дайте им полный исходный код через hackable (git) установку: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
Это устанавливает OpenClaw из git‑чекаута, чтобы агент мог читать код и документацию и понимать точную версию, которую вы используете. Вы всегда можете вернуться к стабильной версии, повторно запустив установщик без --install-method git. Совет: попросите агента составить план и контролировать исправление (шаг за шагом), а затем выполнить только необходимые команды. Так изменения будут минимальными и их проще проверить. Если вы нашли реальный баг или исправление, пожалуйста, создайте issue или PR: https://github.com/openclaw/openclaw/issues
https://github.com/openclaw/openclaw/pulls Начните с этих команд (делитесь выводом при запросе помощи): 
openclaw status
openclaw models status
openclaw doctor
Что они делают:
  • openclaw status: быстрый снимок состояния gateway/агента + базовая конфигурация.
  • openclaw models status: проверяет авторизацию провайдеров + доступность моделей.
  • openclaw doctor: проверяет и исправляет распространённые проблемы конфигурации/состояния.
Другие полезные проверки CLI: openclaw status --all, openclaw logs --follow, openclaw gateway status, openclaw health --verbose. Быстрый цикл отладки: Первые 60 секунд, если что‑то сломалось.
Документация по установке: Install, Installer flags, Updating.

​
Какой рекомендуемый способ установки и настройки OpenClaw?

Репозиторий рекомендует запуск из исходного кода и использование мастера онбординга: 
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
Мастер также может автоматически собрать UI‑ресурсы. После онбординга Gateway обычно запускается на порту 18789. Из исходников (для контрибьюторов/dev): 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build # auto-installs UI deps on first run
openclaw onboard
Если у вас ещё нет глобальной установки, запустите через pnpm openclaw onboard.

​
Как открыть панель управления после онбординга?

Мастер открывает браузер с чистым (без токена в URL) адресом панели сразу после онбординга и также печатает ссылку в сводке. Оставьте эту вкладку открытой; если она не запустилась, скопируйте напечатанный URL на той же машине.

​
Как аутентифицировать панель управления (токен) на localhost и удалённо?

Localhost (та же машина):
  • Откройте http://127.0.0.1:18789/.
  • Если запрашивается авторизация, вставьте токен из gateway.auth.token (или OPENCLAW_GATEWAY_TOKEN) в настройках Control UI.
  • Получить токен на хосте gateway: openclaw config get gateway.auth.token (или сгенерировать: openclaw doctor --generate-gateway-token).
Не на localhost:
  • Tailscale Serve (рекомендуется): оставьте bind loopback, запустите openclaw gateway --tailscale serve, откройте https://<magicdns>/. Если gateway.auth.allowTailscale равно true, заголовки идентичности удовлетворяют auth (токен не нужен).
  • Tailnet bind: запустите openclaw gateway --bind tailnet --token "<token>", откройте http://<tailscale-ip>:18789/, вставьте токен в настройках панели.
  • SSH‑туннель: ssh -N -L 18789:127.0.0.1:18789 user@host, затем откройте http://127.0.0.1:18789/ и вставьте токен.
См. Dashboard и Web surfaces для деталей bind‑режимов и авторизации.

​
Какое окружение выполнения требуется?

Требуется Node >= 22. Рекомендуется pnpm. Bun не рекомендуется для Gateway.

​
Работает ли это на Raspberry Pi?

Да. Gateway лёгкий — документация указывает 512MB–1GB RAM, 1 ядро и около 500MB диска как достаточные для личного использования. Raspberry Pi 4 может его запускать. Для дополнительного запаса (логи, медиа, другие сервисы) рекомендуется 2GB RAM, но это не жёсткий минимум. Совет: маленький Pi/VPS может хостить Gateway, а вы можете подключать узлы (nodes) на ноутбуке/телефоне для локального экрана/камеры/выполнения команд. См. Nodes.

​
Есть ли советы по установке на Raspberry Pi?

Коротко: работает, но возможны шероховатости.
  • Используйте 64‑битную ОС и Node >= 22.
  • Предпочитайте hackable (git) установку, чтобы видеть логи и быстро обновляться.
  • Начните без каналов/skills, затем добавляйте по одному.
  • Если возникают странные проблемы с бинарниками — обычно это ARM‑совместимость.
Документация: Linux, Install.

​
Застряло на «wake up my friend» / онбординг не запускается. Что делать?

Этот экран зависит от доступности и аутентификации Gateway. TUI также автоматически отправляет «Wake up, my friend!» при первом запуске. Если вы видите эту строку без ответа и токены остаются 0, агент не запустился.
  1. Перезапустите Gateway:
openclaw gateway restart
  1. Проверьте статус + авторизацию:
openclaw status
openclaw models status
openclaw logs --follow
  1. Если всё ещё зависает:
openclaw doctor
Если Gateway удалённый, убедитесь, что туннель/Tailscale соединение активно и UI указывает на правильный Gateway. См. Remote access.

​
Можно ли перенести установку на новую машину (Mac mini) без повторного онбординга?

Да. Скопируйте директорию состояния и workspace, затем один раз запустите Doctor. Это сохранит вашего бота «как есть» (память, историю сессий, авторизацию и состояние каналов), если вы копируете оба местоположения:
  1. Установите OpenClaw на новой машине.
  2. Скопируйте $OPENCLAW_STATE_DIR (по умолчанию: ~/.openclaw) со старой машины.
  3. Скопируйте workspace (по умолчанию: ~/.openclaw/workspace).
  4. Запустите openclaw doctor и перезапустите сервис Gateway.
Это сохранит конфигурацию, профили авторизации, WhatsApp creds, сессии и память. В удалённом режиме помните: хост Gateway владеет хранилищем сессий и workspace. Важно: если вы коммитите только workspace в GitHub, вы сохраняете память + bootstrap‑файлы, но не историю сессий или авторизацию. Они находятся в ~/.openclaw/ (например, ~/.openclaw/agents/<agentId>/sessions/). Связано: Migrating, Where things live on disk, Agent workspace, Doctor, Remote mode.

​
Где посмотреть, что нового в последней версии?

Смотрите changelog на GitHub:
https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md Новые записи находятся вверху. Если верхний раздел помечен как Unreleased, следующий датированный раздел — последняя выпущенная версия. Записи сгруппированы по Highlights, Changes и Fixes.

​
Я не могу открыть docs.openclaw.ai (ошибка SSL). Что делать?

Некоторые подключения Comcast/Xfinity ошибочно блокируют docs.openclaw.ai через Xfinity Advanced Security. Отключите её или добавьте docs.openclaw.ai в allowlist, затем попробуйте снова. Подробнее: Troubleshooting.
Помогите разблокировать сайт, сообщив здесь: https://spa.xfinity.com/check_url_status Если сайт всё ещё недоступен, документация зеркалируется на GitHub:
https://github.com/openclaw/openclaw/tree/main/docs

​
В чём разница между stable и beta?

Stable и beta — это npm dist‑tags, а не разные ветки кода:
  • latest = stable
  • beta = ранняя сборка для тестирования
Мы публикуем сборки в beta, тестируем их, и когда они стабильны, продвигаем ту же версию в latest. Поэтому beta и stable могут указывать на одну и ту же версию. См. изменения:
https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

​
Как установить beta‑версию и чем beta отличается от dev?

Beta — npm dist‑tag beta (может совпадать с latest).
Dev — текущая ветка main (git); при публикации используется dist‑tag dev. Однострочные команды (macOS/Linux): 
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git
Установщик для Windows (PowerShell):
https://openclaw.ai/install.ps1 Подробнее: Development channels и Installer flags.

​
Сколько обычно занимает установка и онбординг?

Ориентировочно:
  • Установка: 2–5 минут
  • Онбординг: 5–15 минут в зависимости от количества каналов/моделей
Если зависло, используйте Installer stuck и быстрый цикл отладки в Im stuck.

​
Как попробовать самые свежие изменения?

Два варианта:
  1. Dev‑канал (git checkout):
openclaw update --channel dev
  1. Hackable установка (через install‑скрипт):
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
Или вручную: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
Документация: Update, Development channels, Install.

​
Установщик завис? Как получить больше информации?

Перезапустите установщик с подробным выводом: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose
Beta + verbose: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta --verbose
Hackable (git) + verbose: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose
Windows (PowerShell): 
# install.ps1 has no dedicated -Verbose flag yet.
Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0
Подробнее: Installer flags.

​
В Windows при установке пишет git not found или openclaw не распознан

Две распространённые проблемы: 1) npm error spawn git / git not found
  • Установите Git for Windows и убедитесь, что git в PATH.
  • Закройте и снова откройте PowerShell, затем повторите установку.
2) openclaw is not recognized
  • Папка npm global bin не в PATH.
  • Проверьте: 
    npm config get prefix
  • Убедитесь, что <prefix>\bin в PATH (обычно %AppData%\npm).
  • Перезапустите PowerShell после изменения PATH.
Для наиболее стабильной работы в Windows используйте WSL2.
Документация: Windows.

​
Документация не ответила на мой вопрос — как получить лучший ответ?

Используйте hackable (git) установку, чтобы иметь полный исходный код и документацию локально, затем задайте вопрос своему боту (или Claude/Codex) из этой папки — он сможет читать репозиторий и отвечать точно. 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
Подробнее: Install, Installer flags.
(Остальная часть документации сохранена по структуре и логике английского источника, с корректными код‑блоками, inline‑кодом для <id>, <token>, <profile>, <provider>, <agentId> и другими плейсхолдерами, без неэкранированных угловых скобок или фигурных скобок вне code‑контекста.)