Одна команда установки и один токен бота: настройка OpenClaw 2.0 для тех, кто никогда не запускал агента

Официальные цифры по установке OpenClaw невзрачны в самом хорошем смысле. Скрипт установки занимает 2–5 минут. Онбординг QuickStart занимает «несколько минут». Потом вы набираете openclaw dashboard, открывается вкладка браузера, вы пишете сообщение — и что-то отвечает.

Значит, сложное — не установка. Сложное — следующая неделя: решить, к чему этой штуке можно прикасаться, что у неё просить и что делать, когда она молчит, а вы понятия не имеете почему.

Это практическое дополнение к нашему разбору того, что на самом деле изменил релиз 2.0. Здесь нет анализа, только процедура: что подготовить, какие именно команды вводить, о чём и в каком порядке спрашивает новый управляемый онбординг, как подключить Telegram, три первые задачи правильного размера, права, которые стоит выставить в первый день, и пять сбоев, на которые действительно натыкаются новые установки. Каждая команда ниже взята из официальной документации OpenClaw, полученной 1 сентября 2026 года. Там, где документация молчит, это руководство так и говорит, а не догадывается.

Коротко:

• Нужны Node.js 22.22.3+, 24.15+ или 25.9+ (рекомендуется Node 26) и один источник ИИ: уже существующий вход в Claude или ChatGPT, ключ API либо локальная модель.
• Путь новичка — одна строка: curl -fsSL https://openclaw.ai/install.sh | bash — она поставит Node, если его нет, и сама запустит онбординг.
• Управляемый онбординг 2.0 сначала пытается переиспользовать доступ к ИИ, который у вас уже есть, и не сохраняет маршрут модели, пока реальный completion не отработает успешно. Одно это изменение убирает самый частый способ, которым старые установки тихо ломались.

Шаги с 1 по 4 — это описанный в документации быстрый старт. Источник: OpenClaw «Getting started» и «Install», получено 1 сентября 2026 года.

Что нужно, прежде чем что-либо набирать

Три предварительных условия, и только одно требует решения.

Поддерживаемая версия Node.js. На странице установки указаны Node 22.22.3+, 24.15+ или 25.9+, рекомендуется Node 26. Проверьте свою версию командой node --version. Если Node нет вовсе, установщик поставит его сам — Node 26 на macOS и Node 24 LTS на Linux.

Машина, которая не засыпает. Работают и macOS, и Linux, и Windows. Документация формулирует компромисс прямо: ноутбук — вариант с наименьшим трением, он даёт агенту прямой доступ к локальным файлам и видимое окно браузера, но сон, обрывы сети и обновления системы прерывают работу. Небольшой сервер работает всегда, но у него нет экрана. Задокументированный минимум для VPS — 1 vCPU, 1 ГБ ОЗУ и около 500 МБ диска, рекомендуется 2 ГБ и больше для запаса. Raspberry Pi 4 с 4 ГБ вполне подходит, потому что Pi крутит только шлюз, а сама модель вызывается по сети.

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

Источник ИИ. Вот здесь решение. OpenClaw не поставляется с моделью — он к ней подключается.

Управляемая настройка находит маршрут 1 автоматически. Цены — прейскурант поставщиков, получено 1 сентября 2026 года.

Поставим на строку с ключом API настоящую цифру, потому что «оплата за токены» при выборе не говорит ничего. Возьмём тридцать обменов в день, каждый отправляет около 8 000 токенов контекста и возвращает 700. Это 240 000 входных и 21 000 выходных токенов в сутки. По прейскуранту Claude Sonnet 5 получается примерно 0,69 доллара в день, около 21 доллара в месяц. На gpt-5.6-luna — примерно 0,07 доллара в день, около 2,20 доллара в месяц. Это арифметика по опубликованным ценам, а не измеренный счёт: ваш контекст окажется больше, чем кажется, а кеширование часть вернёт. Но порядок величины задан — доллары, а не сотни долларов.

Наша рекомендация для первой установки: используйте подписку, которую и так оплачиваете, потому что управляемая настройка найдёт её без единой вставки в поле. Если подписки нет, возьмите ключ API у любого поставщика и до запуска онбординга выставьте жёсткий лимит расходов в его консоли. Локальные модели отложите: это законная цель, но плохая стартовая линия.

Установка: одна команда и две альтернативы, о которых стоит знать

Задокументированный путь для новичка — скрипт установки. Он определяет ОС, при необходимости ставит Node, ставит OpenClaw и запускает онбординг: одна команда вместо четырёх решений.

На macOS, Linux или WSL2:

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

В Windows PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex

