> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Часто задаваемые вопросы: первоначальная настройка

Краткое руководство и вопросы и ответы о первом запуске. Сведения о повседневной эксплуатации, моделях, аутентификации, сеансах
и устранении неполадок см. в основном разделе [часто задаваемых вопросов](https://docs2.openclaw.ai/ru/help/faq.md).

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

> [accordion] Я не могу продолжить: как быстрее всего решить проблему
>
> Используйте локального ИИ-агента, который может **видеть ваш компьютер**. Большинство случаев «я не могу продолжить»
> вызваны **проблемами локальной конфигурации или окружения**, которые удалённый помощник не может проверить, поэтому этот способ эффективнее,
> чем обращение в Discord.
>
> * **Claude Code**: [https://www.anthropic.com/claude-code/](https://www.anthropic.com/claude-code/)
> * **OpenAI Codex**: [https://openai.com/codex/](https://openai.com/codex/)
>
> Предоставьте агенту полный исходный код через изменяемую установку (git), чтобы он мог изучить
> код и документацию и учесть точную используемую вами версию:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git
> ```
>
> Попросите агента пошагово спланировать и проконтролировать исправление, а затем выполнить только
> необходимые команды — небольшие изменения проще проверять.
>
> При обращении за помощью (в Discord или в задаче GitHub) предоставьте результаты следующих команд:
>
> | Команда | Что показывает |
> | - | - |
> | `openclaw status` | Состояние Gateway/агента и основной снимок конфигурации |
> | `openclaw status --all` | Полная диагностика только для чтения, которую можно вставить в сообщение |
> | `openclaw models status` | Аутентификация провайдера и доступность моделей |
> | `openclaw doctor` | Проверяет и исправляет распространённые проблемы конфигурации и состояния |
> | `openclaw logs --follow` | Поток журналов в реальном времени |
> | `openclaw gateway status --deep` | Углублённая проверка состояния Gateway, конфигурации и плагинов |
> | `openclaw health --verbose` | Подробный отчёт о состоянии |
>
> Нашли настоящую ошибку или исправление? Создайте задачу или отправьте PR:
> [Задачи](https://github.com/openclaw/openclaw/issues) /
> [Запросы на включение изменений](https://github.com/openclaw/openclaw/pulls).
>
> Быстрый цикл отладки: [Первые 60 секунд при возникновении неполадки](https://docs2.openclaw.ai/ru/help/faq.md#first-60-seconds-if-something-is-broken).
> Документация по установке: [Установка](https://docs2.openclaw.ai/ru/install.md), [Флаги установщика](https://docs2.openclaw.ai/ru/install/installer.md), [Обновление](https://docs2.openclaw.ai/ru/install/updating.md).

> [accordion] Heartbeat постоянно пропускается. Что означают причины пропуска?
>
> | Причина пропуска | Значение |
> | - | - |
> | `quiet-hours` | За пределами настроенного периода активности |
> | `empty-heartbeat-file` | Файл `HEARTBEAT.md` существует, но содержит только пустые строки, комментарии, заголовки, ограждения блоков или заготовку пустого списка задач |
> | `no-tasks-due` | Режим задач активен, но время выполнения следующего интервала ещё не наступило |
> | `alerts-disabled` | Вся видимость Heartbeat отключена (`showOk`, `showAlerts` и `useIndicator` отключены) |
>
> В режиме задач сроки следующего выполнения сдвигаются только после завершения фактического запуска Heartbeat.
> Пропущенные запуски не отмечают задачи как выполненные.
>
> Документация: [Heartbeat](https://docs2.openclaw.ai/ru/gateway/heartbeat.md), [Автоматизация](https://docs2.openclaw.ai/ru/automation.md).

> [accordion] Рекомендуемый способ установки и настройки OpenClaw
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
> openclaw onboard --install-daemon
> ```
>
> Из исходного кода (для участников разработки и разработчиков):
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> git clone https://github.com/openclaw/openclaw.git
> cd openclaw
> pnpm install
> pnpm build
> pnpm ui:build
> openclaw onboard
> ```
>
> Глобальная установка ещё не выполнена? Вместо этого запустите `pnpm openclaw onboard`. Если ресурсы Control UI
> отсутствуют, первоначальная настройка пытается собрать их самостоятельно, а при неудаче использует `pnpm ui:build`.

> [accordion] Как открыть панель управления после первоначальной настройки?
>
> Сразу после настройки процесс первоначальной настройки открывает в браузере чистый URL панели управления (без токена)
> и выводит эту ссылку в сводке. Не закрывайте вкладку; если она не открылась,
> скопируйте выведенный URL и вставьте его в браузер на том же компьютере.

> [accordion] Как пройти аутентификацию в панели управления локально и удалённо?
>
> **Локальный компьютер (тот же компьютер):**
>
> * Откройте `http://127.0.0.1:18789/`.
> * Если запрашивается аутентификация с общим секретом, вставьте настроенный токен или пароль в настройки Control UI.
> * Источник токена: `gateway.auth.token` (или `OPENCLAW_GATEWAY_TOKEN`).
> * Источник пароля: `gateway.auth.password` (или `OPENCLAW_GATEWAY_PASSWORD`).
> * Общий секрет ещё не настроен? Запустите `openclaw doctor --generate-gateway-token` (или `openclaw doctor --fix --generate-gateway-token`).
>
> **Не на локальном компьютере:**
>
> * **Tailscale Serve** (рекомендуется): оставьте привязку к loopback-интерфейсу, запустите `openclaw gateway --tailscale serve`, откройте `https://<magicdns>/`. При `gateway.auth.allowTailscale: true` заголовки идентификации обеспечивают аутентификацию Control UI/WebSocket (вставлять общий секрет не требуется; предполагается доверенный узел Gateway); для HTTP API по-прежнему требуется аутентификация с общим секретом, если только вы намеренно не используете приватный входящий трафик `none` или HTTP-аутентификацию доверенного прокси.
>   Одновременные попытки Serve с неверной аутентификацией от одного клиента выполняются последовательно, прежде чем ограничитель неудачной аутентификации зарегистрирует их, поэтому уже при второй неудачной попытке может отображаться `retry later`.
> * **Привязка к tailnet**: запустите `openclaw gateway --bind tailnet --token "<token>"` (или настройте аутентификацию по паролю), откройте `http://<tailscale-ip>:18789/`, вставьте соответствующий общий секрет в настройки панели управления.
> * **Обратный прокси с учётом идентификации**: оставьте Gateway за доверенным прокси, задайте `gateway.auth.mode: "trusted-proxy"`, откройте URL прокси. Для loopback-прокси на том же узле необходимо явно задать `gateway.auth.trustedProxy.allowLoopback: true`.
> * **Туннель SSH**: `ssh -N -L 18789:127.0.0.1:18789 user@gateway-host`, затем откройте `http://127.0.0.1:18789/`. В туннеле по-прежнему применяется аутентификация с общим секретом; при запросе вставьте настроенный токен или пароль.
>
> Сведения о режимах привязки и аутентификации см. в разделах [Панель управления](https://docs2.openclaw.ai/ru/web/dashboard.md) и [Веб-интерфейсы](https://docs2.openclaw.ai/ru/web.md).

> [accordion] Почему для подтверждений выполнения в чате существуют две конфигурации?
>
> Они управляют разными уровнями:
>
> * `approvals.exec` — перенаправляет запросы подтверждения в чаты.
> * `channels.<channel>.execApprovals` — делает этот канал нативным клиентом подтверждения выполнения.
>
> Политика выполнения на узле всё равно остаётся фактическим шлюзом подтверждений; конфигурация чата управляет только тем,
> где появляются запросы и как пользователи отвечают на них.
>
> Обычно обе конфигурации не нужны:
>
> * Если чат уже поддерживает команды и ответы, `/approve` в том же чате работает через общий механизм.
> * Когда поддерживаемый нативный канал может безопасно определить подтверждающих пользователей, OpenClaw автоматически включает нативные подтверждения с приоритетом личных сообщений, если `channels.<channel>.execApprovals.enabled` не задано или равно `"auto"`.
> * Когда доступны нативные карточки или кнопки подтверждения, этот интерфейс используется в первую очередь; упоминайте ручную команду `/approve` только в том случае, если результат инструмента сообщает, что подтверждения через чат недоступны.
> * Используйте `approvals.exec` только тогда, когда запросы также должны поступать в другие чаты или явно заданные операционные комнаты.
> * Используйте `channels.<channel>.execApprovals.target: "channel"` или `"both"` только тогда, когда запросы подтверждения нужно публиковать обратно в исходную комнату или тему.
> * Подтверждения плагинов обрабатываются отдельно: по умолчанию используется `/approve` в том же чате, можно включить перенаправление `approvals.plugin`, и лишь некоторые нативные каналы сохраняют нативную обработку и для таких подтверждений.
>
> Кратко: перенаправление отвечает за маршрутизацию, а конфигурация нативного клиента — за расширенный интерфейс с учётом особенностей канала.
> См. [Подтверждения выполнения](https://docs2.openclaw.ai/ru/tools/exec-approvals.md).

> [accordion] Какая среда выполнения нужна?
>
> Требуется Node **22.22.3+**, **24.15+** или **25.9+** (рекомендуется Node 24). `pnpm` — менеджер пакетов репозитория.
> Bun может устанавливать зависимости и запускать скрипты пакетов, но не может запускать CLI OpenClaw или Gateway, поскольку в нём отсутствует `node:sqlite`.

> [accordion] Работает ли OpenClaw на Raspberry Pi?
>
> Да, но сначала проверьте объём оперативной памяти: оптимальны Pi 5 и Pi 4 (2 GB+); Pi 3B+ (1 GB) работает, но медленно; Pi Zero 2 W (512 MB) не рекомендуется.
>
> | Модель | Оперативная память | Пригодность |
> | - | - | - |
> | Pi 5 | 4/8 GB | Отлично |
> | Pi 4 | 4 GB | Хорошо |
> | Pi 4 | 2 GB | Приемлемо, добавьте подкачку |
> | Pi 4 | 1 GB | На пределе |
> | Pi 3B+ | 1 GB | Медленно |
> | Pi Zero 2 W | 512 MB | Не рекомендуется |
>
> Абсолютный минимум: 1 GB оперативной памяти, 1 ядро, 500 MB свободного места на диске, 64-разрядная ОС. Поскольку Pi запускает только
> Gateway (модели обращаются к облачным API), даже устройство Pi со скромными характеристиками справляется с нагрузкой.
>
> Небольшое устройство Pi или VPS также может размещать только Gateway, а **узлы**
> на ноутбуке или телефоне можно связать с ним для локальной работы с экраном, камерой, холстом или выполнения команд. См. [Узлы](https://docs2.openclaw.ai/ru/nodes.md).
>
> Полное пошаговое руководство по настройке: [Raspberry Pi](https://docs2.openclaw.ai/ru/install/raspberry-pi.md).

> [accordion] Есть ли рекомендации по установке на Raspberry Pi?
>
> * Используйте **64-разрядную** ОС; не используйте 32-разрядную Raspberry Pi OS.
> * Добавьте подкачку на платах с 2 GB памяти или меньше.
> * Для производительности и долговечности предпочитайте **USB SSD**, а не SD-карту.
> * Предпочитайте изменяемую установку (git), чтобы просматривать журналы и быстро обновляться.
> * Начните без каналов и навыков, затем добавляйте их по одному.
> * Необычные ошибки двоичных файлов («exec format error») обычно означают, что для необязательного инструмента навыка отсутствует сборка ARM64.
>
> Полное руководство: [Raspberry Pi](https://docs2.openclaw.ai/ru/install/raspberry-pi.md). См. также [Linux](https://docs2.openclaw.ai/ru/platforms/linux.md).

> [accordion] Процесс завис на «wake up my friend» или первоначальная настройка не завершается. Что делать?
>
> Работа этого экрана зависит от доступности Gateway и успешной аутентификации. TUI также автоматически отправляет
> «Проснись, мой друг!» при первом запуске, если настроен провайдер модели. Если
> вы пропустили настройку модели или аутентификации, процесс первоначальной настройки показывает уведомление «Аутентификация модели отсутствует» и открывает
> TUI, ничего не отправляя, — добавьте провайдера с помощью `openclaw configure --section model`.
> Если отображается строка пробуждения, но **ответа нет**, а количество токенов остаётся равным 0, агент не запускался.
>
> 1. Перезапустите Gateway:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw gateway restart
> ```
>
> 2. Проверьте состояние и аутентификацию:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw status
> openclaw models status
> openclaw logs --follow
> ```
>
> 3. Всё ещё зависает? Выполните:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw doctor
> ```
>
> Если Gateway находится на удалённом компьютере, убедитесь, что туннель или подключение Tailscale активно, а интерфейс
> указывает на правильный Gateway. См. [Удалённый доступ](https://docs2.openclaw.ai/ru/gateway/remote.md).

> [accordion] Можно ли перенести настройку на новый компьютер без повторного прохождения первоначальной настройки?
>
> Да. Скопируйте **каталог состояния** и **рабочее пространство**, затем один раз запустите Doctor:
>
> 1. Установите OpenClaw на новом компьютере.
> 2. Скопируйте `$OPENCLAW_STATE_DIR` (по умолчанию: `~/.openclaw`) со старого компьютера.
> 3. Скопируйте рабочее пространство (по умолчанию: `~/.openclaw/workspace`).
> 4. Запустите `openclaw doctor` и перезапустите службу Gateway.
>
> При этом сохраняются конфигурация, профили аутентификации, учётные данные WhatsApp, сеансы и память —
> ваш бот остаётся точно таким же при условии, что вы скопировали **оба** расположения. В удалённом режиме
> хост Gateway является владельцем хранилища сеансов и рабочего пространства.
>
> **Важно:** если вы только фиксируете и отправляете рабочее пространство в GitHub, резервная копия включает
> **память и файлы начальной загрузки**, но не историю сеансов и данные аутентификации. Они находятся в
> `~/.openclaw/` (например, `~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite`).
>
> Связанные разделы: [Перенос](https://docs2.openclaw.ai/ru/install/migrating.md), [Расположение данных на диске](https://docs2.openclaw.ai/ru/help/faq.md#where-things-live-on-disk),
> [Рабочее пространство агента](https://docs2.openclaw.ai/ru/concepts/agent-workspace.md), [Doctor](https://docs2.openclaw.ai/ru/gateway/doctor.md),
> [Удалённый режим](https://docs2.openclaw.ai/ru/gateway/remote.md).

> [accordion] Где посмотреть, что нового в последней версии?
>
> Просмотрите журнал изменений на GitHub:
> [https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md](https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md)
>
> Самые новые записи находятся вверху. Если верхний раздел называется **Невыпущенное**, следующий раздел
> с датой соответствует последней выпущенной версии. Записи сгруппированы по разделам **Основные нововведения**, **Изменения**
> и **Исправления** (а при необходимости также по разделам документации и другим разделам).

> [accordion] Не удается получить доступ к docs.openclaw\.ai (ошибка SSL)
>
> Некоторые подключения Comcast/Xfinity ошибочно блокируют `docs.openclaw.ai` через Xfinity
> Advanced Security. Отключите эту функцию или добавьте `docs.openclaw.ai` в список разрешенных адресов, затем повторите попытку. Помогите нам
> снять блокировку: [https://spa.xfinity.com/check\_url\_status](https://spa.xfinity.com/check_url_status).
>
> Доступ по-прежнему заблокирован? Копия документации доступна на GitHub:
> [https://github.com/openclaw/openclaw/tree/main/docs](https://github.com/openclaw/openclaw/tree/main/docs)

> [accordion] Разница между стабильной и бета-версиями
>
> **Стабильная** и **бета-версия** — это **dist-теги npm**, а не отдельные ветки кода:
>
> * `latest` = стабильная версия
> * `beta` = ранняя сборка для тестирования (используется `latest`, если бета-версия отсутствует или старше текущего стабильного выпуска)
>
> Стабильный выпуск обычно сначала попадает в канал **beta**, после чего на отдельном этапе продвижения
> эта же версия переносится в `latest` без изменения номера версии. Сопровождающие
> также могут опубликовать выпуск напрямую в `latest`. Поэтому после продвижения бета- и стабильный каналы могут указывать на
> **одну и ту же версию**.
>
> Список изменений: [CHANGELOG.md](https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md).
>
> Однострочные команды установки и различия между beta и dev приведены в следующем раскрывающемся разделе.

> [accordion] Как установить бета-версию и чем beta отличается от dev?
>
> **Beta** — это dist-тег npm `beta` (после продвижения может совпадать с `latest`).
> **Dev** — изменяющаяся вершина ветки `main` (git); при публикации в npm используется dist-тег `dev`.
>
> Однострочные команды (macOS/Linux):
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta
> ```
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git
> ```
>
> Установщик для Windows (PowerShell): `iwr -useb https://openclaw.ai/install.ps1 | iex`
>
> Подробнее: [Каналы разработки](https://docs2.openclaw.ai/ru/install/development-channels.md) и [Флаги установщика](https://docs2.openclaw.ai/ru/install/installer.md).

> [accordion] Как опробовать самые свежие изменения?
>
> Есть два варианта:
>
> 1. **Канал dev (существующая установка):**
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw update --channel dev
> ```
>
> Эта команда переключает установку на рабочую копию git из `main`, выполняет rebase относительно вышестоящего репозитория, собирает проект и устанавливает
> CLI из этой рабочей копии.
>
> 2. **Изменяемая установка (git) на новом компьютере:**
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git
> ```
>
> Предпочтительный вариант — клонировать вручную:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> git clone https://github.com/openclaw/openclaw.git
> cd openclaw
> pnpm install
> pnpm build
> ```
>
> Документация: [Обновление](https://docs2.openclaw.ai/ru/cli/update.md), [Каналы разработки](https://docs2.openclaw.ai/ru/install/development-channels.md), [Установка](https://docs2.openclaw.ai/ru/install.md).

> [accordion] Сколько обычно занимают установка и первоначальная настройка?
>
> Примерные сроки:
>
> * **Установка:** 2–5 минут.
> * **Первоначальная настройка QuickStart:** несколько минут (локальный Gateway, автоматический токен, рабочая область по умолчанию).
> * **Расширенная/полная первоначальная настройка:** занимает больше времени, если требуются вход у провайдера, сопряжение канала, установка фоновой службы, загрузка данных по сети или дополнительная настройка Skills.
>
> Мастер заранее показывает эти сроки. Необязательные этапы можно пропустить и вернуться к ним позже с помощью
> `openclaw configure`.
>
> Процесс завис? См. раздел [Процесс завис](#quick-start-and-first-run-setup) выше.

> [accordion] Установщик завис? Как получить больше диагностической информации?
>
> Запустите его повторно с `--verbose`:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --verbose
> curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta --verbose
> curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose
> ```
>
> У `install.ps1` нет отдельного переключателя подробного вывода; вместо этого запустите его через `Set-PSDebug -Trace 1` /
> `-Trace 0`. Полный справочник флагов: [Флаги установщика](https://docs2.openclaw.ai/ru/install/installer.md).

> [accordion] При установке в Windows появляется сообщение git not found или openclaw not recognized
>
> Две распространенные проблемы в Windows:
>
> **1) Ошибка npm spawn git / git not found**
>
> * Установите **Git for Windows** и убедитесь, что `git` присутствует в PATH.
> * Закройте и снова откройте PowerShell, затем повторно запустите установщик.
>
> **2) После установки команда openclaw не распознается**
>
> * Глобальная папка исполняемых файлов npm отсутствует в PATH.
> * Проверьте ее: `npm config get prefix`.
> * Добавьте этот каталог в пользовательскую переменную PATH (суффикс `\bin` не требуется; в большинстве систем это `%AppData%\npm`).
> * Закройте и снова откройте PowerShell.
>
> Предпочитаете настольное приложение? Используйте **Windows Hub**. Для настройки только через терминал
> поддерживаются как установщик PowerShell, так и варианты Gateway в WSL2. Документация: [Windows](https://docs2.openclaw.ai/ru/platforms/windows.md).

> [accordion] В выводе exec в Windows китайский текст отображается некорректно — что делать?
>
> Обычно причина заключается в несовпадении кодовой страницы консоли в нативных оболочках Windows.
>
> Признаки: китайский текст в выводе `system.run`/`exec` отображается как нечитаемые символы, но та же команда
> выглядит нормально в другом профиле терминала.
>
> Обходное решение в PowerShell:
>
> ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
> chcp 65001
> [Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)
> [Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
> $OutputEncoding = [System.Text.UTF8Encoding]::new($false)
> ```
>
> Затем перезапустите Gateway и повторите попытку:
>
> ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw gateway restart
> ```
>
> Проблема по-прежнему воспроизводится в последней версии OpenClaw? Следите за ней или сообщите подробности: [Задача #30640](https://github.com/openclaw/openclaw/issues/30640).

> [accordion] В документации нет ответа на мой вопрос — как получить более точный ответ?
>
> Используйте изменяемую установку (git), чтобы полный исходный код и документация были доступны локально, а затем задайте вопрос
> своему боту (или Claude/Codex) **из этой папки**, чтобы он мог прочитать репозиторий и дать точный ответ.
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git
> ```
>
> Подробнее: [Установка](https://docs2.openclaw.ai/ru/install.md) и [Флаги установщика](https://docs2.openclaw.ai/ru/install/installer.md).

> [accordion] Как установить OpenClaw в Linux?
>
> * Быстрая установка в Linux и установка службы: [Linux](https://docs2.openclaw.ai/ru/platforms/linux.md).
> * Полное пошаговое руководство: [Начало работы](https://docs2.openclaw.ai/ru/start/getting-started.md).
> * Установщик и обновления: [Установка и обновления](https://docs2.openclaw.ai/ru/install/updating.md).

> [accordion] Как установить OpenClaw на VPS?
>
> Подойдет любой VPS с Linux. Установите OpenClaw на сервере, а затем подключайтесь к Gateway через SSH/Tailscale.
>
> Руководства: [exe.dev](https://docs2.openclaw.ai/ru/install/exe-dev.md), [Hetzner](https://docs2.openclaw.ai/ru/install/hetzner.md), [Fly.io](https://docs2.openclaw.ai/ru/install/fly.md).
> Удаленный доступ: [Удаленный доступ к Gateway](https://docs2.openclaw.ai/ru/gateway/remote.md).

> [accordion] Где находятся руководства по установке в облаке или на VPS?
>
> Раздел о хостинге с распространенными провайдерами:
>
> * [Хостинг на VPS](https://docs2.openclaw.ai/ru/vps.md) (все провайдеры в одном месте)
> * [Fly.io](https://docs2.openclaw.ai/ru/install/fly.md)
> * [Hetzner](https://docs2.openclaw.ai/ru/install/hetzner.md)
> * [exe.dev](https://docs2.openclaw.ai/ru/install/exe-dev.md)
>
> В облачной конфигурации **Gateway работает на сервере**, а вы подключаетесь к нему с ноутбука или телефона
> через Control UI (либо Tailscale/SSH). Ваше состояние и рабочая область хранятся на сервере, поэтому
> считайте хост основным источником данных и создавайте его резервные копии.
>
> Сопрягите **узлы** (Mac/iOS/Android/без графического интерфейса) с облачным Gateway, чтобы локально использовать
> экран, камеру, холст или выполнять команды на ноутбуке, пока Gateway остается
> в облаке.
>
> Раздел: [Платформы](https://docs2.openclaw.ai/ru/platforms.md). Удаленный доступ: [Удаленный доступ к Gateway](https://docs2.openclaw.ai/ru/gateway/remote.md).
> Узлы: [Узлы](https://docs2.openclaw.ai/ru/nodes.md), [CLI узлов](https://docs2.openclaw.ai/ru/cli/nodes.md).

> [accordion] Можно ли попросить OpenClaw обновить себя?
>
> Это возможно, но не рекомендуется. В процессе обновления Gateway может перезапуститься (что приведет к разрыву
> активного сеанса), может потребоваться чистая рабочая копия git и подтверждение.
> Безопаснее выполнять обновления из оболочки от имени оператора.
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw update
> openclaw update status
> openclaw update --channel stable|extended-stable|beta|dev
> openclaw update --tag <dist-tag|version>
> openclaw update --no-restart
> ```
>
> Автоматизация с помощью агента:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw update --yes --no-restart
> openclaw gateway restart
> ```
>
> Документация: [Обновление](https://docs2.openclaw.ai/ru/cli/update.md), [Обновление установки](https://docs2.openclaw.ai/ru/install/updating.md).

> [accordion] Что именно выполняется при первоначальной настройке?
>
> `openclaw onboard` — рекомендуемый способ настройки. В **локальном режиме** он проводит вас через следующие этапы:
>
> 1. **Модель/аутентификация** — OAuth провайдера, ключи API или ручная аутентификация (включая локальные варианты, например LM Studio); выбор модели по умолчанию.
> 2. **Рабочая область** — расположение и начальные файлы.
> 3. **Gateway** — порт, адрес привязки, режим аутентификации, публикация через Tailscale.
> 4. **Каналы** — встроенные каналы чата и каналы официальных плагинов: iMessage, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp и другие.
> 5. **Фоновая служба** — LaunchAgent (macOS), пользовательская служба systemd (Linux/WSL2) или нативная запланированная задача Windows.
> 6. **Проверка работоспособности** — запускает Gateway и проверяет, что он работает.
> 7. **Skills** — устанавливает рекомендуемые навыки и необязательные зависимости.
>
> Мастер заранее сообщает ожидаемую длительность и предупреждает, если настроенная модель неизвестна
> или отсутствуют данные аутентификации. Полное описание: [Первоначальная настройка (CLI)](https://docs2.openclaw.ai/ru/start/wizard.md).

> [accordion] Нужна ли подписка Claude или OpenAI для запуска?
>
> Нет. Запускайте OpenClaw с **ключами API** (Anthropic/OpenAI/других провайдеров) или **исключительно локальными моделями**,
> чтобы данные оставались на вашем устройстве. Подписки (Claude Pro/Max, ChatGPT/Codex) —
> необязательные способы аутентификации у этих провайдеров.
>
> Для Anthropic: **ключ API** предусматривает стандартную оплату по мере использования; **Claude CLI**
> повторно использует существующий вход Claude Code на том же хосте. В настоящее время Anthropic считает
> неинтерактивный путь `claude -p` в Claude CLI использованием Agent SDK/программным использованием,
> которое по-прежнему учитывается в лимитах вашего тарифного плана подписки — прежде чем полагаться на поведение подписки, проверьте актуальную документацию Anthropic
> по оплате. Для постоянно работающих хостов Gateway и общей
> автоматизации ключ API Anthropic является более предсказуемым выбором.
>
> OAuth OpenAI Codex (подписка ChatGPT/Codex) полностью поддерживается для моделей агентов.
> OpenClaw также поддерживает размещенные варианты по подписке, включая **Qwen Cloud
> Coding Plan**, **MiniMax Coding Plan** и **Z.AI / GLM Coding Plan**.
>
> Документация: [Anthropic](https://docs2.openclaw.ai/ru/providers/anthropic.md), [OpenAI](https://docs2.openclaw.ai/ru/providers/openai.md),
> [Qwen Cloud](https://docs2.openclaw.ai/ru/providers/qwen.md), [MiniMax](https://docs2.openclaw.ai/ru/providers/minimax.md), [Z.AI (GLM)](https://docs2.openclaw.ai/ru/providers/zai.md),
> [Локальные модели](https://docs2.openclaw.ai/ru/gateway/local-models.md), [Модели](https://docs2.openclaw.ai/ru/concepts/models.md).

> [accordion] Можно ли использовать подписку Claude Max без ключа API?
>
> Да. OpenClaw поддерживает повторное использование Claude CLI для планов Pro/Max/Team/Enterprise. В настоящее время Anthropic
> считает путь `claude -p`, который использует OpenClaw, использованием в рамках подписки,
> подпадающим под ограничения вашего плана, а не отдельной бесплатной квотой — актуальные сведения об оплате и ссылки на
> статьи службы поддержки Anthropic см. в разделе
> [Anthropic](https://docs2.openclaw.ai/ru/providers/anthropic.md). Для наиболее предсказуемой настройки на стороне сервера вместо этого используйте
> ключ API Anthropic.

> [accordion] Поддерживается ли аутентификация по подписке Claude (Claude Pro или Max)?
>
> Да, посредством повторного использования Claude CLI. Подход Anthropic к тарификации использования `claude -p`/Agent SDK
> со временем менялся; прежде чем полагаться на конкретный порядок
> тарификации, ознакомьтесь с актуальной информацией и датированными ссылками на статьи службы поддержки Anthropic в разделе [Anthropic](https://docs2.openclaw.ai/ru/providers/anthropic.md).
>
> Anthropic setup-token также по-прежнему поддерживается как способ аутентификации с помощью токена, но OpenClaw предпочитает
> повторное использование Claude CLI и `claude -p`, когда они доступны. Для производственных или многопользовательских
> нагрузок API-ключ Anthropic остаётся более безопасным и предсказуемым выбором. Другие
> размещённые варианты на основе подписки: [OpenAI](https://docs2.openclaw.ai/ru/providers/openai.md), [Qwen Cloud](https://docs2.openclaw.ai/ru/providers/qwen.md),
> [MiniMax](https://docs2.openclaw.ai/ru/providers/minimax.md), [Z.AI (GLM)](https://docs2.openclaw.ai/ru/providers/zai.md).

> [accordion] Почему Anthropic возвращает ошибку HTTP 429 rate\_limit\_error?
>
> Ваша **квота Anthropic или ограничение частоты запросов** исчерпаны для текущего периода. При использовании **Claude
> CLI** дождитесь сброса периода или перейдите на более высокий тариф. При использовании **API-ключа Anthropic**
> проверьте использование и оплату в Anthropic Console и при необходимости увеличьте лимиты.
>
> Если сообщение имеет вид `Extra usage is required for long context requests`,
> запрос пытается использовать контекстное окно Anthropic размером 1M (модель Claude 4.x
> с поддержкой 1M, доступную на уровне GA, либо устаревшую конфигурацию `params.context1m: true`), а ваши текущие учётные данные
> не позволяют оплачивать длинный контекст.
>
> Настройте **резервную модель**, чтобы OpenClaw продолжал отвечать, пока провайдер ограничивает частоту запросов.
> См. [Модели](https://docs2.openclaw.ai/ru/cli/models.md), [OAuth](https://docs2.openclaw.ai/ru/concepts/oauth.md) и
> [Для длинного контекста при ошибке Anthropic 429 требуется дополнительное использование](https://docs2.openclaw.ai/ru/gateway/troubleshooting.md#anthropic-429-extra-usage-required-for-long-context).

> [accordion] Поддерживается ли AWS Bedrock?
>
> Да. В OpenClaw встроен провайдер **Amazon Bedrock (Converse)**. При наличии переменных
> среды AWS (`AWS_ACCESS_KEY_ID`, `AWS_PROFILE`, `AWS_BEARER_TOKEN_BEDROCK`)
> OpenClaw автоматически включает неявный провайдер Bedrock для обнаружения моделей; в противном случае
> задайте `plugins.entries.amazon-bedrock.config.discovery.enabled: true` или добавьте запись
> провайдера вручную. См. [Amazon Bedrock](https://docs2.openclaw.ai/ru/providers/bedrock.md) и [Провайдеры моделей](https://docs2.openclaw.ai/ru/providers/models.md).
> Если вы предпочитаете управляемую работу с ключами, допустимым вариантом также остаётся OpenAI-совместимый прокси перед Bedrock.

> [accordion] Как работает аутентификация Codex?
>
> OpenClaw поддерживает **OpenAI Codex** через OAuth (вход в ChatGPT). При новой
> настройке без основной модели используется точно `openai/gpt-5.6-sol` для
> аутентификации по подписке ChatGPT/Codex и выполнения через нативный app-server Codex.
> При повторной аутентификации сохраняется явно заданная модель, включая
> `openai/gpt-5.5`. Если рабочее пространство Codex не предоставляет GPT-5.6, явно выберите
> `openai/gpt-5.5`; OpenClaw не выполняет неявный переход на менее новую модель. Устаревшие
> ссылки на модели с префиксом Codex относятся к устаревшей конфигурации, которую исправляет `openclaw doctor     --fix`. Прямой доступ по API-ключу OpenAI остаётся доступным для неагентных
> поверхностей API OpenAI, а через упорядоченный профиль API-ключа `openai` — также для агентных
> моделей. См. [Провайдеры моделей](https://docs2.openclaw.ai/ru/concepts/model-providers.md) и
> [Первоначальная настройка (CLI)](https://docs2.openclaw.ai/ru/start/wizard.md).

> [accordion] Почему OpenClaw по-прежнему упоминает устаревший префикс OpenAI Codex?
>
> `openai` — текущий идентификатор провайдера и профиля аутентификации как для API-ключей OpenAI, так и для
> OAuth ChatGPT/Codex: OpenAI Codex включён в него. В старых конфигурациях и предупреждениях
> миграции всё ещё может встречаться устаревший префикс `openai-codex`:
>
> * `openai/gpt-5.6-sol` = новая настройка подписки ChatGPT/Codex с нативной средой выполнения Codex для обращений агента.
> * `openai/gpt-5.5` = явно поддерживаемый выбор для существующей конфигурации или аккаунтов без доступа к GPT-5.6.
> * Устаревшие ссылки на модели `openai-codex/*` = устаревший маршрут, исправляемый `openclaw doctor --fix`.
> * `openai/gpt-5.5` вместе с упорядоченным профилем API-ключа `openai` = аутентификация по API-ключу для агентной модели OpenAI.
> * Устаревшие идентификаторы профилей аутентификации `openai-codex` = устаревшие идентификаторы, мигрируемые `openclaw doctor --fix`.
>
> Хотите использовать прямую оплату через OpenAI Platform? Задайте `OPENAI_API_KEY`. Хотите использовать аутентификацию
> по подписке ChatGPT/Codex? Выполните `openclaw models auth login --provider openai`. Храните
> ссылки на модели в каноническом провайдере `openai/*`. При новой настройке подписки
> используется точно `openai/gpt-5.6-sol`; doctor исправляет устаревшие ссылки с префиксом Codex,
> не обновляя явно выбранную модель `openai/gpt-5.5`.

> [accordion] Почему лимиты OAuth Codex могут отличаться от лимитов ChatGPT в веб-интерфейсе?
>
> OAuth Codex использует управляемые OpenAI и зависящие от тарифа периоды квот, которые могут отличаться от
> возможностей сайта или приложения ChatGPT даже для одного аккаунта.
>
> `openclaw models status` показывает доступные в данный момент периоды использования и квот провайдера, но
> не создаёт и не преобразует права ChatGPT в веб-интерфейсе в прямой доступ к API. Для
> прямой оплаты и лимитов OpenAI Platform используйте `openai/*` с API-ключом.

> [accordion] Поддерживается ли аутентификация по подписке OpenAI (OAuth Codex)?
>
> Да, полностью. OpenAI явно разрешает использование OAuth по подписке во внешних
> инструментах и рабочих процессах, таких как OpenClaw. Первоначальная настройка может выполнить процесс OAuth за вас.
>
> См. [OAuth](https://docs2.openclaw.ai/ru/concepts/oauth.md), [Провайдеры моделей](https://docs2.openclaw.ai/ru/concepts/model-providers.md) и [Первоначальная настройка (CLI)](https://docs2.openclaw.ai/ru/start/wizard.md).

> [accordion] Как настроить OAuth Gemini CLI?
>
> Gemini CLI использует **процесс аутентификации плагина**, а не идентификатор или секрет клиента в `openclaw.json`.
>
> 1. Установите Gemini CLI локально, чтобы `gemini` находился в `PATH`:
>    * Homebrew: `brew install gemini-cli`
>    * npm: `npm install -g @google/gemini-cli`
> 2. Включите плагин: `openclaw plugins enable google`
> 3. Войдите: `openclaw models auth login --provider google-gemini-cli --set-default`
> 4. Модель по умолчанию после входа: `google/gemini-3.1-pro-preview` (среда выполнения `google-gemini-cli`)
> 5. Запросы завершаются ошибкой после входа? Задайте `GOOGLE_CLOUD_PROJECT` или `GOOGLE_CLOUD_PROJECT_ID` на хосте Gateway и повторите попытку.
>
> Токены OAuth хранятся в профилях аутентификации на хосте Gateway. Подробнее: [Google](https://docs2.openclaw.ai/ru/providers/google.md), [Провайдеры моделей](https://docs2.openclaw.ai/ru/concepts/model-providers.md).

> [accordion] Подойдёт ли локальная модель для обычных бесед?
>
> Обычно нет. OpenClaw требуется большой контекст и надёжная безопасность; видеокарты с небольшим объёмом памяти обрезают контекст
> и не используют фильтры безопасности на стороне провайдера. Если это необходимо, локально запускайте **самую крупную**
> доступную вам сборку модели (LM Studio) — см. [Локальные модели](https://docs2.openclaw.ai/ru/gateway/local-models.md). Меньшие и квантованные
> модели повышают риск инъекций в промпт — см. [Безопасность](https://docs2.openclaw.ai/ru/gateway/security.md).

> [accordion] Как сохранить трафик размещённой модели в определённом регионе?
>
> Выбирайте конечные точки, привязанные к региону. OpenRouter предоставляет размещённые в США варианты MiniMax, Kimi
> и GLM; выберите вариант, размещённый в США, чтобы данные оставались в этом регионе. Вы по-прежнему можете указать
> Anthropic/OpenAI вместе с ними через `models.mode: "merge"`, чтобы резервные варианты оставались
> доступными при соблюдении региональной привязки выбранного провайдера.

> [accordion] Нужно ли покупать Mac Mini для установки OpenClaw?
>
> Нет. OpenClaw работает в macOS и Linux (в Windows — через WSL2). Mac mini часто выбирают
> в качестве постоянно работающего хоста, но также подойдёт небольшой VPS, домашний сервер или устройство класса Raspberry Pi.
>
> Mac нужен только **для инструментов, доступных исключительно в macOS**. Для iMessage используйте [iMessage](https://docs2.openclaw.ai/ru/channels/imessage.md)
> с `imsg` на любом Mac, где выполнен вход в Messages. Если Gateway работает в Linux или другой системе,
> задайте для `channels.imessage.cliPath` SSH-обёртку, запускающую `imsg` на этом Mac. Для других
> инструментов, доступных только в macOS, запускайте Gateway на Mac или подключите узел macOS.
>
> Документация: [iMessage](https://docs2.openclaw.ai/ru/channels/imessage.md), [Узлы](https://docs2.openclaw.ai/ru/nodes.md), [Удалённый режим Mac](https://docs2.openclaw.ai/ru/platforms/mac/remote.md).

> [accordion] Нужен ли Mac mini для поддержки iMessage?
>
> Нужно **любое устройство с macOS**, на котором выполнен вход в Messages, — это не обязательно Mac mini,
> подойдёт любой Mac. Используйте [iMessage](https://docs2.openclaw.ai/ru/channels/imessage.md) с `imsg`; Gateway может работать на этом
> Mac или на другом хосте с SSH-обёрткой `cliPath`.
>
> Распространённые конфигурации:
>
> * Gateway работает на Linux/VPS, а `channels.imessage.cliPath` задан как SSH-обёртка, запускающая `imsg` на Mac, где выполнен вход в Messages.
> * Всё работает на одном Mac — самый простой вариант с одним компьютером.
>
> Документация: [iMessage](https://docs2.openclaw.ai/ru/channels/imessage.md), [Узлы](https://docs2.openclaw.ai/ru/nodes.md), [Удалённый режим Mac](https://docs2.openclaw.ai/ru/platforms/mac/remote.md).

> [accordion] Если я куплю Mac mini для запуска OpenClaw, смогу ли я подключить его к MacBook Pro?
>
> Да. **Mac mini может запускать Gateway**, а MacBook Pro подключается как **узел**
> (сопутствующее устройство). Узлы не запускают Gateway — они добавляют возможности
> экрана, камеры, холста и `system.run` на этом устройстве.
>
> Распространённая схема: Gateway работает на постоянно включённом Mac mini; на MacBook Pro работает приложение macOS или
> хост узла, сопряжённый с Gateway. Проверьте состояние с помощью `openclaw nodes status` / `openclaw nodes list`.
>
> Документация: [Узлы](https://docs2.openclaw.ai/ru/nodes.md), [CLI узлов](https://docs2.openclaw.ai/ru/cli/nodes.md).

> [accordion] Можно ли использовать Bun?
>
> Bun можно использовать для установки зависимостей или запуска скриптов пакетов. Для CLI OpenClaw и
> Gateway требуется **Node**, поскольку каноническое хранилище состояния использует `node:sqlite`; Bun
> не предоставляет этот API.

> [accordion] Telegram: что указывать в allowFrom?
>
> `channels.telegram.allowFrom` — это **числовой идентификатор пользователя Telegram, отправляющего сообщения**,
> а не имя пользователя бота. При настройке запрашиваются только числовые идентификаторы пользователей; `openclaw doctor --fix`
> может попытаться разрешить устаревшие записи `@username`.
>
> Более безопасный вариант без стороннего бота: отправьте личное сообщение своему боту, выполните `openclaw logs --follow` и прочитайте `from.id`.
>
> Официальный Bot API: отправьте личное сообщение своему боту, вызовите `https://api.telegram.org/bot<bot_token>/getUpdates` и прочитайте `message.from.id`.
>
> Сторонний вариант с меньшей конфиденциальностью: отправьте личное сообщение `@userinfobot` или `@getidsbot`.
>
> См. [Управление доступом Telegram](https://docs2.openclaw.ai/ru/channels/telegram.md#access-control-and-activation).

> [accordion] Могут ли несколько человек использовать один номер WhatsApp с разными экземплярами OpenClaw?
>
> Да, с помощью **мультиагентной маршрутизации**. Привяжите личные сообщения WhatsApp каждого отправителя (`peer: { kind: "direct", id: "+15551234567" }`) к отдельному `agentId`, предоставив каждому человеку собственное рабочее пространство и хранилище сеансов. Ответы по-прежнему будут отправляться из **одного аккаунта WhatsApp**; управление доступом к личным сообщениям (`channels.whatsapp.dmPolicy` / `channels.whatsapp.allowFrom`) действует глобально для аккаунта. См. [Мультиагентная маршрутизация](https://docs2.openclaw.ai/ru/concepts/multi-agent.md) и [WhatsApp](https://docs2.openclaw.ai/ru/channels/whatsapp.md).

> [accordion] Можно ли использовать одного агента для «быстрых бесед», а другого — с «Opus для программирования»?
>
> Да. Используйте мультиагентную маршрутизацию: назначьте каждому агенту собственную модель по умолчанию, а затем привяжите входящие
> маршруты (аккаунт провайдера или конкретных собеседников) к соответствующим агентам. Пример конфигурации:
> [Мультиагентная маршрутизация](https://docs2.openclaw.ai/ru/concepts/multi-agent.md). См. также [Модели](https://docs2.openclaw.ai/ru/concepts/models.md) и
> [Конфигурация](https://docs2.openclaw.ai/ru/gateway/configuration.md).

> [accordion] Работает ли Homebrew в Linux?
>
> Да, через Linuxbrew:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
> echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profile
> eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
> brew install <formula>
> ```
>
> При запуске OpenClaw через systemd убедитесь, что PATH службы содержит
> `/home/linuxbrew/.linuxbrew/bin` (или ваш префикс brew), чтобы инструменты, установленные через `brew`,
> разрешались в оболочках без входа в систему. Последние сборки также добавляют в начало PATH распространённые пользовательские каталоги исполняемых файлов в службах
> systemd Linux (например, `~/.local/bin`, `~/.npm-global/bin`,
> `~/.local/share/pnpm`, `~/.bun/bin`) и учитывают `PNPM_HOME`, `NPM_CONFIG_PREFIX`,
> `BUN_INSTALL`, `VOLTA_HOME`, `ASDF_DATA_DIR`, `NVM_DIR` и `FNM_DIR`, если они заданы.

> [accordion] Разница между изменяемой установкой из git и установкой из npm
>
> * **Изменяемая установка (git):** полная копия исходного кода с возможностью редактирования, лучше всего подходит участникам разработки. Вы выполняете сборку локально и можете изменять код и документацию.
> * **Установка из npm:** глобальная установка CLI без репозитория, лучше всего подходит для сценария «просто запустить». Обновления поступают через dist-теги npm.
>
> Документация: [Начало работы](https://docs2.openclaw.ai/ru/start/getting-started.md), [Обновление](https://docs2.openclaw.ai/ru/install/updating.md).

> [accordion] Можно ли позже переключаться между установками через npm и git?
>
> Да, с помощью `openclaw update --channel ...` для существующей установки. При этом **ваши
> данные не удаляются** — изменяется только способ установки кода OpenClaw. Состояние (`~/.openclaw`) и
> рабочая область (`~/.openclaw/workspace`) остаются без изменений.
>
> Переход с npm на git:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw update --channel dev
> ```
>
> Переход с git на npm:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw update --channel stable
> ```
>
> Добавьте `--dry-run`, чтобы сначала просмотреть запланированное переключение режима. Средство обновления выполняет
> последующие действия Doctor, обновляет источники плагинов для целевого канала и перезапускает Gateway,
> если не передан параметр `--no-restart`.
>
> Установщик также может принудительно выбрать любой из режимов:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git
> curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method npm
> ```
>
> Советы по резервному копированию: [Где данные хранятся на диске](https://docs2.openclaw.ai/ru/help/faq.md#where-things-live-on-disk).

> [accordion] Где лучше запускать Gateway: на ноутбуке или VPS?
>
> Нужна круглосуточная надежность? Используйте **VPS**. Хотите минимальных сложностей и готовы мириться
> с переходом в спящий режим и перезапусками? Запускайте локально.
>
> **Ноутбук (локальный Gateway)**
>
> * **Преимущества:** нет расходов на сервер, прямой доступ к локальным файлам, видимое окно браузера.
> * **Недостатки:** переход в спящий режим и обрывы сети приводят к отключению, обновления и перезагрузки ОС прерывают работу, ноутбук должен оставаться активным.
>
> **VPS / облако**
>
> * **Преимущества:** постоянная работа, стабильная сеть, нет проблем со спящим режимом ноутбука, проще обеспечить непрерывную работу.
> * **Недостатки:** часто нет графического интерфейса (используйте снимки экрана), только удаленный доступ к файлам, для обновлений требуется SSH.
>
> WhatsApp/Telegram/Slack/Mattermost/Discord одинаково хорошо работают с VPS — фактический
> компромисс заключается в выборе между браузером без графического интерфейса и видимым окном. См. раздел [Браузер](https://docs2.openclaw.ai/ru/tools/browser.md).
>
> Рекомендация по умолчанию: используйте VPS, если ранее уже происходили отключения Gateway; локальный запуск отлично подходит,
> когда вы активно используете Mac и вам нужен доступ к локальным файлам либо автоматизация
> пользовательского интерфейса в видимом браузере.

> [accordion] Насколько важно запускать OpenClaw на выделенном компьютере?
>
> Это не обязательно, но рекомендуется для надежности и изоляции.
>
> * **Выделенный хост (VPS/Mac mini/Raspberry Pi):** постоянная работа, меньше прерываний из-за перехода в спящий режим или перезагрузки, более упорядоченные разрешения, проще обеспечить непрерывную работу.
> * **Общий ноутбук или настольный компьютер:** подходит для тестирования и активного использования, но работа будет приостанавливаться при переходе компьютера в спящий режим или установке обновлений.
>
> Чтобы получить преимущества обоих вариантов, разместите Gateway на выделенном хосте и подключите ноутбук как
> **Node** для локальных инструментов работы с экраном, камерой и выполнения команд. См. разделы [Узлы](https://docs2.openclaw.ai/ru/nodes.md) и [Безопасность](https://docs2.openclaw.ai/ru/gateway/security.md).

> [accordion] Каковы минимальные требования к VPS и рекомендуемая ОС?
>
> * **Абсолютный минимум:** 1 виртуальный процессор, 1 ГБ ОЗУ, около 500 МБ на диске.
> * **Рекомендуется:** 1–2 виртуальных процессора, не менее 2 ГБ ОЗУ с запасом для журналов, медиафайлов и нескольких каналов. Инструменты Node и автоматизация браузера могут потреблять много ресурсов.
>
> ОС: **Ubuntu LTS** (или любая современная версия Debian/Ubuntu) — наиболее тщательно протестированный вариант установки в Linux.
>
> Документация: [Linux](https://docs2.openclaw.ai/ru/platforms/linux.md), [Размещение на VPS](https://docs2.openclaw.ai/ru/vps.md).

> [accordion] Можно ли запустить OpenClaw в виртуальной машине и каковы требования?
>
> Да. Относитесь к виртуальной машине как к VPS: она должна быть постоянно включена, доступна по сети и иметь достаточно ОЗУ
> для Gateway и всех включенных каналов.
>
> * **Абсолютный минимум:** 1 виртуальный процессор, 1 ГБ ОЗУ.
> * **Рекомендуется:** не менее 2 ГБ ОЗУ для нескольких каналов, автоматизации браузера или инструментов работы с медиафайлами.
> * **ОС:** Ubuntu LTS или другая современная версия Debian/Ubuntu.
>
> В Windows используйте **Windows Hub** для настройки настольной среды или WSL2 для виртуальной машины Gateway
> в стиле Linux с широкой совместимостью инструментов. См. разделы [Windows](https://docs2.openclaw.ai/ru/platforms/windows.md) и [Размещение на VPS](https://docs2.openclaw.ai/ru/vps.md).
> Запуск macOS в виртуальной машине: см. раздел [Виртуальная машина macOS](https://docs2.openclaw.ai/ru/install/macos-vm.md).

## Связанные материалы

* [Часто задаваемые вопросы](https://docs2.openclaw.ai/ru/help/faq.md) — основной раздел вопросов и ответов (модели, сеансы, Gateway, безопасность и другое)
* [Обзор установки](https://docs2.openclaw.ai/ru/install.md)
* [Начало работы](https://docs2.openclaw.ai/ru/start/getting-started.md)
* [Устранение неполадок](https://docs2.openclaw.ai/ru/help/troubleshooting.md)
