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

От чистой системы до агента, который отвечает вам в Telegram, — примерно полчаса. Команды взяты из официальной документации, поэтому сверьте их с версией, которую устанавливаете.

## Что понадобится

- Компьютер или VPS с macOS, Linux, WSL2 или Windows
- Node 24.16+ или Node 26: установщик может установить Node за вас
- Ключ API или подписка для доступа к модели либо локальная модель
- Аккаунт Telegram

## Пошаговая инструкция

### 1. Выберите компьютер и создайте бота

Для пробного запуска подойдёт ноутбук. Агент, который работает постоянно, лучше разместить на небольшом VPS или домашнем сервере. Порт шлюза ни в коем случае не должен быть открыт в интернет. В Telegram напишите @BotFather, предварительно внимательно проверив его имя пользователя, выполните команду /newbot и скопируйте выданный токен.

### 2. Установите OpenClaw

Запустите официальный установщик для своей системы. Он определит ОС, при необходимости установит Node, установит OpenClaw и запустит первичную настройку.

```bash
# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
```

### 3. Завершите настройку и установите службу шлюза

Выберите Quick start, чтобы использовать обнаруженные средства доступа к ИИ, или Custom setup, чтобы настроить все параметры. После завершения настройки остановите шлюз, работающий в переднем плане, и установите его как фоновую службу, чтобы он запускался снова после перезагрузки.

```bash
openclaw onboard
# after the quick start, stop the foreground gateway (Ctrl+C), then:
openclaw gateway install
```

### 4. Добавьте канал Telegram

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

```bash
openclaw channels add --channel telegram --token <bot-token>
openclaw channels status --probe
```

### 5. Подтвердите сопряжение

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

```bash
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
```

### 6. Проведите аудит и обновите систему

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

```bash
openclaw security audit
openclaw update --channel stable
```

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

- Оставьте dmPolicy в значении pairing, чтобы незнакомцы, нашедшие вашего бота, не могли им пользоваться.
- Настройте exec approvals так, чтобы система всегда запрашивала подтверждение, пока вы не убедитесь в надежности своей конфигурации.
- Регулярно повторяйте аудит безопасности и обновление.

## Распространённые ошибки

- Не открывайте порт шлюза для внешнего доступа: оставьте gateway.bind со значением loopback и подключайтесь через SSH или Tailscale.
- Не устанавливайте много сторонних навыков: относитесь к ним как к расширениям браузера и добавляйте только те, что получены из источников, которым доверяете.
- Помните: агент, застрявший в цикле, продолжает тратить токены модели.