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

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

• Claude Code: https://www.anthropic.com/claude-code/
• OpenAI Codex: https://openai.com/codex/

Предоставьте агенту полный исходный код через изменяемую установку (git), чтобы он мог изучить код и документацию и учесть точную используемую вами версию:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Попросите агента пошагово спланировать и проконтролировать исправление, а затем выполнить только необходимые команды — небольшие изменения проще проверять.

При обращении за помощью (в Discord или в задаче GitHub) предоставьте результаты следующих команд:

Нашли настоящую ошибку или исправление? Создайте задачу или отправьте PR: Задачи / Запросы на включение изменений.

Быстрый цикл отладки: Первые 60 секунд при возникновении неполадки. Документация по установке: Установка, Флаги установщика, Обновление.

В режиме задач сроки следующего выполнения сдвигаются только после завершения фактического запуска Heartbeat. Пропущенные запуски не отмечают задачи как выполненные.

Документация: Heartbeat, Автоматизация.

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bashopenclaw onboard --install-daemon

Из исходного кода (для участников разработки и разработчиков):

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm buildpnpm ui:buildopenclaw onboard

Глобальная установка ещё не выполнена? Вместо этого запустите pnpm openclaw onboard. Если ресурсы Control UI отсутствуют, первоначальная настройка пытается собрать их самостоятельно, а при неудаче использует pnpm ui:build.

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

Локальный компьютер (тот же компьютер):

• Откройте 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/. В туннеле по-прежнему применяется аутентификация с общим секретом; при запросе вставьте настроенный токен или пароль.

Сведения о режимах привязки и аутентификации см. в разделах Панель управления и Веб-интерфейсы.

Они управляют разными уровнями:

• approvals.exec — перенаправляет запросы подтверждения в чаты.
• channels.<channel>.execApprovals — делает этот канал нативным клиентом подтверждения выполнения.

Политика выполнения на узле всё равно остаётся фактическим шлюзом подтверждений; конфигурация чата управляет только тем, где появляются запросы и как пользователи отвечают на них.

Обычно обе конфигурации не нужны:

• Если чат уже поддерживает команды и ответы, /approve в том же чате работает через общий механизм.
• Когда поддерживаемый нативный канал может безопасно определить подтверждающих пользователей, OpenClaw автоматически включает нативные подтверждения с приоритетом личных сообщений, если channels.<channel>.execApprovals.enabled не задано или равно "auto".
• Когда доступны нативные карточки или кнопки подтверждения, этот интерфейс используется в первую очередь; упоминайте ручную команду /approve только в том случае, если результат инструмента сообщает, что подтверждения через чат недоступны.
• Используйте approvals.exec только тогда, когда запросы также должны поступать в другие чаты или явно заданные операционные комнаты.
• Используйте channels.<channel>.execApprovals.target: "channel" или "both" только тогда, когда запросы подтверждения нужно публиковать обратно в исходную комнату или тему.
• Подтверждения плагинов обрабатываются отдельно: по умолчанию используется /approve в том же чате, можно включить перенаправление approvals.plugin, и лишь некоторые нативные каналы сохраняют нативную обработку и для таких подтверждений.

Кратко: перенаправление отвечает за маршрутизацию, а конфигурация нативного клиента — за расширенный интерфейс с учётом особенностей канала. См. Подтверждения выполнения.

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

Да, но сначала проверьте объём оперативной памяти: оптимальны Pi 5 и Pi 4 (2 GB+); Pi 3B+ (1 GB) работает, но медленно; Pi Zero 2 W (512 MB) не рекомендуется.

Абсолютный минимум: 1 GB оперативной памяти, 1 ядро, 500 MB свободного места на диске, 64-разрядная ОС. Поскольку Pi запускает только Gateway (модели обращаются к облачным API), даже устройство Pi со скромными характеристиками справляется с нагрузкой.

Небольшое устройство Pi или VPS также может размещать только Gateway, а узлы на ноутбуке или телефоне можно связать с ним для локальной работы с экраном, камерой, холстом или выполнения команд. См. Узлы.

Полное пошаговое руководство по настройке: Raspberry Pi.