Вот и вся установка. Про две альтернативы стоит знать, даже если сегодня они вам не нужны.

Приложения для рабочего стола — если терминал не ваша среда. У Windows есть подписанный установщик Hub, который запускается как любая программа Windows; у macOS — приложение в строке меню, распространяемое в виде .dmg в GitHub-релизах проекта. Оба умеют поднять локальный шлюз при первом запуске.

npm — если вы уже сами управляете Node. На npm 12 или npm 11.16+:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Флаг --allow-scripts=openclaw важен: npm 12 по умолчанию блокирует неодобренные lifecycle-скрипты, и без флага npm сообщает о шагах preinstall и postinstall OpenClaw как «blocked because they are not covered by allowScripts». На npm 11.15 и старше выполняйте ту же команду без флага. Docker, Podman, Nix и сборка из исходников через pnpm тоже описаны — и все они неверный выбор для вашего первого часа.

О чём управляемый онбординг 2.0 спрашивает по порядку

Именно здесь v2026.8.1 сильнее всего изменил опыт новичка, поэтому полезно знать, что вас ждёт. Обычный openclaw onboard, который установщик запускает за вас, теперь идёт по управляемому пути из шести шагов:

1. Принять уведомление о безопасности. Прочитайте его. Оно описывает модель доверия, на которую вы соглашаетесь; последний раздел этого руководства пересказывает её обычными словами.
2. Запускается обнаружение в режиме чтения. OpenClaw ищет уже настроенные модели, ключи API в переменных окружения, поддерживаемые локальные CLI для ИИ и уже установленные модели с поддержкой инструментов на доступном сервере Ollama или LM Studio. Этот проход никогда ничего не скачивает. Два задокументированных исключения: Gemini CLI и Antigravity не предлагаются как обнаруженные маршруты настройки, а установки Pi и OpenCode могут быть показаны справочно, не будучи пригодными в качестве маршрута вывода.
3. Первый кандидат проверяется реальным completion. При неудаче онбординг показывает причину и переходит к следующему кандидату, а не сохраняет сломанный маршрут.
4. Если обнаружение ничего не нашло, вы выбираете поставщика. Первое меню предлагает OpenAI, Anthropic, xAI (Grok), Google и OpenRouter, остальные — под More…, а для не перечисленной точки доступа есть Custom Provider. Второе меню показывает регионы, тарифы и поддерживаемые способы аутентификации — браузер, устройство, ключ API или токен. Каждый маршрут проходит ту же проверку реальным completion. Skip for now завершает работу.
5. Сохраняется только проверенный маршрут вместе с нужными ему учётными данными и состоянием плагинов. Рабочее пространство и настройки шлюза на этом шаге не трогаются.
6. Запускается помощник настройки с проверенной моделью и настраивает остальное в разговоре: рабочее пространство, шлюз, каналы, агентов, плагины.

Затем проверьте сами:

openclaw gateway status     # шлюз должен слушать порт 18789
openclaw dashboard          # открывает Control UI в браузере

Наберите сообщение в чате Control UI. Ответ означает, что работают все слои.

И вот главное — самое полезное, что стоит понять про 2.0: управляемый поток отказывается сохранять маршрут модели, работоспособность которого он не доказал. Поэтому повторный запуск openclaw onboard на уже настроенной установке служит проходом починки: он сначала проверяет текущую модель по умолчанию, и при неудаче никогда не подменяет её молча, а останавливается и спрашивает.

Две вещи управляемый онбординг сознательно не делает. Он не занимается настройкой удалённого шлюза, мастерами привязки каналов, управлением демоном, навыками и импортом — это живёт в классическом мастере openclaw onboard --classic. И чтобы позже сменить поставщика или способ аутентификации, вы выходите из помощника и снова запускаете openclaw onboard; разговорный помощник потоки поставщиков не открывает.

Подключаем Telegram: четыре шага и одно число, которое надо найти

Документация называет Telegram самым быстрым каналом, потому что кроме токена бота ничего не нужно. Политика личных сообщений по умолчанию — pairing, это безопасное значение и причина существования шага 3.

1. Создайте бота. В Telegram напишите @BotFather — убедитесь, что имя ровно такое — и выполните /newbot. Пройдите подсказки и сохраните токен. Есть и веб-вариант через веб-приложение BotFather, если вам ближе интерфейс.

2. Положите токен в конфигурацию — в ~/.openclaw/openclaw.json:

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc",
      dmPolicy: "pairing",
      groups: { "*": { requireMention: true } },
    },
  },
}

