Как установить OpenClaw и подключить Telegram со skills

Не начинайте с «скачать и надеяться». Сначала три опоры: правильный Node, понятная ОС и ключ модели.

Node и путь установки (CLI / installer)

Официальные требования runtime (сверяйте с docs Getting Started):

• Node.js 22.22.3+, 24.15+ или 25.9+;
• Node 26 — recommended.

Устаревшие русские пересказы иногда пишут «Node 22» или «Node 24» без минорных версий — ориентируйтесь на docs, не на чужой гайд годичной давности.

Пути установки:

1. Installer: скрипты с официального сайта OpenClaw (install.sh для macOS/Linux/WSL2, install.ps1 для Windows PowerShell) — точные команды в шаге ниже.
2. npm: npm install -g openclaw@latest.
3. Альтернативы: Docker, Nix — если так принято у вас в инфре.

Важно для Telegram: Gateway для WhatsApp/Telegram запускайте на Node. Bun для этих каналов не рекомендуют — известные сбои.

Windows, Ubuntu, Mac — где чаще ломается старт

На Windows новички часто ставят Node «с сайта», а потом в другом терминале оказывается старая версия или Bun из другого менеджера. Перед install выполните node -v и убедитесь, что версия в допустимом диапазоне.

API-ключ модели (BYOK) и локальная модель

В мастере onboard спросят провайдера и ключ. Без ключа агент «поднимется», но отвечать не сможет.

Локальная модель возможна, если железо тянет и вы настроили совместимый endpoint. Для старта бизнесу чаще проще облачный API + жёсткий контроль, кто имеет доступ к боту.

Секреты не пишите в текст skill и не кидайте в чат. Для env skills есть отдельные поля конфигурации (skills.entries.*.env в экосистеме OpenClaw) — туда, а не в промпт.

Gateway — сердце установки. Если он не слушает порт, Telegram и skills бесполезны.

Статус и перезапуск без «магии»

Базовые действия:

• статус: openclaw gateway status;
• UI: openclaw dashboard;
• если «завис» — штатный restart через ваш daemon (systemctl/launchd) или документированные команды gateway run/restart из CLI.

Не «убивайте» процесс наугад без понимания: сначала status, потом аккуратный restart, потом снова status.

Куда смотреть, если порт 18789 занят

Порт 18789 — дефолт Gateway. Если занят другим процессом:

1. выясните, кто слушает порт (ss/lsof на Linux, аналог на Windows);
2. остановите чужой сервис или смените порт в конфиге OpenClaw (если меняете — обновите закладки dashboard и любые туннели);
3. не публикуйте 18789 «в белый интернет» без необходимости.

Что нельзя светить во внешнюю сеть

Gateway token и Control UI — чувствительные вещи. Известная уязвимость CVE-2026-25253 (до патча в релизе 2026.1.29) позволяла через query string в Control UI утянуть auth token и дойти до опасной цепочки на локальном Gateway. Практический вывод:

• держите OpenClaw обновлённым (не ниже патченного релиза);
• после инцидентов/подозрительных ссылок ротируйте gateway token и API-ключи;
• не открывайте dashboard наружу без VPN/SSH-туннеля и осознанной политики доступа.

Skills — то, из‑за чего OpenClaw становится «агентом с руками», а не просто LLM в Telegram.

Чем skill отличается от «просто промпта»

Промпт в чате — разовый. Skill:

• лежит в файловой структуре workspace/агента;
• подхватывается по правилам приоритета (выше → ниже): workspace skills/ → project .agents/skills → ~/.agents/skills → managed ~/.openclaw/skills → bundled → extraDirs/plugins;
• может иметь allowlists (agents.defaults.skills) — но allowlist не заменяет sandbox и политику exec.

Поставить skill из ClawHub и проверить

Типовой поток CLI:

openclaw skills search <запрос>
openclaw skills install <имя>
openclaw skills verify <имя>
openclaw skills update

На ClawHub есть security audits (Pass / Review / Warn / Malicious). Помните: аудит ≠ гарантия. Исследования supply chain по OpenClaw/ClawHub (в т.ч. разборы Unit 42) и свежие RU-оценки (UserGate Factor): заметная доля community skills несёт риски — malware, утечка данных, эскалация прав, манипуляция поведением. Эксперты прямо говорят: опасность часто в связке элементов, а не в одной «кнопке».