• Используйте 64-разрядную ОС; не используйте 32-разрядную Raspberry Pi OS.
• Добавьте подкачку на платах с 2 GB памяти или меньше.
• Для производительности и долговечности предпочитайте USB SSD, а не SD-карту.
• Предпочитайте изменяемую установку (git), чтобы просматривать журналы и быстро обновляться.
• Начните без каналов и навыков, затем добавляйте их по одному.
• Необычные ошибки двоичных файлов («exec format error») обычно означают, что для необязательного инструмента навыка отсутствует сборка ARM64.

Полное руководство: Raspberry Pi. См. также Linux.

Работа этого экрана зависит от доступности Gateway и успешной аутентификации. TUI также автоматически отправляет «Проснись, мой друг!» при первом запуске, если настроен провайдер модели. Если вы пропустили настройку модели или аутентификации, процесс первоначальной настройки показывает уведомление «Аутентификация модели отсутствует» и открывает TUI, ничего не отправляя, — добавьте провайдера с помощью openclaw configure --section model. Если отображается строка пробуждения, но ответа нет, а количество токенов остаётся равным 0, агент не запускался.

1. Перезапустите Gateway:

openclaw gateway restart

2. Проверьте состояние и аутентификацию:

openclaw statusopenclaw models statusopenclaw logs --follow

3. Всё ещё зависает? Выполните:

openclaw doctor

Если Gateway находится на удалённом компьютере, убедитесь, что туннель или подключение Tailscale активно, а интерфейс указывает на правильный Gateway. См. Удалённый доступ.

Да. Скопируйте каталог состояния и рабочее пространство, затем один раз запустите 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).

Связанные разделы: Перенос, Расположение данных на диске, Рабочее пространство агента, Doctor, Удалённый режим.

Просмотрите журнал изменений на GitHub: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

Самые новые записи находятся вверху. Если верхний раздел называется Невыпущенное, следующий раздел с датой соответствует последней выпущенной версии. Записи сгруппированы по разделам Основные нововведения, Изменения и Исправления (а при необходимости также по разделам документации и другим разделам).

Некоторые подключения Comcast/Xfinity ошибочно блокируют docs.openclaw.ai через Xfinity Advanced Security. Отключите эту функцию или добавьте docs.openclaw.ai в список разрешенных адресов, затем повторите попытку. Помогите нам снять блокировку: https://spa.xfinity.com/check_url_status.

Доступ по-прежнему заблокирован? Копия документации доступна на GitHub: https://github.com/openclaw/openclaw/tree/main/docs

Стабильная и бета-версия — это dist-теги npm, а не отдельные ветки кода:

• latest = стабильная версия
• beta = ранняя сборка для тестирования (используется latest, если бета-версия отсутствует или старше текущего стабильного выпуска)

Стабильный выпуск обычно сначала попадает в канал beta, после чего на отдельном этапе продвижения эта же версия переносится в latest без изменения номера версии. Сопровождающие также могут опубликовать выпуск напрямую в latest. Поэтому после продвижения бета- и стабильный каналы могут указывать на одну и ту же версию.

Список изменений: CHANGELOG.md.

Однострочные команды установки и различия между beta и dev приведены в следующем раскрывающемся разделе.

Beta — это dist-тег npm beta (после продвижения может совпадать с latest). Dev — изменяющаяся вершина ветки main (git); при публикации в npm используется dist-тег 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): iwr -useb https://openclaw.ai/install.ps1 | iex

Подробнее: Каналы разработки и Флаги установщика.

Есть два варианта:

1. Канал dev (существующая установка):

openclaw update --channel dev

Эта команда переключает установку на рабочую копию git из main, выполняет rebase относительно вышестоящего репозитория, собирает проект и устанавливает CLI из этой рабочей копии.

2. Изменяемая установка (git) на новом компьютере:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Предпочтительный вариант — клонировать вручную:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm build

Документация: Обновление, Каналы разработки, Установка.

Примерные сроки:

• Установка: 2–5 минут.
• Первоначальная настройка QuickStart: несколько минут (локальный Gateway, автоматический токен, рабочая область по умолчанию).
• Расширенная/полная первоначальная настройка: занимает больше времени, если требуются вход у провайдера, сопряжение канала, установка фоновой службы, загрузка данных по сети или дополнительная настройка Skills.

Мастер заранее показывает эти сроки. Необязательные этапы можно пропустить и вернуться к ним позже с помощью openclaw configure.

Процесс завис? См. раздел Процесс завис выше.

Запустите его повторно с --verbose:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --verbosecurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta --verbosecurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose

У install.ps1 нет отдельного переключателя подробного вывода; вместо этого запустите его через Set-PSDebug -Trace 1 / -Trace 0. Полный справочник флагов: Флаги установщика.

Две распространенные проблемы в 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.

Обычно причина заключается в несовпадении кодовой страницы консоли в нативных оболочках Windows.

Признаки: китайский текст в выводе system.run/exec отображается как нечитаемые символы, но та же команда выглядит нормально в другом профиле терминала.

Обходное решение в PowerShell:

chcp 65001[Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)$OutputEncoding = [System.Text.UTF8Encoding]::new($false)

Затем перезапустите Gateway и повторите попытку:

openclaw gateway restart

Проблема по-прежнему воспроизводится в последней версии OpenClaw? Следите за ней или сообщите подробности: Задача #30640.

Используйте изменяемую установку (git), чтобы полный исходный код и документация были доступны локально, а затем задайте вопрос своему боту (или Claude/Codex) из этой папки, чтобы он мог прочитать репозиторий и дать точный ответ.

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Подробнее: Установка и Флаги установщика.

• Быстрая установка в Linux и установка службы: Linux.
• Полное пошаговое руководство: Начало работы.
• Установщик и обновления: Установка и обновления.

Подойдет любой VPS с Linux. Установите OpenClaw на сервере, а затем подключайтесь к Gateway через SSH/Tailscale.

Руководства: exe.dev, Hetzner, Fly.io. Удаленный доступ: Удаленный доступ к Gateway.

Раздел о хостинге с распространенными провайдерами:

• Хостинг на VPS (все провайдеры в одном месте)
• Fly.io
• Hetzner
• exe.dev

В облачной конфигурации Gateway работает на сервере, а вы подключаетесь к нему с ноутбука или телефона через Control UI (либо Tailscale/SSH). Ваше состояние и рабочая область хранятся на сервере, поэтому считайте хост основным источником данных и создавайте его резервные копии.

Сопрягите узлы (Mac/iOS/Android/без графического интерфейса) с облачным Gateway, чтобы локально использовать экран, камеру, холст или выполнять команды на ноутбуке, пока Gateway остается в облаке.

Раздел: Платформы. Удаленный доступ: Удаленный доступ к Gateway. Узлы: Узлы, CLI узлов.

Это возможно, но не рекомендуется. В процессе обновления Gateway может перезапуститься (что приведет к разрыву активного сеанса), может потребоваться чистая рабочая копия git и подтверждение. Безопаснее выполнять обновления из оболочки от имени оператора.

openclaw updateopenclaw update statusopenclaw update --channel stable|extended-stable|beta|devopenclaw update --tag <dist-tag|version>openclaw update --no-restart

Автоматизация с помощью агента:

openclaw update --yes --no-restartopenclaw gateway restart

Документация: Обновление, Обновление установки.

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).

Нет. Запускайте 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, OpenAI, Qwen Cloud, MiniMax, Z.AI (GLM), Локальные модели, Модели.

Да. OpenClaw поддерживает повторное использование Claude CLI для планов Pro/Max/Team/Enterprise. В настоящее время Anthropic считает путь claude -p, который использует OpenClaw, использованием в рамках подписки, подпадающим под ограничения вашего плана, а не отдельной бесплатной квотой — актуальные сведения об оплате и ссылки на статьи службы поддержки Anthropic см. в разделе Anthropic. Для наиболее предсказуемой настройки на стороне сервера вместо этого используйте ключ API Anthropic.

Да, посредством повторного использования Claude CLI. Подход Anthropic к тарификации использования claude -p/Agent SDK со временем менялся; прежде чем полагаться на конкретный порядок тарификации, ознакомьтесь с актуальной информацией и датированными ссылками на статьи службы поддержки Anthropic в разделе Anthropic.

Anthropic setup-token также по-прежнему поддерживается как способ аутентификации с помощью токена, но OpenClaw предпочитает повторное использование Claude CLI и claude -p, когда они доступны. Для производственных или многопользовательских нагрузок API-ключ Anthropic остаётся более безопасным и предсказуемым выбором. Другие размещённые варианты на основе подписки: OpenAI, Qwen Cloud, MiniMax, Z.AI (GLM).