Переменная окружения TELEGRAM_BOT_TOKEN работает как запасной вариант, но только для аккаунта по умолчанию. Telegram не использует openclaw channels login telegram — задайте токен в конфигурации или окружении и запустите шлюз.

3. Запустите шлюз, напишите боту и одобрите самого себя:

openclaw gateway
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

Коды привязки истекают через 1 час. Если ваш просрочен, напишите боту ещё раз за новым.

4. Найдите свой числовой идентификатор пользователя Telegram и зафиксируйте его. Одобрение привязки даёт доступ только к личным сообщениям, это не всеобъемлющая авторизация. Способ из документации, бережный к приватности: напишите боту, запустите openclaw logs --follow и прочитайте from.id в строке журнала. Официальный путь через Bot API — curl "https://api.telegram.org/bot<bot_token>/getUpdates" и чтение message.from.id. Есть и сторонние боты для этого, но они менее приватны. Получив номер, для бота с единственным владельцем документация советует dmPolicy: "allowlist" и явный числовой идентификатор в channels.telegram.allowFrom, а не опору на прошлое одобрение привязки.

Группы — отдельное решение с отдельной ловушкой. Боты Telegram по умолчанию находятся в Privacy Mode, что ограничивает, какие групповые сообщения они вообще получают. Чтобы видеть всё, отключите этот режим через /setprivacy в BotFather либо сделайте бота администратором группы — и после переключения нужно удалить и заново добавить бота в каждой группе, чтобы Telegram применил изменение. В первый день группы лучше вообще пропустить.

Discord, Signal, WhatsApp, Slack, iMessage, Matrix, Microsoft Teams и ещё около двух десятков каналов поддерживаются, у каждого своя страница. Ни один не поднимается так же быстро, как токен бота.

Три первые задачи размером с неделю

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

Задача первая: одноразовое напоминание. Оно доказывает, что планировщик, модель и путь доставки работают вместе, и удаляет себя после выполнения.

openclaw automations create "2026-09-08T09:00:00Z" \
  --name "Reminder" \
  --session main \
  --system-event "Reminder: review the OpenClaw permissions I set on day one" \
  --wake now \
  --delete-after-run

Задача вторая: повторяющаяся утренняя сводка. Поле расписания принимает обычное cron-выражение, а промпт идёт вторым позиционным аргументом.

openclaw automations create "0 7 * * *" \
  "Summarize what changed in my workspace notes since yesterday." \
  --name "Morning brief"

Потом посмотрите, что у вас получилось, — чтение истории запусков и есть способ понять, что агент делал на самом деле:

openclaw automations list
openclaw automations runs --id <job-id>

Два свойства автоматизаций стоит усвоить сразу. Они выполняются внутри процесса шлюза, то есть расписания срабатывают, только пока шлюз работает: закрытый ноутбук — остановленный планировщик. И каждый запуск создаёт запись фоновой задачи, поэтому openclaw tasks list и openclaw tasks audit дают вам след для аудита, а не загадку.

Задача третья: что-нибудь на чтение по вашим же материалам. Направьте агента на его рабочее пространство и попросите пересказать, найти, сравнить. Никаких записей, почты, календаря и shell. То, чем вы заняты, — это калибровка: через неделю вы будете конкретно знать, какие запросы он выполняет отлично, а на какие уверенно отвечает неправильно. Эта калибровка и есть настоящий результат первой недели, а не автоматизации.

Что стоит придержать: описанный в документации почтовый путь, IMAP-триггер, — действительно полезный шаблон, но его собственная документация настраивает его за выделенным ограниченным агентом-читателем с tools.profile: "minimal", песочницей с workspaceAccess: "none", списком разрешённых отправителей и проверкой отправителя через DMARC. Это ровно та мера паранойи, которая уместна, когда чужой текст доходит до модели, — и это не проект первого дня.

Периметр первого дня: сначала решите, куда он дотягивается

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

Модель доверия обычными словами. Один шлюз равен одной границе доверия. Все, кто может написать агенту с инструментами, разделяют полномочия этих инструментов. Для вас это нормально, для коллег, которые и так друг другу доверяют, тоже, а вот взаимно враждебные пользователи с одним агентом — явно неподдерживаемый сценарий. Любой, кто может править файлы в ~/.openclaw, по определению доверенный оператор. Если нужно обслуживать людей, не доверяющих друг другу, задокументированный ответ — разделить шлюзы, в идеале и пользователей ОС или машины, а не искать хитрую конфигурацию.

Одна команда покажет, не съехали ли вы:

openclaw security audit
openclaw security audit --fix    # применяет только узкие безопасные исправления

