FAQ

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

Содержание

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

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

    openclaw status

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

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

    openclaw status --all

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

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

    openclaw gateway status

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

  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   # показывает целевой URL + путь конфигурации при ошибках

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

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

Я застрял как быстрее всего решить проблему

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

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

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

Это устанавливает OpenClaw из git checkout, чтобы агент мог читать код + документацию и рассуждать о точной версии, которую вы запускаете. Вы всегда можете вернуться к стабильной версии позже, запустив установщик без --install-method git.

Совет: попросите агента спланировать и контролировать исправление (пошагово), затем выполнять только необходимые команды. Это сохраняет изменения небольшими и легкими для аудита.

Если вы обнаружите настоящий баг или исправление, пожалуйста, создайте issue на GitHub или отправьте PR: https://github.com/openclaw/openclaw/issues https://github.com/openclaw/openclaw/pulls

Начните с этих команд (поделитесь выводами при запросе помощи):

openclaw status
openclaw models status
openclaw doctor

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

  • openclaw status: быстрый снимок здоровья 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.bot/install.sh | bash
openclaw onboard --install-daemon

Мастер также может автоматически собирать UI-ассеты. После онбординга вы обычно запускаете Gateway на порту 18789.

Из исходников (контрибьюторы/разработка):

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build # автоматически устанавливает зависимости UI при первом запуске
openclaw onboard

Если у вас еще нет глобальной установки, запустите через pnpm openclaw onboard.

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

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

Как аутентифицировать панель управления токен на localhost vs удаленно

Localhost (та же машина):

  • Откройте http://127.0.0.1:18789/.
  • Если запрашивается аутентификация, запустите openclaw dashboard и используйте ссылку с токеном (?token=...).
  • Токен — это то же значение, что и gateway.auth.token (или OPENCLAW_GATEWAY_TOKEN), и сохраняется в UI после первой загрузки.

Не на localhost:

  • Tailscale Serve (рекомендуется): оставьте bind loopback, запустите openclaw gateway --tailscale serve, откройте https://<magicdns>/. Если gateway.auth.allowTailscale установлен в true, заголовки идентификации удовлетворяют аутентификации (токен не требуется).
  • 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/?token=... из openclaw dashboard.

См. Dashboard и Web surfaces для режимов bind и деталей аутентификации.

Какая среда выполнения мне нужна

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

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

Да. Gateway легкий — документация указывает 512MB-1GB RAM, 1 ядро и около 500MB дискового пространства как достаточно для личного использования, и отмечает, что Raspberry Pi 4 может его запустить.

Если вы хотите дополнительный запас (логи, медиа, другие сервисы), 2GB рекомендуется, но это не жесткий минимум.

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

Какие-нибудь советы для установки на Raspberry Pi

Краткая версия: работает, но ожидайте шероховатости.

  • Используйте 64-битную ОС и держите Node >= 22.
  • Предпочитайте хакабельную (git) установку, чтобы видеть логи и быстро обновляться.
  • Начните без каналов/навыков, затем добавляйте их по одному.
  • Если столкнетесь со странными проблемами с бинарниками, обычно это проблема совместимости 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 без повторного онбординга

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

  1. Установите OpenClaw на новой машине.
  2. Скопируйте $OPENCLAW_STATE_DIR (по умолчанию: ~/.openclaw) со старой машины.
  3. Скопируйте ваше рабочее пространство (по умолчанию: ~/.openclaw/workspace).
  4. Запустите openclaw doctor и перезапустите сервис Gateway.

Это сохраняет конфигурацию, профили аутентификации, учетные данные WhatsApp, сессии и память. Если вы в удаленном режиме, помните, что хост gateway владеет хранилищем сессий и рабочим пространством.

Важно: если вы только коммитите/пушите ваше рабочее пространство в GitHub, вы делаете резервную копию памяти + файлов начальной загрузки, но не истории сессий или аутентификации. Они находятся под ~/.openclaw/ (например, ~/.openclaw/agents/<agentId>/sessions/).

Связанное: Migrating, Где что хранится на диске, Agent workspace, Doctor, Remote mode.

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

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

Новейшие записи находятся вверху. Если верхний раздел помечен Unreleased, следующий датированный раздел — последняя выпущенная версия. Записи сгруппированы по Highlights, Changes и Fixes (плюс разделы docs/other при необходимости).

Не могу получить доступ к docsopenclawai ошибка SSL Что делать

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

Если вы все еще не можете достичь сайта, документация зеркалируется на GitHub: https://github.com/openclaw/openclaw/tree/main/docs

В чем разница между стабильной и бета версией

Stable и beta — это npm dist-теги, а не отдельные кодовые линии:

  • latest = стабильная
  • beta = ранняя сборка для тестирования

Мы отправляем сборки в beta, тестируем их, и как только сборка стабильна, мы продвигаем ту же версию в latest. Вот почему beta и stable могут указывать на одну и ту же версию.

См. что изменилось:
https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

Как установить бета версию и в чем разница между beta и dev

Beta — это npm dist-тег beta (может совпадать с latest).
Dev — это движущаяся голова main (git); при публикации использует npm dist-тег dev.

Однострочники (macOS/Linux):

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.bot/install.sh | bash -s -- --beta

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

Установщик Windows (PowerShell): https://openclaw.ai/install.ps1

Больше деталей: Development channels и Installer flags.

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

Примерное руководство:

  • Установка: 2-5 минут
  • Онбординг: 5-15 минут в зависимости от того, сколько каналов/моделей вы настраиваете

Если зависает, используйте Установщик завис и быстрый цикл отладки в Я застрял.

Как попробовать последние изменения

Два варианта:

  1. Dev канал (git checkout):
openclaw update --channel dev

Это переключается на ветку main и обновляется из исходников.

  1. Хакабельная установка (с сайта установщика):
curl -fsSL https://openclaw.bot/install.sh | bash -s -- --install-method git

Это дает вам локальный репозиторий, который можно редактировать, затем обновлять через git.

Если вы предпочитаете чистое клонирование вручную, используйте:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build

Документация: Update, Development channels, Install.

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

Перезапустите установщик с подробным выводом:

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

Бета-установка с подробным выводом:

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

Для хакабельной (git) установки:

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

Больше опций: Installer flags.

Установка Windows говорит что git не найден или openclaw не распознан

Две распространенные проблемы Windows:

1) npm error spawn git / git не найден

  • Установите Git для Windows и убедитесь, что git есть в вашем PATH.
  • Закройте и снова откройте PowerShell, затем перезапустите установщик.

2) openclaw не распознается после установки

  • Ваша глобальная папка bin npm не в PATH.
  • Проверьте путь: 
    npm config get prefix
  • Убедитесь, что <prefix>\\bin в PATH (на большинстве систем это %AppData%\\npm).
  • Закройте и снова откройте PowerShell после обновления PATH.

Если вы хотите наиболее плавную настройку Windows, используйте WSL2 вместо нативного Windows. Документация: Windows.

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

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

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

Больше деталей: Install и Installer flags.

Как установить OpenClaw на Linux

Краткий ответ: следуйте руководству Linux, затем запустите мастер онбординга.

  • Быстрый путь Linux + установка сервиса: Linux.
  • Полное руководство: Getting Started.
  • Установщик + обновления: Install & updates.

Как установить OpenClaw на VPS

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

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

Где руководства по установке на облакоVPS

Мы поддерживаем хаб хостинга с распространенными провайдерами. Выберите один и следуйте руководству:

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

Вы можете соединять узлы (Mac/iOS/Android/headless) с этим облачным Gateway для доступа к локальному экрану/камере/canvas или запуска команд на вашем ноутбуке, сохраняя Gateway в облаке.

Хаб: Platforms. Удаленный доступ: Gateway remote. Узлы: Nodes, Nodes CLI.

Могу ли я попросить OpenClaw обновить себя

Краткий ответ: возможно, не рекомендуется. Процесс обновления может перезапустить Gateway (что прерывает активную сессию), может потребовать чистого git checkout и может запрашивать подтверждение. Безопаснее: запускать обновления из оболочки как оператор.

Используйте CLI:

openclaw update
openclaw update status
openclaw update --channel stable|beta|dev
openclaw update --tag <dist-tag|version>
openclaw update --no-restart

Если вы должны автоматизировать от агента:

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

Документация: Update, Updating.

Что на самом деле делает мастер онбординга

openclaw onboard — это рекомендуемый путь настройки. В локальном режиме он проводит вас через:

  • Настройку модели/аутентификации (Anthropic setup-token рекомендуется для подписок Claude, OpenAI Codex OAuth поддерживается, API-ключи опциональны, локальные модели LM Studio поддерживаются)
  • Рабочее пространство локация + файлы начальной загрузки
  • Настройки Gateway (bind/port/auth/tailscale)
  • Провайдеры (WhatsApp, Telegram, Discord, Mattermost (plugin), Signal, iMessage)
  • Установка демона (LaunchAgent на macOS; systemd user unit на Linux/WSL2)
  • Проверки работоспособности и выбор навыков

Он также предупреждает, если ваша настроенная модель неизвестна или отсутствует аутентификация.

Нужна ли мне подписка Claude или OpenAI для запуска

Нет. Вы можете запустить OpenClaw с API-ключами (Anthropic/OpenAI/другие) или с локальными моделями, чтобы ваши данные оставались на вашем устройстве. Подписки (Claude Pro/Max или OpenAI Codex) — это опциональные способы аутентификации этих провайдеров.

Документация: Anthropic, OpenAI, Local models, Models.

Могу ли я использовать подписку Claude Max без API ключа

Да. Вы можете аутентифицироваться с помощью setup-token вместо API-ключа. Это путь подписки.

Подписки Claude Pro/Max не включают API-ключ, поэтому это правильный подход для аккаунтов подписки. Важно: вы должны проверить с Anthropic, что это использование разрешено согласно их политике подписки и условиям. Если вы хотите наиболее явный, поддерживаемый путь, используйте API-ключ Anthropic.

Как работает аутентификация Anthropic setuptoken

claude setup-token генерирует строку токена через CLI Claude Code (она недоступна в веб-консоли). Вы можете запустить её на любой машине. Выберите Anthropic token (paste setup-token) в мастере или вставьте его с openclaw models auth paste-token --provider anthropic. Токен хранится как профиль аутентификации для провайдера anthropic и используется как API-ключ (без автообновления). Больше деталей: OAuth.

Где найти Anthropic setuptoken

Его нет в Anthropic Console. Setup-token генерируется CLI Claude Code на любой машине:

claude setup-token

Скопируйте токен, который он выводит, затем выберите Anthropic token (paste setup-token) в мастере. Если вы хотите запустить его на хосте gateway, используйте openclaw models auth setup-token --provider anthropic. Если вы запустили claude setup-token в другом месте, вставьте его на хосте gateway с openclaw models auth paste-token --provider anthropic. См. Anthropic.

Поддерживается ли аутентификация подписки Claude Claude Pro Max

Да — через setup-token. OpenClaw больше не переиспользует OAuth токены CLI Claude Code; используйте setup-token или API-ключ Anthropic. Сгенерируйте токен где угодно и вставьте его на хосте gateway. См. Anthropic и OAuth.

Примечание: доступ к подписке Claude регулируется условиями Anthropic. Для продакшена или мультипользовательских рабочих нагрузок API-ключи обычно более безопасный выбор.

Почему я вижу HTTP 429 ratelimiterror от Anthropic

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

Совет: установите резервную модель, чтобы OpenClaw мог продолжать отвечать, пока провайдер ограничен по скорости. См. Models и OAuth.

Поддерживается ли AWS Bedrock

Да — через провайдера Amazon Bedrock (Converse) от pi-ai с ручной конфигурацией. Вы должны предоставить учетные данные AWS/регион на хосте gateway и добавить запись провайдера Bedrock в вашу конфигурацию моделей. См. Amazon Bedrock и Model providers. Если вы предпочитаете управляемый поток ключей, OpenAI-совместимый прокси перед Bedrock все еще является допустимым вариантом.

Как работает аутентификация Codex

OpenClaw поддерживает OpenAI Code (Codex) через OAuth (вход ChatGPT). Мастер может запустить поток OAuth и установит модель по умолчанию на openai-codex/gpt-5.2 при необходимости. См. Model providers и Wizard.

Поддерживается ли аутентификация подписки OpenAI Codex OAuth

Да. OpenClaw полностью поддерживает подписку OpenAI Code (Codex) OAuth. Мастер онбординга может запустить поток OAuth для вас.

См. OAuth, Model providers и Wizard.

Как настроить Gemini CLI OAuth

