Быстрый старт: запускаем OpenClaw за 5 минут

Этот гайд — самый быстрый путь от нуля до работающего OpenClaw. Никаких лишних объяснений, только команды и действия. Подробности — в других статьях базы знаний.

Что вам понадобится

• macOS 12+, Windows 10/11 или Linux
• Node.js 22+ (nodejs.org)
• API-ключ от Claude (console.anthropic.com)
• Telegram-бот (создаётся за минуту через @BotFather)

Шаг 1. Установка OpenClaw

npm install -g openclaw@latest

После установки перезапустите терминал.

Шаг 2. Создание агента

openclaw onboard --install-daemon

Мастер настройки создаст структуру в ~/.openclaw/:

~/.openclaw/
├── openclaw.json       # Настройки агента
├── workspace/
│   ├── SOUL.md         # Личность и правила
│   ├── AGENTS.md       # Описание агентов
│   └── skills/         # Расширения
└── credentials         # Ключи и токены

Шаг 3. Настройка API-ключа

Откройте ~/.openclaw/openclaw.json и добавьте модель:

{
  agent: {
    model: "anthropic/claude-opus-4-6",
  },
}

Или через переменную окружения (безопаснее):

export ANTHROPIC_API_KEY=sk-ant-xxxxx

Шаг 4. Подключение Telegram

1. Напишите @BotFather в Telegram
2. Отправьте /newbot
3. Придумайте имя и username для бота
4. Скопируйте токен (выглядит как 123456789:ABCdefGHI...)

Добавьте в ~/.openclaw/openclaw.json:

{
  channels: {
    telegram: {
      botToken: "123456789:ABCdefGHI...",
    },
  },
}

Шаг 5. Запуск

openclaw gateway --port 18789

Готово! Напишите что-нибудь вашему боту в Telegram.

Проверка работы

Если всё настроено правильно, вы увидите в терминале:

✓ OpenClaw v2.x.x started
✓ Gateway: Telegram connected
✓ LLM: anthropic/claude-opus-4-6 ready
✓ Dashboard: http://127.0.0.1:18789/
✓ Listening for messages...

Напишите боту «Привет» — он должен ответить.

Частые проблемы

«API key invalid»

• Проверьте, что ключ начинается с sk-ant-
• Убедитесь, что на аккаунте Anthropic есть баланс

«Telegram token invalid»

• Скопируйте токен заново из BotFather
• Убедитесь, что нет лишних пробелов

«Permission denied»

• На Mac/Linux: используйте sudo npm install -g openclaw@latest
• На Windows: запустите PowerShell от администратора

Бот не отвечает

• Проверьте botToken в ~/.openclaw/openclaw.json — токен должен быть корректным
• Убедитесь, что вы пишете именно тому боту, который подключён к OpenClaw
• Запустите openclaw doctor для диагностики

Что дальше

Базовая установка готова. Теперь можно:

• Настроить личность агента — файл SOUL.md определяет характер и стиль общения
• Добавить скиллы — расширения для работы с API, файлами, сервисами
• Настроить память — как агент запоминает информацию
• Использовать бесплатно — все способы запустить OpenClaw без оплаты
• Справочник команд CLI — все команды OpenClaw с примерами
• Прочитать про безопасность — важно перед использованием в продакшене

Минимальный openclaw.json

Для справки — полный минимальный конфиг (~/.openclaw/openclaw.json, формат JSON5):

{
  agent: {
    model: "anthropic/claude-opus-4-6",
  },
  channels: {
    telegram: {
      botToken: "123456:ABCDEF",
    },
  },
}

Этого достаточно для старта. Остальные настройки — по мере необходимости.