Собственный порядок разбора аудита — хороший список приоритетов для новичка: сначала всё «открытое» в сочетании с включёнными инструментами, затем публичная сетевая доступность, затем доступность управления браузером, затем права на файлы, затем плагины и лишь потом выбор модели.

Что не подключать в первую неделю. Не ставьте ни одну dmPolicy в "open" — тогда любой аккаунт Telegram, нашедший или угадавший имя вашего бота, сможет им командовать. Не выставляйте шлюз за пределы loopback и не включайте Tailscale Funnel. Не включайте tools.elevated — это лаз, который выполняет команды shell вне песочницы. Не ставьте плагины, которых вы не читали. И берите самую сильную современную модель, до какой дотягиваетесь: документация прямо говорит, что более слабые и чрезмерно квантованные модели легче увести prompt injection — а это начинает иметь значение ровно в тот момент, когда агент с инструментами читает чужой текст.

Начинайте с режима чтения там, где можно. Задокументированный профиль сочетает песочницу с workspaceAccess: "ro" и список запрещённых инструментов:

{
  agents: {
    entries: {
      family: {
        default: true,
        workspace: "~/.openclaw/workspace-family",
        sandbox: { mode: "all", scope: "agent", workspaceAccess: "ro" },
        tools: {
          allow: ["read"],
          deny: ["write", "edit", "apply_patch", "exec", "process", "browser"],
        },
      },
    },
  },
}

Как это остановить. Выучите эти команды до того, как они понадобятся.

openclaw gateway stop        # остановить управляемую службу
openclaw gateway restart     # перезапустить (не заменяйте связкой stop + start)
openclaw backup create       # снимок перед любой разрушительной операцией
openclaw uninstall --dry-run # увидеть, что именно удалит деинсталляция

openclaw gateway stop в неинтерактивной оболочке требует --force. На macOS он убирает LaunchAgent из текущей сессии загрузки; добавьте --disable, если остановка должна пережить перезагрузку. И порядок сдерживания, если что-то действительно пошло не так: остановить процесс, вернуть gateway.bind: "loopback", затем перевести рискованные личные сообщения в dmPolicy: "disabled" и удалить все записи "*".

Пять сбоев, на которые новички натыкаются на самом деле

openclaw: command not found после успешной установки. Почти всегда дело в PATH — глобальный каталог bin от npm не попал в PATH вашей оболочки. Диагностика: node -v, npm prefix -g и echo "$PATH". В Windows проверьте npm config get prefix, добавьте этот каталог в пользовательский PATH и переоткройте PowerShell.

Установщик будто завис. Перезапустите его с --verbose, чтобы получить настоящую обратную связь: curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --verbose. У установщика PowerShell отдельного verbose нет — оберните его в Set-PSDebug -Trace 1.

Онбординг вывел строку пробуждения, ответа нет, счётчик токенов стоит на 0. Агент вообще не запускался. Перезапустите шлюз, затем проверьте аутентификацию и журналы в таком порядке:

openclaw gateway restart
openclaw status
openclaw models status
openclaw logs --follow
openclaw doctor

Если вы пропустили настройку модели, онбординг скажет об этом пометкой «Model auth missing» — исправьте командой openclaw configure --section model.

Telegram при старте сообщает getMe returned 401. Это отказ аутентификации вашего токена бота, и ничего больше. Скопируйте заново или перевыпустите токен в BotFather и обновите channels.telegram.botToken. Сообщение deleteWebhook 401 Unauthorized при старте — тот же неверный токен, всплывший в другом вызове.

Бот игнорирует групповые сообщения. Проверьте три вещи по порядку: включён ли ещё режим приватности (BotFather /setprivacy, затем удалить и снова добавить бота), действительно ли группа перечислена в channels.telegram.groups, и какую причину пропуска выдаёт openclaw logs --follow. Отрицательные идентификаторы супергрупп, начинающиеся с -100, относятся к groups, а не к groupAllowFrom — очень частая путаница.

Когда ничего из этого не помогает, одна команда превращает состояние вашей установки в диагноз: openclaw triage выполняет проверки только на чтение, пишет очищенный промпт с найденным и предлагает передать его кодовому агенту, обнаруженному на вашей машине. Ничего не покидает машину, пока вы не выберете агента, а секреты, токены, сырые полезные нагрузки чатов и сырые журналы из промпта исключены.

Куда двигаться дальше

Пункт назначения — документация, и по ней необычайно удобно ходить: добавьте .md к любому URL страницы, чтобы получить чистый Markdown, а docs.openclaw.ai/llms.txt — это полный указатель всех страниц с однострочным описанием. В закладки первого дня стоит положить Getting started, Channels, Security и Automations. Команда openclaw docs ищет по этому указателю прямо из терминала.