Gemini CLI использует поток аутентификации плагина, а не client id или secret в openclaw.json.

Шаги:

  1. Включите плагин: openclaw plugins enable google-gemini-cli-auth
  2. Войдите: openclaw models auth login --provider google-gemini-cli --set-default

Это сохраняет OAuth токены в профилях аутентификации на хосте gateway. Детали: Model providers.

Подходит ли локальная модель для обычных чатов

Обычно нет. OpenClaw нуждается в большом контексте + сильной безопасности; маленькие карты усекают и протекают. Если вы должны, запустите самую большую сборку MiniMax M2.1, которую можете локально (LM Studio) и см. /gateway/local-models. Меньшие/квантизованные модели увеличивают риск инъекции промптов — см. Security.

Как сохранить трафик хостинг модели в конкретном регионе

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

Нужно ли мне покупать Mac Mini для установки

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

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

Документация: iMessage, Nodes, Mac remote mode.

Нужен ли мне Mac mini для поддержки iMessage

Вам нужно какое-то устройство macOS, вошедшее в Messages. Это не обязательно должен быть Mac mini — подойдет любой Mac. Интеграции iMessage OpenClaw работают на macOS (BlueBubbles или imsg), в то время как Gateway может работать в другом месте.

Общие настройки:

  • Запустите Gateway на Linux/VPS и укажите channels.imessage.cliPath на SSH-обертку, которая запускает imsg на Mac.
  • Запустите все на Mac, если вы хотите простейшую настройку на одной машине.

Документация: iMessage, BlueBubbles, Mac remote mode.

Если я куплю Mac mini для запуска OpenClaw смогу ли я подключить его к MacBook Pro

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

Общая схема:

  • Gateway на Mac mini (постоянно работающий).
  • MacBook Pro запускает приложение macOS или хост узла и соединяется с Gateway.
  • Используйте openclaw nodes status / openclaw nodes list, чтобы увидеть его.

Документация: Nodes, Nodes CLI.

Могу ли я использовать Bun

Bun не рекомендуется. Мы видим ошибки во время выполнения, особенно с WhatsApp и Telegram. Используйте Node для стабильных gateway.

Если вы все еще хотите экспериментировать с Bun, делайте это на непродакшн gateway без WhatsApp/Telegram.

Telegram что указывать в allowFrom

channels.telegram.allowFrom — это Telegram user ID человека-отправителя (числовой, рекомендуется) или @username. Это не имя пользователя бота.

Безопаснее (без стороннего бота):

  • Отправьте сообщение вашему боту, затем запустите openclaw logs --follow и прочитайте from.id.

Официальное Bot API:

  • Отправьте сообщение вашему боту, затем вызовите https://api.telegram.org/bot<bot_token>/getUpdates и прочитайте message.from.id.

Сторонние (менее приватные):

  • Отправьте сообщение @userinfobot или @getidsbot.

См. /channels/telegram.

Могут ли несколько человек использовать один номер WhatsApp с разными экземплярами OpenClaw

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

Могу ли я запустить агента быстрый чат и агента Opus для кодинга

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

Работает ли Homebrew на Linux

Да. Homebrew поддерживает Linux (Linuxbrew). Быстрая настройка:

/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, разрешались в non-login оболочках. Недавние сборки также добавляют распространенные пользовательские bin каталоги на Linux systemd сервисах (например, ~/.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 установкой

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

Документация: Getting started, Updating.

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

Да. Установите другой вариант, затем запустите Doctor, чтобы сервис gateway указывал на новую точку входа. Это не удаляет ваши данные — это только изменяет установку кода OpenClaw. Ваше состояние (~/.openclaw) и рабочее пространство (~/.openclaw/workspace) остаются нетронутыми.

С npm → git:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
openclaw doctor
openclaw gateway restart

С git → npm:

npm install -g openclaw@latest
openclaw doctor
openclaw gateway restart

Doctor обнаруживает несоответствие точки входа сервиса gateway и предлагает переписать конфигурацию сервиса для соответствия текущей установке (используйте --repair в автоматизации).

Советы по резервному копированию: см. Backup strategy.

Стоит ли запускать Gateway на моем ноутбуке или на VPS

Краткий ответ: если вы хотите надежность 24/7, используйте VPS. Если вы хотите наименьшее трение и вам подходит сон/перезапуски, запускайте локально.

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

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

VPS / облако

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

Специфично для OpenClaw: WhatsApp/Telegram/Slack/Mattermost (plugin)/Discord все хорошо работают с VPS. Единственный реальный компромисс — это headless браузер vs видимое окно. См. Browser.

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

Насколько важно запускать OpenClaw на выделенной машине

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

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

Если вы хотите лучшее из обоих миров, держите Gateway на выделенном хосте и соедините ваш ноутбук как узел для локального экрана/камеры/exec инструментов. См. Nodes. Для руководства по безопасности прочитайте Security.

Каковы минимальные требования к VPS и рекомендуемая ОС

OpenClaw легкий. Для базового Gateway + один канал чата:

  • Абсолютный минимум: 1 vCPU, 1GB RAM, ~500MB диска.
  • Рекомендуется: 1-2 vCPU, 2GB RAM или больше для запаса (логи, медиа, несколько каналов). Инструменты узлов и автоматизация браузера могут быть ресурсоемкими.

ОС: используйте Ubuntu LTS (или любой современный Debian/Ubuntu). Путь установки Linux лучше всего протестирован там.

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

Могу ли я запустить OpenClaw в VM и каковы требования

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

Базовое руководство:

  • Абсолютный минимум: 1 vCPU, 1GB RAM.
  • Рекомендуется: 2GB RAM или больше, если вы запускаете несколько каналов, автоматизацию браузера или медиа-инструменты.
  • ОС: Ubuntu LTS или другой современный Debian/Ubuntu.

Если вы на Windows, WSL2 — это самый простой стиль настройки VM и имеет лучшую совместимость инструментов. См. Windows, VPS hosting. Если вы запускаете macOS в VM, см. macOS VM.

Что такое OpenClaw?

Что такое OpenClaw одним абзацем

OpenClaw — это личный AI-ассистент, который вы запускаете на своих собственных устройствах. Он отвечает на поверхностях обмена сообщениями, которые вы уже используете (WhatsApp, Telegram, Slack, Mattermost (plugin), Discord, Google Chat, Signal, iMessage, WebChat), а также может делать голос + живой Canvas на поддерживаемых платформах. Gateway — это постоянно работающая плоскость управления; ассистент — это продукт.

В чем ценностное предложение

OpenClaw — это не "просто обертка Claude". Это локально-первая плоскость управления, которая позволяет вам запускать способного ассистента на вашем собственном оборудовании, доступного из приложений чата, которые вы уже используете, с сохранением состояния сессий, памятью и инструментами — без передачи контроля над вашими рабочими процессами хостингу SaaS.

Основное:

  • Ваши устройства, ваши данные: запускайте Gateway где хотите (Mac, Linux, VPS) и держите рабочее пространство + историю сессий локально.
  • Реальные каналы, а не веб-песочница: WhatsApp/Telegram/Slack/Discord/Signal/iMessage/и т.д., плюс мобильный голос и Canvas на поддерживаемых платформах.
  • Модель-агностик: используйте Anthropic, OpenAI, MiniMax, OpenRouter и т.д., с маршрутизацией по агентам и переключением.
  • Локальная опция: запускайте локальные модели, чтобы все данные могли оставаться на вашем устройстве, если хотите.
  • Маршрутизация мультиагента: отдельные агенты для каждого канала, аккаунта или задачи, каждый со своим рабочим пространством и значениями по умолчанию.
  • Открытый исходный код и хакабельный: проверяйте, расширяйте и самостоятельно хостите без блокировки вендора.

Документация: Gateway, Channels, Multi-agent, Memory.

Я только что настроил что делать в первую очередь

Хорошие первые проекты:

  • Создать веб-сайт (WordPress, Shopify или простой статический сайт).
  • Прототип мобильного приложения (план, экраны, план API).
  • Организовать файлы и папки (очистка, именование, тегирование).
  • Подключить Gmail и автоматизировать резюме или последующие действия.

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

Каковы пять главных повседневных сценариев использования OpenClaw

Повседневные победы обычно выглядят так:

  • Личные брифинги: резюме входящих, календаря и новостей, о которых вы заботитесь.
  • Исследование и черновики: быстрое исследование, резюме и первые черновики для писем или документов.
  • Напоминания и последующие действия: nudges и чек-листы, управляемые cron или heartbeat.
  • Автоматизация браузера: заполнение форм, сбор данных и повторяющиеся веб-задачи.
  • Координация между устройствами: отправьте задачу с вашего телефона, пусть Gateway запустит её на сервере и получите результат обратно в чате.

Может ли OpenClaw помочь с лидогенерацией рекламой и блогами для SaaS

Да для исследования, квалификации и черновиков. Он может сканировать сайты, создавать короткие списки, резюмировать проспектов и писать черновики рекламы или обращения.

Для обращения или запуска рекламы держите человека в цикле. Избегайте спама, следуйте местным законам и политикам платформ и проверяйте всё перед отправкой. Самый безопасный шаблон — позволить OpenClaw составить черновик, а вы одобряете.

Документация: Security.

Какие преимущества по сравнению с Claude Code для веб разработки

OpenClaw — это личный ассистент и координационный слой, а не замена IDE. Используйте Claude Code или Codex для быстрейшего прямого цикла кодирования внутри репозитория. Используйте OpenClaw, когда вы хотите долговременную память, доступ между устройствами и оркестрацию инструментов.

Преимущества:

  • Постоянная память + рабочее пространство между сессиями
  • Мультиплатформенный доступ (WhatsApp, Telegram, TUI, WebChat)
  • Оркестрация инструментов (браузер, файлы, планирование, хуки)
  • Постоянно работающий Gateway (запуск на VPS, взаимодействие откуда угодно)
  • Узлы для локального браузера/экрана/камеры/exec

Showcase: https://openclaw.ai/showcase

Навыки и автоматизация

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

Используйте управляемые переопределения вместо редактирования копии репозитория. Поместите ваши изменения в ~/.openclaw/skills/<name>/SKILL.md (или добавьте папку через skills.load.extraDirs в ~/.openclaw/openclaw.json). Приоритет: <workspace>/skills > ~/.openclaw/skills > встроенные, поэтому управляемые переопределения выигрывают без касания git. Только upstream-worthy правки должны жить в репозитории и выходить как PR.

Могу ли я загружать навыки из пользовательской папки

Да. Добавьте дополнительные каталоги через skills.load.extraDirs в ~/.openclaw/openclaw.json (наименьший приоритет). Приоритет по умолчанию остается: <workspace>/skills → ~/.openclaw/skills → встроенные → skills.load.extraDirs. clawdhub устанавливает в ./skills по умолчанию, что OpenClaw рассматривает как <workspace>/skills.

Как использовать разные модели для разных задач

Сегодня поддерживаемые паттерны:

  • Cron задания: изолированные задания могут устанавливать переопределение model для каждого задания.
  • Подагенты: направляйте задачи отдельным агентам с разными моделями по умолчанию.
  • Переключение по требованию: используйте /model для переключения модели текущей сессии в любое время.

См. Cron jobs, Multi-Agent Routing и Slash commands.

Бот зависает во время тяжелой работы Как разгрузить это

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

Попросите вашего бота "породить подагента для этой задачи" или используйте /subagents. Используйте /status в чате, чтобы увидеть, что Gateway делает прямо сейчас (и занят ли он).

Совет по токенам: длительные задачи и подагенты оба потребляют токены. Если стоимость является проблемой, установите более дешевую модель для подагентов через agents.defaults.subagents.model.

Документация: Sub-agents.

Cron или напоминания не срабатывают Что проверить

Cron работает внутри процесса Gateway. Если Gateway не работает непрерывно, запланированные задания не будут выполняться.

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

  • Подтвердите, что cron включен (cron.enabled) и OPENCLAW_SKIP_CRON не установлен.
  • Проверьте, что Gateway работает 24/7 (нет сна/перезапусков).
  • Проверьте настройки часового пояса для задания (--tz vs часовой пояс хоста).

Отладка:

openclaw cron run <jobId> --force
openclaw cron runs --id <jobId> --limit 50

Документация: Cron jobs, Cron vs Heartbeat.

Как установить навыки на Linux

Используйте ClawdHub (CLI) или бросьте навыки в ваше рабочее пространство. UI навыков macOS недоступен на Linux. Просматривайте навыки на https://clawdhub.com.

Установите CLI ClawdHub (выберите один менеджер пакетов):

npm i -g clawdhub

pnpm add -g clawdhub

Может ли OpenClaw выполнять задачи по расписанию или непрерывно в фоне

Да. Используйте планировщик Gateway:

  • Cron задания для запланированных или повторяющихся задач (сохраняются при перезапусках).
  • Heartbeat для периодических проверок "основной сессии".
  • Изолированные задания для автономных агентов, которые публикуют резюме или доставляют в чаты.

Документация: Cron jobs, Cron vs Heartbeat, Heartbeat.

Могу ли я запускать навыки только для Apple macOS из Linux

Не напрямую. Навыки macOS ограничены metadata.openclaw.os плюс требуемыми бинарниками, и навыки появляются только в системном промпте, когда они допустимы на хосте Gateway. На Linux навыки только darwin (как imsg, apple-notes, apple-reminders) не загрузятся, если вы не переопределите ограничение.

У вас есть три поддерживаемых паттерна:

Вариант A - запустите Gateway на Mac (проще всего).
Запустите Gateway там, где существуют бинарники macOS, затем подключайтесь из Linux в удаленном режиме или через Tailscale. Навыки загружаются нормально, потому что хост Gateway — это macOS.

Вариант B - используйте узел macOS (без SSH).
Запустите Gateway на Linux, соедините узел macOS (приложение menubar) и установите Node Run Commands на "Always Ask" или "Always Allow" на Mac. OpenClaw может рассматривать навыки только macOS как допустимые, когда требуемые бинарники существуют на узле. Агент запускает эти навыки через инструмент nodes. Если вы выбираете "Always Ask", одобрение "Always Allow" в промпте добавляет эту команду в белый список.

Вариант C - проксируйте бинарники macOS через SSH (продвинутый).
Держите Gateway на Linux, но сделайте так, чтобы требуемые CLI бинарники разрешались в SSH-обертки, которые работают на Mac. Затем переопределите навык, чтобы разрешить Linux, чтобы он оставался допустимым.

  1. Создайте SSH-обертку для бинарника (пример: imsg): 
    #!/usr/bin/env bash
set -euo pipefail
exec ssh -T user@mac-host /opt/homebrew/bin/imsg "$@"
  2. Поместите обертку в PATH на хосте Linux (например, ~/bin/imsg).
  3. Переопределите метаданные навыка (рабочее пространство или ~/.openclaw/skills), чтобы разрешить Linux: 
    ---
name: imsg
description: iMessage/SMS CLI для листинга чатов, истории, watch и отправки.
metadata: {"openclaw":{"os":["darwin","linux"],"requires":{"bins":["imsg"]}}}
---
  4. Начните новую сессию, чтобы снимок навыков обновился.

Конкретно для iMessage, вы также можете указать channels.imessage.cliPath на SSH-обертку (OpenClaw нужно только stdio). См. iMessage.

Есть ли интеграция с Notion или HeyGen

Не встроена сегодня.

Варианты:

  • Пользовательский навык / плагин: лучше всего для надежного доступа к API (Notion/HeyGen оба имеют API).
  • Автоматизация браузера: работает без кода, но медленнее и более хрупко.

Если вы хотите держать контекст для каждого клиента (рабочие процессы агентства), простой паттерн:

  • Одна страница Notion для каждого клиента (контекст + предпочтения + активная работа).
  • Попросите агента получить эту страницу в начале сессии.

Если вы хотите нативную интеграцию, откройте запрос на функцию или создайте навык, нацеленный на эти API.

Установите навыки:

clawdhub install <skill-slug>
clawdhub update --all

ClawdHub устанавливает в ./skills под вашим текущим каталогом (или возвращается к вашему настроенному рабочему пространству OpenClaw); OpenClaw рассматривает это как <workspace>/skills в следующей сессии. Для общих навыков между агентами поместите их в ~/.openclaw/skills/<name>/SKILL.md. Некоторые навыки ожидают бинарники, установленные через Homebrew; на Linux это означает Linuxbrew (см. запись FAQ Homebrew Linux выше). См. Skills и ClawdHub.

Как установить расширение Chrome для управления браузером

Используйте встроенный установщик, затем загрузите распакованное расширение в Chrome:

openclaw browser extension install
openclaw browser extension path

Затем Chrome → chrome://extensions → включите "Developer mode" → "Load unpacked" → выберите эту папку.

Полное руководство (включая удаленный Gateway + заметки по безопасности): Chrome extension

Если Gateway работает на той же машине, что и Chrome (настройка по умолчанию), вам обычно не нужно ничего дополнительного. Если Gateway работает в другом месте, запустите хост узла на машине браузера, чтобы Gateway мог проксировать действия браузера. Вам все еще нужно нажать кнопку расширения на вкладке, которую вы хотите контролировать (оно не подключается автоматически).

Песочница и память

Есть ли отдельная документация по песочнице

Да. См. Sandboxing. Для специфичной настройки Docker (полный gateway в Docker или образы песочницы) см. Docker.

Могу ли я держать личные сообщения приватными но сделать группы публичными в песочнице с одним агентом

Да — если ваш приватный трафик — это личные сообщения, а ваш публичный трафик — это группы.

Используйте agents.defaults.sandbox.mode: "non-main", чтобы сессии группы/канала (ключи non-main) работали в Docker, в то время как основная сессия личных сообщений остается на хосте. Затем ограничьте, какие инструменты доступны в песочнице сессиях через tools.sandbox.tools.

Пошаговое руководство + пример конфигурации: Groups: personal DMs + public groups

Ключевая справка по конфигурации: Gateway configuration

Как привязать папку хоста в песочницу

Установите agents.defaults.sandbox.docker.binds в ["host:path:mode"] (например, "/home/user/src:/src:ro"). Глобальные + привязки для каждого агента объединяются; привязки для каждого агента игнорируются, когда scope: "shared". Используйте :ro для всего чувствительного и помните, что привязки обходят стены файловой системы песочницы. См. Sandboxing и Sandbox vs Tool Policy vs Elevated для примеров и заметок по безопасности.

Как работает память

Память OpenClaw — это просто файлы Markdown в рабочем пространстве агента:

  • Ежедневные заметки в memory/YYYY-MM-DD.md
  • Кураторские долгосрочные заметки в MEMORY.md (только основные/приватные сессии)

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

Память постоянно забывает вещи Как сделать их постоянными

Попросите бота записать факт в память. Долгосрочные заметки принадлежат MEMORY.md, краткосрочный контекст идет в memory/YYYY-MM-DD.md.

Это все еще область, которую мы улучшаем. Помогает напомнить модели хранить воспоминания; она будет знать, что делать. Если она продолжает забывать, проверьте, что Gateway использует то же рабочее пространство при каждом запуске.

Документация: Memory, Agent workspace.

Память сохраняется навсегда Каковы ограничения

Файлы памяти живут на диске и сохраняются, пока вы их не удалите. Ограничение — ваше хранилище, а не модель. Контекст сессии все еще ограничен окном контекста модели, поэтому длинные разговоры могут компактироваться или усекаться. Вот почему существует поиск в памяти — он вытягивает только релевантные части обратно в контекст.

Документация: Memory, Context.

Требует ли семантический поиск в памяти API ключ OpenAI

Только если вы используете embeddings OpenAI. Codex OAuth покрывает chat/completions и не предоставляет доступ к embeddings, поэтому вход с Codex (OAuth или CLI вход Codex) не помогает для семантического поиска в памяти. OpenAI embeddings все еще нуждаются в настоящем API-ключе (OPENAI_API_KEY или models.providers.openai.apiKey).

Если вы не устанавливаете провайдера явно, OpenClaw автоматически выбирает провайдера, когда может разрешить API-ключ (профили аутентификации, models.providers.*.apiKey или переменные окружения). Он предпочитает OpenAI, если ключ OpenAI разрешается, иначе Gemini, если ключ Gemini разрешается. Если ни один ключ недоступен, поиск в памяти остается отключенным, пока вы его не настроите. Если у вас настроен и присутствует путь к локальной модели, OpenClaw предпочитает local.

Если вы предпочитаете оставаться локальным, установите memorySearch.provider = "local" (и опционально memorySearch.fallback = "none"). Если вы хотите Gemini embeddings, установите memorySearch.provider = "gemini" и предоставьте GEMINI_API_KEY (или memorySearch.remote.apiKey). Мы поддерживаем OpenAI, Gemini или локальные модели embeddings — см. Memory для деталей настройки.

Где что хранится на диске

Все ли данные используемые с OpenClaw сохраняются локально

Нет — состояние OpenClaw локально, но внешние сервисы все еще видят, что вы им отправляете.

  • Локально по умолчанию: сессии, файлы памяти, конфигурация и рабочее пространство живут на хосте Gateway (~/.openclaw + ваш каталог рабочего пространства).
  • Удаленно по необходимости: сообщения, которые вы отправляете провайдерам моделей (Anthropic/OpenAI/и т.д.), идут к их API, а платформы чата (WhatsApp/Telegram/Slack/и т.д.) хранят данные сообщений на своих серверах.
  • Вы контролируете след: использование локальных моделей держит промпты на вашей машине, но трафик канала все еще идет через серверы канала.

Связанное: Agent workspace, Memory.

Где OpenClaw хранит свои данные

Всё живет под $OPENCLAW_STATE_DIR (по умолчанию: ~/.openclaw):

ПутьНазначение
$OPENCLAW_STATE_DIR/openclaw.jsonОсновная конфигурация (JSON5)
$OPENCLAW_STATE_DIR/credentials/oauth.jsonУнаследованный импорт OAuth (скопирован в профили аутентификации при первом использовании)
$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth-profiles.jsonПрофили аутентификации (OAuth + API-ключи)
$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth.jsonКеш аутентификации во время выполнения (управляется автоматически)
$OPENCLAW_STATE_DIR/credentials/Состояние провайдера (например, whatsapp/<accountId>/creds.json)
$OPENCLAW_STATE_DIR/agents/Состояние для каждого агента (agentDir + сессии)
$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/История разговоров & состояние (для каждого агента)
$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/sessions.jsonМетаданные сессий (для каждого агента)

Унаследованный путь одного агента: ~/.openclaw/agent/* (мигрировано openclaw doctor).

Ваше рабочее пространство (AGENTS.md, файлы памяти, навыки и т.д.) отдельно и настраивается через agents.defaults.workspace (по умолчанию: ~/.openclaw/workspace).

Где должны находиться AGENTSmd SOULmd USERmd MEMORYmd

Эти файлы живут в рабочем пространстве агента, а не в ~/.openclaw.

  • Рабочее пространство (для каждого агента): AGENTS.md, SOUL.md, IDENTITY.md, USER.md, MEMORY.md (или memory.md), memory/YYYY-MM-DD.md, опциональный HEARTBEAT.md.
  • Каталог состояния (~/.openclaw): конфигурация, учетные данные, профили аутентификации, сессии, логи и общие навыки (~/.openclaw/skills).

Рабочее пространство по умолчанию — ~/.openclaw/workspace, настраивается через:

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } }
}

Если бот "забывает" после перезапуска, подтвердите, что Gateway использует то же рабочее пространство при каждом запуске (и помните: удаленный режим использует рабочее пространство хоста gateway, а не вашего локального ноутбука).

Совет: если вы хотите долговременное поведение или предпочтение, попросите бота записать его в AGENTS.md или MEMORY.md, а не полагаться на историю чата.

См. Agent workspace и Memory.

Какая рекомендуемая стратегия резервного копирования

Поместите ваше рабочее пространство агента в приватный git репозиторий и сделайте резервную копию где-то приватно (например, приватный GitHub). Это захватывает память + файлы AGENTS/SOUL/USER и позволяет вам восстановить "разум" ассистента позже.

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

Документация: Agent workspace.

Как полностью удалить OpenClaw

См. выделенное руководство: Uninstall.

Могут ли агенты работать вне рабочего пространства

Да. Рабочее пространство — это cwd по умолчанию и якорь памяти, а не жесткая песочница. Относительные пути разрешаются внутри рабочего пространства, но абсолютные пути могут получить доступ к другим локациям хоста, если песочница не включена. Если вам нужна изоляция, используйте agents.defaults.sandbox или настройки песочницы для каждого агента. Если вы хотите, чтобы репозиторий был рабочим каталогом по умолчанию, укажите workspace этого агента на корень репозитория. Репозиторий OpenClaw — это просто исходный код; держите рабочее пространство отдельно, если вы не хотите намеренно, чтобы агент работал внутри него.

Пример (репозиторий как cwd по умолчанию):

{
  agents: {
    defaults: {
      workspace: "~/Projects/my-repo"
    }
  }
}

Я в удаленном режиме где хранилище сессий

Состояние сессии принадлежит хосту gateway. Если вы в удаленном режиме, хранилище сессий, о котором вы заботитесь, находится на удаленной машине, а не на вашем локальном ноутбуке. См. Session management.

Основы конфигурации

Какой формат конфигурации Где она находится

OpenClaw читает опциональную конфигурацию JSON5 из $OPENCLAW_CONFIG_PATH (по умолчанию: ~/.openclaw/openclaw.json):

$OPENCLAW_CONFIG_PATH

Если файл отсутствует, он использует безопасные значения по умолчанию (включая рабочее пространство по умолчанию ~/.openclaw/workspace).

Я установил gatewaybind lan или tailnet и теперь ничего не слушает UI говорит unauthorized

Non-loopback привязки требуют аутентификации. Настройте gateway.auth.mode + gateway.auth.token (или используйте OPENCLAW_GATEWAY_TOKEN).

{
  gateway: {
    bind: "lan",
    auth: {
      mode: "token",
      token: "replace-me"
    }
  }
}

Примечания:

  • gateway.remote.token только для удаленных CLI вызовов; он не включает локальную аутентификацию gateway.
  • Control UI аутентифицируется через connect.params.auth.token (сохраняется в настройках app/UI). Избегайте размещения токенов в URL.

Почему мне теперь нужен токен на localhost

Мастер генерирует токен gateway по умолчанию (даже на loopback), поэтому локальные WS клиенты должны аутентифицироваться. Это блокирует другие локальные процессы от вызова Gateway. Вставьте токен в настройки Control UI (или конфигурацию вашего клиента) для подключения.

Если вы действительно хотите открытый loopback, удалите gateway.auth из вашей конфигурации. Doctor может сгенерировать токен для вас в любое время: openclaw doctor --generate-gateway-token.

Нужно ли перезапускать после изменения конфигурации

Gateway следит за конфигурацией и поддерживает горячую перезагрузку:

  • gateway.reload.mode: "hybrid" (по умолчанию): горячее применение безопасных изменений, перезапуск для критических
  • hot, restart, off также поддерживаются

Как включить веб поиск и веб загрузку

web_fetch работает без API-ключа. web_search требует API-ключ Brave Search. Рекомендуется: запустите openclaw configure --section web, чтобы сохранить его в tools.web.search.apiKey. Альтернатива окружения: установите BRAVE_API_KEY для процесса Gateway.

{
  tools: {
    web: {
      search: {
        enabled: true,
        apiKey: "BRAVE_API_KEY_HERE",
        maxResults: 5
      },
      fetch: {
        enabled: true
      }
    }
  }
}

Примечания:

  • Если вы используете белые списки, добавьте web_search/web_fetch или group:web.
  • web_fetch включен по умолчанию (если явно не отключен).
  • Демоны читают переменные окружения из ~/.openclaw/.env (или среды сервиса).

Документация: Web tools.

Как запустить центральный Gateway со специализированными воркерами на разных устройствах

Общий паттерн — один Gateway (например, Raspberry Pi) плюс узлы и агенты:

  • Gateway (центральный): владеет каналами (Signal/WhatsApp), маршрутизацией и сессиями.
  • Узлы (устройства): Mac/iOS/Android подключаются как периферия и предоставляют локальные инструменты (system.run, canvas, camera).
  • Агенты (воркеры): отдельные мозги/рабочие пространства для специальных ролей (например, "Hetzner ops", "Personal data").
  • Подагенты: порождают фоновую работу от основного агента, когда вы хотите параллелизм.
  • TUI: подключайтесь к Gateway и переключайте агентов/сессии.

Документация: Nodes, Remote access, Multi-Agent Routing, Sub-agents, TUI.

Может ли браузер OpenClaw работать в безголовом режиме

Да. Это опция конфигурации:

{
  browser: { headless: true },
  agents: {
    defaults: {
      sandbox: { browser: { headless: true } }
    }
  }
}

По умолчанию false (headful). Headless с большей вероятностью вызовет анти-бот проверки на некоторых сайтах. См. Browser.

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

  • Нет видимого окна браузера (используйте скриншоты, если нужны визуалы).
  • Некоторые сайты строже к автоматизации в headless режиме (CAPTCHA, анти-бот). Например, X/Twitter часто блокирует headless сессии.

Как использовать Brave для управления браузером

Установите browser.executablePath на ваш Brave бинарник (или любой браузер на базе Chromium) и перезапустите Gateway. См. полные примеры конфигурации в Browser.

Удаленные gateway узлы

Как команды передаются между Telegram gateway и узлами

Сообщения Telegram обрабатываются gateway. Gateway запускает агента и только затем вызывает узлы через Gateway WebSocket, когда нужен инструмент узла:

Telegram → Gateway → Agent → node.* → Node → Gateway → Telegram

Узлы не видят входящий трафик провайдера; они только получают RPC вызовы узлов.

Как мой агент может получить доступ к моему компьютеру если Gateway размещен удаленно

Краткий ответ: соедините ваш компьютер как узел. Gateway работает в другом месте, но может вызывать инструменты node.* (экран, камера, система) на вашей локальной машине через Gateway WebSocket.

Типичная настройка:

  1. Запустите Gateway на постоянно работающем хосте (VPS/домашний сервер).
  2. Поместите хост Gateway + ваш компьютер в один tailnet.
  3. Убедитесь, что Gateway WS доступен (tailnet bind или SSH туннель).
  4. Откройте приложение macOS локально и подключитесь в режиме Remote over SSH (или прямой tailnet), чтобы оно могло зарегистрироваться как узел.
  5. Одобрите узел на Gateway: 
    openclaw nodes pending
openclaw nodes approve <requestId>

Отдельный TCP мост не требуется; узлы подключаются через Gateway WebSocket.

Напоминание о безопасности: сопряжение узла macOS разрешает system.run на этой машине. Соединяйте только устройства, которым доверяете, и просмотрите Security.

Документация: Nodes, Gateway protocol, macOS remote mode, Security.

Tailscale подключен но ответов нет Что делать

Проверьте основы:

  • Gateway работает: openclaw gateway status
  • Здоровье Gateway: openclaw status
  • Здоровье канала: openclaw channels status

Затем проверьте аутентификацию и маршрутизацию:

  • Если вы используете Tailscale Serve, убедитесь, что gateway.auth.allowTailscale установлен правильно.
  • Если вы подключаетесь через SSH туннель, подтвердите, что локальный туннель работает и указывает на правильный порт.
  • Подтвердите, что ваши белые списки (личные сообщения или группа) включают ваш аккаунт.

Документация: Tailscale, Remote access, Channels.

Могут ли два экземпляра OpenClaw общаться друг с другом локальный VPS

Да. Нет встроенного "бот-к-боту" моста, но вы можете связать это несколькими надежными способами:

Проще всего: используйте обычный канал чата, к которому оба бота имеют доступ (Telegram/Slack/WhatsApp). Пусть Бот A отправит сообщение Боту B, затем пусть Бот B ответит как обычно.

CLI мост (универсальный): запустите скрипт, который вызывает другой Gateway с openclaw agent --message ... --deliver, нацеленный на чат, где слушает другой бот. Если один бот на удаленном VPS, укажите ваш CLI на этот удаленный Gateway через SSH/Tailscale (см. Remote access).

Пример паттерна (запустить с машины, которая может достичь целевого Gateway):

openclaw agent --message "Привет от локального бота" --deliver --channel telegram --reply-to <chat-id>

Совет: добавьте ограждение, чтобы два бота не зациклились бесконечно (только упоминание, белые списки каналов или правило "не отвечать на сообщения ботов").

Документация: Remote access, Agent CLI, Agent send.

Нужны ли отдельные VPS для нескольких агентов

Нет. Один Gateway может хостить несколько агентов, каждый со своим рабочим пространством, значениями моделей по умолчанию и маршрутизацией. Это обычная настройка, и она намного дешевле и проще, чем запуск одного VPS на агента.

Используйте отдельные VPS только когда вам нужна жесткая изоляция (границы безопасности) или очень разные конфигурации, которые вы не хотите делить. В противном случае держите один Gateway и используйте несколько агентов или подагентов.

Есть ли преимущество в использовании узла на личном ноутбуке вместо SSH с VPS

Да — узлы — это первоклассный способ достичь вашего ноутбука с удаленного Gateway, и они разблокируют больше, чем доступ к оболочке. Gateway работает на macOS/Linux (Windows через WSL2) и легкий (маленький VPS или Raspberry Pi-класса коробка в порядке; 4 GB RAM достаточно), поэтому распространенная настройка — постоянно работающий хост плюс ваш ноутбук как узел.

  • Входящий SSH не требуется. Узлы подключаются к Gateway WebSocket и используют сопряжение устройств.
  • Безопаснее контроль выполнения. system.run ограничен белыми списками/одобрениями узлов на этом ноутбуке.
  • Больше инструментов устройства. Узлы предоставляют canvas, camera и screen в дополнение к system.run.
  • Локальная автоматизация браузера. Держите Gateway на VPS, но запускайте Chrome локально и ретранслируйте управление с расширением Chrome + хостом узла на ноутбуке.

SSH подходит для специального доступа к оболочке, но узлы проще для текущих рабочих процессов агентов и автоматизации устройств.

Документация: Nodes, Nodes CLI, Chrome extension.

Стоит ли устанавливать на второй ноутбук или просто добавить узел

Если вам нужны только локальные инструменты (экран/камера/exec) на втором ноутбуке, добавьте его как узел. Это держит один Gateway и избегает дублированной конфигурации. Локальные инструменты узлов в настоящее время только macOS, но мы планируем расширить их на другие ОС.

Установите второй Gateway только когда вам нужна жесткая изоляция или два полностью отдельных бота.

Документация: Nodes, Nodes CLI, Multiple gateways.

Запускают ли узлы сервис gateway

Нет. Только один gateway должен работать на хост, если вы не запускаете намеренно изолированные профили (см. Multiple gateways). Узлы — это периферия, которая подключается к gateway (узлы iOS/Android или macOS "режим узла" в приложении menubar). Для headless хостов узлов и управления CLI см. Node host CLI.

Полный перезапуск требуется для изменений gateway, discovery и canvasHost.

Есть ли API RPC способ применить конфигурацию

Да. config.apply проверяет + записывает полную конфигурацию и перезапускает Gateway как часть операции.

configapply стерла мою конфигурацию Как восстановить и избежать этого

config.apply заменяет всю конфигурацию. Если вы отправляете частичный объект, всё остальное удаляется.

Восстановление:

  • Восстановите из резервной копии (git или скопированный ~/.openclaw/openclaw.json).
  • Если у вас нет резервной копии, перезапустите openclaw doctor и пересконфигурируйте каналы/модели.
  • Если это было неожиданно, подайте баг и включите вашу последнюю известную конфигурацию или любую резервную копию.
  • Локальный агент кодирования часто может реконструировать рабочую конфигурацию из логов или истории.

Избегайте этого:

  • Используйте openclaw config set для небольших изменений.
  • Используйте openclaw configure для интерактивных правок.

Документация: Config, Configure, Doctor.

Какая минимальная разумная конфигурация для первой установки

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } }
}

Это устанавливает ваше рабочее пространство и ограничивает, кто может запускать бота.

Как настроить Tailscale на VPS и подключиться с Mac

Минимальные шаги:

  1. Установите + войдите на VPS 
    curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
  2. Установите + войдите на вашем Mac
    • Используйте приложение Tailscale и войдите в тот же tailnet.
  3. Включите MagicDNS (рекомендуется)
    • В консоли администратора Tailscale включите MagicDNS, чтобы VPS имел стабильное имя.
  4. Используйте tailnet hostname

Если вы хотите Control UI без SSH, используйте Tailscale Serve на VPS:

openclaw gateway --tailscale serve

Это держит gateway привязанным к loopback и предоставляет HTTPS через Tailscale. См. Tailscale.

Как подключить узел Mac к удаленному Gateway Tailscale Serve

Serve предоставляет Gateway Control UI + WS. Узлы подключаются через тот же эндпоинт Gateway WS.

Рекомендуемая настройка:

  1. Убедитесь, что VPS + Mac находятся в одном tailnet.
  2. Используйте приложение macOS в удаленном режиме (цель SSH может быть tailnet hostname). Приложение туннелирует порт Gateway и подключается как узел.
  3. Одобрите узел на gateway: 
    openclaw nodes pending
openclaw nodes approve <requestId>

Документация: Gateway protocol, Discovery,

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