Правило для новичка: не ставьте «популярное с хайпом» без чтения SKILL.md и verify. Для рискованных флагов marketplace есть отдельные acknowledge-режимы — это не «галочка безопасности», а признание риска.

Свой skill под лиды или черновик контента

Начните с workspace skill, а не с сотни community-пакетов.

Мини-идея SKILL.md для лида:

• когда срабатывает (новые сообщения с вопросом о цене/сроках);
• какие поля собрать (задача, бюджет-ориентир, контакт);
• что ответить человеку;
• что нельзя делать без подтверждения (скидки, договор, публикация).

Для черновика поста:

• вход: тема + ссылка/тезисы;
• выход: черновик в Telegram;
• HITL: «опубликовать» только после вашего «да».

Соберём рабочую картинку без зоопарка интеграций.

Схема: человек пишет Telegram-боту → Gateway принимает апдейт → модель + выбранный skill → действие (черновик/квалификация/сводка) → ответ в тот же чат → (опционально) cron/heartbeat для регулярных задач.

Сценарий «лид из чата»

1. Лид пишет: «Сколько стоит настройка автопостинга?»
2. Skill «квалификация» задаёт 3–5 уточнений.
3. Агент собирает карточку лида в сообщении вам (или в рабочий чат).
4. Коммерческое предложение — только после вашего approve (HITL).

Так ИИ агент в Telegram экономит время на первичный скрининг, но не «продаёт сам» без контроля.

Сценарий «дайджест / черновик поста»

1. Утром cron будит задачу «дайджест».
2. Агент собирает тезисы (из разрешённых источников/папки workspace).
3. Шлёт черновик поста вам в Telegram.
4. Вы правите и публикуете сами — или даёте отдельную команду на следующий контур (Make/WordPress и т.д.), если он уже настроен.

OpenClaw здесь — runtime и канал; тяжёлую многошаговую оркестрацию контент-завода можно держать рядом, не смешивая всё в один skill.

Cron/heartbeat без хаоса в логах

Советы:

• один cron = одна понятная задача с записью результата;
• heartbeat не превращайте в тяжёлый парсинг всего интернета;
• логи смотрите, если «агент пишет странное в 3 ночи» — сначала расписание, потом skills.

10 пунктов перед «агент в проде»

1. Node из официального диапазона, для Telegram — не Bun.
2. openclaw onboard --install-daemon завершён, daemon жив.
3. gateway status → порт 18789 слушает.
4. Версия OpenClaw с патчами безопасности (учитывайте историю CVE Control UI).
5. Bot token только в конфиге/env, не в чатах и скриншотах.
6. Pairing/allowlists настроены; группы не «open для всех».
7. Sandbox включён; elevated — по минимуму.
8. Skills: сначала свои SKILL.md, community — после verify/audit.
9. HITL на публикацию, exec и клиентские оферты.
10. Есть план ротации gateway token и API-ключей.

Pairing не проходит / skill не виден / daemon молчит

OpenClaw — self-hosted персональный ИИ-ассистент с Gateway, каналами (Telegram и др.) и skills.

Gateway — локальный/серверный процесс OpenClaw, по умолчанию порт 18789, точка управления каналами и агентом.

Pairing — режим доступа: пользователь получает код, администратор подтверждает openclaw pairing approve telegram <CODE>; код истекает примерно за час.

Skills / ClawHub — навыки в формате SKILL.md; ClawHub — реестр community skills с установкой через CLI и аудитами (аудит не равен гарантии).

Нумерованные шаги установки:

1. Установить Node (22.22.3+ / 24.15+ / 25.9+, лучше 26).
2. Поставить OpenClaw (install.sh / install.ps1 / npm).
3. Выполнить openclaw onboard --install-daemon.
4. Проверить openclaw gateway status (порт 18789) и dashboard.
5. Создать Telegram-бота, прописать token, сделать pairing approve.
6. Добавить skill (свой SKILL.md или проверенный ClawHub).
7. Включить sandbox, настроить HITL, обновить до безопасной версии.

Кому подходит: предпринимателям, маркетологам и контент-командам, кому нужен ИИ-агент в Telegram под контролем, с skills и расписанием.

Кому нет: тем, кто хочет только no-code холст без сервера; тем, кто не готов обслуживать runtime и security.