Одно честное ограничение напоследок. Агенты ошибаются, а агент с инструментами совершает ошибки, которые к чему-то прикасаются. Документация OpenClaw говорит об этом прямо: текст, возвращаемый поиском, fetch, MCP, плагинами и браузером, ограничивается по объёму, нормализуется и явно помечается как недоверенный до того, как модель его увидит, — и даже тогда «модель всё ещё может поддаться влиянию враждебного материала, который она читает». Заведите привычку выдавать самое узкое право, делающее задачу возможной, и расширять периметр только тогда, когда этого требует конкретная задача.

Итог: настройка занимает восемь минут, суждение — остаток недели

Установка и правда одна команда. Онбординг и правда находит подписку, за которую вы уже платите. Чего не сделает за вас ни один установщик — это решение о том, до чего автономному процессу позволено дотягиваться от вашего имени. И именно это решение, а не установка, отделяет тех, кто получает от агента настоящую работу, от тех, кто через две недели тихо перестаёт его открывать.

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

Что вы на самом деле доверили бы программе, пока сами не смотрите?

---

Где здесь Telli.sh: агент выполняет задачи, которые вы ему передали, а Telli.sh хранит запись разговоров, которые вы ведёте с людьми. Он делает расшифровку в реальном времени, разделение говорящих и краткие сводки на базе ИИ для ваших встреч, с переводом на 44 языка и интерфейсом на 15 — чтобы решения, принятые на созвоне, оставались в виде заметки с поиском, а не воспоминания. Если ваш агент будет действовать на основании того, о чём договорилась команда, кто-то должен был сначала точно записать эту договорённость.

Начать живую заметку с ИИ

Источники

• OpenClaw — Getting started — требование Node 22.22.3+/24.15+/25.9+, команды установки, openclaw gateway status на порту 18789, openclaw dashboard и openclaw triage; получено 1 сентября 2026 года
• OpenClaw — Install — системные требования, загрузки настольных приложений, пути npm/pnpm/bun и правило --allow-scripts=openclaw для npm 12, устранение проблем с PATH; получено 1 сентября 2026 года
• OpenClaw — Onboarding (CLI) — шестишаговый управляемый поток, проверка реальным completion, меню поставщиков, исключение Gemini CLI и Antigravity, зона ответственности --classic; получено 1 сентября 2026 года
• OpenClaw — заметки о выпуске v2026.8.1 (OpenClaw 2.0) — управляемый онбординг как локальный custodian-поток, передача в браузер после настройки и пометка недоверенного внешнего содержимого; получено 1 сентября 2026 года
• OpenClaw — Telegram — /newbot в BotFather, блок конфигурации, openclaw pairing list/approve, срок действия кода в один час, режим приватности и требование заново добавить бота, правило идентификаторов -100, сигнатура getMe returned 401; получено 1 сентября 2026 года
• OpenClaw — Security — консервативные значения по умолчанию, модель одной границы доверия на шлюз, openclaw security audit и порядок разбора, профиль агента только на чтение и последовательность сдерживания; получено 1 сентября 2026 года
• OpenClaw — FAQ: first-run setup — оценка установки в 2–5 минут, переиспользование Claude CLI и оговорка о тарификации, поддержка Codex OAuth, порядок восстановления при отсутствии ответа, минимальные требования к VPS и сравнение ноутбука с сервером; получено 1 сентября 2026 года
• OpenClaw — FAQ: models and auth — рекомендация использовать сильнейшую модель для агентов с инструментами и путь настройки Ollama; получено 1 сентября 2026 года
• OpenClaw — Automations и openclaw automations — синтаксис create для разовых и cron-заданий, выполнение внутри шлюза, история запусков; получено 1 сентября 2026 года
• OpenClaw — Local models — ограничение одной GPU на 24 ГБ и предупреждение о квантованных чекпоинтах; получено 1 сентября 2026 года
• OpenClaw — openclaw gateway и openclaw uninstall — семантика остановки и перезапуска, требование --force в неинтерактивных оболочках и удаление с --dry-run; получено 1 сентября 2026 года
• Anthropic — цены на модели — Claude Sonnet 5 по 2/10 доллара за миллион токенов и Claude Opus 5 по 5/25; получено 1 сентября 2026 года
• OpenAI — цены API — gpt-5.6-luna по 0,20 доллара за вход и 1,20 за выход на миллион токенов; получено 1 сентября 2026 года
• Наш парный материал о том, что на самом деле изменил релиз OpenClaw 2.0