Ваша квота 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 продолжал отвечать, пока провайдер ограничивает частоту запросов. См. Модели, OAuth и Для длинного контекста при ошибке Anthropic 429 требуется дополнительное использование.

Да. В 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 и Провайдеры моделей. Если вы предпочитаете управляемую работу с ключами, допустимым вариантом также остаётся OpenAI-совместимый прокси перед Bedrock.

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 — также для агентных моделей. См. Провайдеры моделей и Первоначальная настройка (CLI).

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.

OAuth Codex использует управляемые OpenAI и зависящие от тарифа периоды квот, которые могут отличаться от возможностей сайта или приложения ChatGPT даже для одного аккаунта.

openclaw models status показывает доступные в данный момент периоды использования и квот провайдера, но не создаёт и не преобразует права ChatGPT в веб-интерфейсе в прямой доступ к API. Для прямой оплаты и лимитов OpenAI Platform используйте openai/* с API-ключом.

Да, полностью. OpenAI явно разрешает использование OAuth по подписке во внешних инструментах и рабочих процессах, таких как OpenClaw. Первоначальная настройка может выполнить процесс OAuth за вас.

См. OAuth, Провайдеры моделей и Первоначальная настройка (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, Провайдеры моделей.

Обычно нет. OpenClaw требуется большой контекст и надёжная безопасность; видеокарты с небольшим объёмом памяти обрезают контекст и не используют фильтры безопасности на стороне провайдера. Если это необходимо, локально запускайте самую крупную доступную вам сборку модели (LM Studio) — см. Локальные модели. Меньшие и квантованные модели повышают риск инъекций в промпт — см. Безопасность.

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

Нет. OpenClaw работает в macOS и Linux (в Windows — через WSL2). Mac mini часто выбирают в качестве постоянно работающего хоста, но также подойдёт небольшой VPS, домашний сервер или устройство класса Raspberry Pi.

Mac нужен только для инструментов, доступных исключительно в macOS. Для iMessage используйте iMessage с imsg на любом Mac, где выполнен вход в Messages. Если Gateway работает в Linux или другой системе, задайте для channels.imessage.cliPath SSH-обёртку, запускающую imsg на этом Mac. Для других инструментов, доступных только в macOS, запускайте Gateway на Mac или подключите узел macOS.

Документация: iMessage, Узлы, Удалённый режим Mac.

Нужно любое устройство с macOS, на котором выполнен вход в Messages, — это не обязательно Mac mini, подойдёт любой Mac. Используйте iMessage с imsg; Gateway может работать на этом Mac или на другом хосте с SSH-обёрткой cliPath.

Распространённые конфигурации:

• Gateway работает на Linux/VPS, а channels.imessage.cliPath задан как SSH-обёртка, запускающая imsg на Mac, где выполнен вход в Messages.
• Всё работает на одном Mac — самый простой вариант с одним компьютером.

Документация: iMessage, Узлы, Удалённый режим Mac.

Да. Mac mini может запускать Gateway, а MacBook Pro подключается как узел (сопутствующее устройство). Узлы не запускают Gateway — они добавляют возможности экрана, камеры, холста и system.run на этом устройстве.

Распространённая схема: Gateway работает на постоянно включённом Mac mini; на MacBook Pro работает приложение macOS или хост узла, сопряжённый с Gateway. Проверьте состояние с помощью openclaw nodes status / openclaw nodes list.

Документация: Узлы, CLI узлов.

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

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.

Да, с помощью мультиагентной маршрутизации. Привяжите личные сообщения WhatsApp каждого отправителя (peer: { kind: "direct", id: "+15551234567" }) к отдельному agentId, предоставив каждому человеку собственное рабочее пространство и хранилище сеансов. Ответы по-прежнему будут отправляться из одного аккаунта WhatsApp; управление доступом к личным сообщениям (channels.whatsapp.dmPolicy / channels.whatsapp.allowFrom) действует глобально для аккаунта. См. Мультиагентная маршрутизация и WhatsApp.

Да. Используйте мультиагентную маршрутизацию: назначьте каждому агенту собственную модель по умолчанию, а затем привяжите входящие маршруты (аккаунт провайдера или конкретных собеседников) к соответствующим агентам. Пример конфигурации: Мультиагентная маршрутизация. См. также Модели и Конфигурация.

Да, через Linuxbrew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profileeval "$(/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, если они заданы.

• Изменяемая установка (git): полная копия исходного кода с возможностью редактирования, лучше всего подходит участникам разработки. Вы выполняете сборку локально и можете изменять код и документацию.
• Установка из npm: глобальная установка CLI без репозитория, лучше всего подходит для сценария «просто запустить». Обновления поступают через dist-теги npm.

Документация: Начало работы, Обновление.

Да, с помощью openclaw update --channel ... для существующей установки. При этом ваши данные не удаляются — изменяется только способ установки кода OpenClaw. Состояние (~/.openclaw) и рабочая область (~/.openclaw/workspace) остаются без изменений.

Переход с npm на git:

openclaw update --channel dev

Переход с git на npm:

openclaw update --channel stable

Добавьте --dry-run, чтобы сначала просмотреть запланированное переключение режима. Средство обновления выполняет последующие действия Doctor, обновляет источники плагинов для целевого канала и перезапускает Gateway, если не передан параметр --no-restart.

Установщик также может принудительно выбрать любой из режимов:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method gitcurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method npm

Советы по резервному копированию: Где данные хранятся на диске.

Нужна круглосуточная надежность? Используйте VPS. Хотите минимальных сложностей и готовы мириться с переходом в спящий режим и перезапусками? Запускайте локально.

Ноутбук (локальный Gateway)

• Преимущества: нет расходов на сервер, прямой доступ к локальным файлам, видимое окно браузера.
• Недостатки: переход в спящий режим и обрывы сети приводят к отключению, обновления и перезагрузки ОС прерывают работу, ноутбук должен оставаться активным.

VPS / облако

• Преимущества: постоянная работа, стабильная сеть, нет проблем со спящим режимом ноутбука, проще обеспечить непрерывную работу.
• Недостатки: часто нет графического интерфейса (используйте снимки экрана), только удаленный доступ к файлам, для обновлений требуется SSH.

WhatsApp/Telegram/Slack/Mattermost/Discord одинаково хорошо работают с VPS — фактический компромисс заключается в выборе между браузером без графического интерфейса и видимым окном. См. раздел Браузер.

Рекомендация по умолчанию: используйте VPS, если ранее уже происходили отключения Gateway; локальный запуск отлично подходит, когда вы активно используете Mac и вам нужен доступ к локальным файлам либо автоматизация пользовательского интерфейса в видимом браузере.

Это не обязательно, но рекомендуется для надежности и изоляции.

• Выделенный хост (VPS/Mac mini/Raspberry Pi): постоянная работа, меньше прерываний из-за перехода в спящий режим или перезагрузки, более упорядоченные разрешения, проще обеспечить непрерывную работу.
• Общий ноутбук или настольный компьютер: подходит для тестирования и активного использования, но работа будет приостанавливаться при переходе компьютера в спящий режим или установке обновлений.

Чтобы получить преимущества обоих вариантов, разместите Gateway на выделенном хосте и подключите ноутбук как Node для локальных инструментов работы с экраном, камерой и выполнения команд. См. разделы Узлы и Безопасность.

• Абсолютный минимум: 1 виртуальный процессор, 1 ГБ ОЗУ, около 500 МБ на диске.
• Рекомендуется: 1–2 виртуальных процессора, не менее 2 ГБ ОЗУ с запасом для журналов, медиафайлов и нескольких каналов. Инструменты Node и автоматизация браузера могут потреблять много ресурсов.

ОС: Ubuntu LTS (или любая современная версия Debian/Ubuntu) — наиболее тщательно протестированный вариант установки в Linux.

Документация: Linux, Размещение на VPS.

Да. Относитесь к виртуальной машине как к VPS: она должна быть постоянно включена, доступна по сети и иметь достаточно ОЗУ для Gateway и всех включенных каналов.

• Абсолютный минимум: 1 виртуальный процессор, 1 ГБ ОЗУ.
• Рекомендуется: не менее 2 ГБ ОЗУ для нескольких каналов, автоматизации браузера или инструментов работы с медиафайлами.
• ОС: Ubuntu LTS или другая современная версия Debian/Ubuntu.

В Windows используйте Windows Hub для настройки настольной среды или WSL2 для виртуальной машины Gateway в стиле Linux с широкой совместимостью инструментов. См. разделы Windows и Размещение на VPS. Запуск macOS в виртуальной машине: см. раздел Виртуальная машина macOS.