Полное руководство по OpenClaw: персональный ИИ-помощник

Что такое OpenClaw и чем он отличается

OpenClaw — это бесплатный ИИ-агент с открытым исходным кодом, который работает совсем не как обычный чат-бот. Вместо простого диалога он предоставляет вам персонального помощника, способного работать автономно, помнить вас и выполнять реальные действия.

Ключевые преимущества

• Структурированная память: Агент хранит информацию о вас (имя, работа, предпочтения) в виде файлов, а не сжатыми резюме разговоров. Он действительно вас узнаёт.
• Автономная работа 24/7: Работает в облаке независимо от вашего компьютера, может запускаться по расписанию или реагировать на события без вашего запроса.
• Реальные действия: Может отправлять письма, управлять календарём, искать в интернете, бронировать билеты и многое другое — не просто советовать, а действовать.

Типичные сценарии использования

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

Важно: OpenClaw требует выбора LLM-провайдера (Anthropic Claude, OpenAI GPT, Google Gemini и т.д.). Сам агент бесплатный, но вы платите за токены моделей.

Планирование и выбор инфраструктуры

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

Перед настройкой ответьте себе на эти вопросы:

1. Что должен делать агент ежедневно? Выберите 2–3 начальные задачи (утренний брифинг, отслеживание рейсов, проверка почты). Не перегружайте сразу.
2. К каким данным он будет подключаться? Определите источники: Gmail, Календарь, Google Диск, банковские приложения и т.д.
3. Какой ваш минимальный уровень конфиденциальности? Решите, какие сервисы вы категорически не подключите (например, банковские счета на первом этапе).

Где запускать OpenClaw: сравнение вариантов

Совет: Начните с облачного VPS (Hostinger KVM 1 с шаблоном). Это 30 минут на установку, несколько долларов в месяц и полная 24/7 доступность. Когда привыкнете, сможете перенести на своё оборудование.

Пошаговая установка и первый запуск

Шаг 1: Регистрация и запуск VPS на Hostinger

• Используйте партнёрскую ссылку для получения скидки (обычно 10–20% на первый год).
• Выберите тариф KVM 1 с параметрами: 4 ГБ ОЗУ, 60 ГБ SSD — этого достаточно для начала.
• При заказе добавьте опции:
  • Мгновенный веб-скрейпинг (Web Scraping) — бесплатно.
  • Ежедневное резервное копирование (Backups) — настоятельно рекомендуется.
• Выберите географическое расположение сервера с наименьшей задержкой (примерно в вашем регионе).
• Дождитесь завершения развёртывания (обычно 5–15 минут).

Шаг 2: Подключение ИИ-модели (LLM-провайдер)

OpenClaw сам по себе не имеет встроенной языковой модели. Вы выбираете провайдера и платите за использование токенов:

1. Создайте аккаунт у выбранного провайдера:
   • Anthropic Claude (рекомендуется для начала)
   • OpenAI GPT
   • Google Gemini
   • Deepseek (дешевле, но медленнее)
2. Пополните баланс на сумму $40–50 для начала. Этого хватит на месяц-два в зависимости от использования.
3. Получите API-ключ из личного кабинета провайдера.
4. Вставьте ключ в панель управления Hostinger (раздел «Переменные окружения» или «API Keys»).

Шаг 3: Создание Telegram-бота

1. В Telegram найдите официальный бот BotFather (логин: @BotFather).
2. Напишите ему /newbot и следуйте инструкциям:
   • Придумайте имя для бота (видно в профиле).
   • Выберите уникальный username, заканчивающийся на bot (например, my_assistant_bot).
3. BotFather выдаст вам токен бота (выглядит как длинная строка: 123456789:ABCdefGHIjklmnoPQRstuvWXYZ).
4. Скопируйте этот токен и вставьте его в панель Hostinger в раздел Telegram.

Шаг 4: Первый запуск и настройка личности

1. После развёртывания откройте панель управления OpenClaw с помощью токена шлюза (Gateway Token), выданного Hostinger.
2. Откроется чат с вашим агентом. Начнётся мастер Bootstrap — интерактивная настройка.
3. Ответьте на вопросы мастера:
   • Ваше имя (как агент должен вас называть).
   • Имя агента (например, «Alex»).
   • Характер и роль (например, «помощник для путешествий» или «личный ассистент для работы»).
4. После завершения мастера бот отправит вам в Telegram код сопряжения (pairing code).
5. Напишите агенту в чате этот код, и он свяжется с вашим Telegram-ботом.
6. Готово! Теперь вы можете общаться с агентом прямо в Telegram.

Навыки, интеграции и управление доступом

Что такое Skills (навыки)?

Навыки — это «приложения» или расширения для вашего агента. Они позволяют подключить внешние сервисы (почту, календарь, поисковые системы и т.д.). Устанавливаются через маркетплейс ClawHub (clawhub.ai).

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

1. Перейдите на clawhub.ai или найдите маркетплейс в панели управления OpenClaw.
2. Поищите нужный навык по названию (например, «Gmail», «Google Calendar», «Weather»).
3. Проверьте рейтинг автора и количество установок (ищите навыки с большим числом установок и хорошим рейтингом).
4. Нажмите кнопку Install и следуйте инструкциям.

Рекомендация: Начните с навыка GOG (Google One Gateway) — он предоставляет единый доступ к Gmail, Календарю, Google Диску и Google Документам. Один раз настроив OAuth, вы сможете использовать все эти сервисы.

Настройка Google OAuth: подробно

Это самый сложный, но одноразовый этап. После завершения вам не нужно будет повторять эту процедуру.

1. Создайте новый проект в Google Cloud Console (console.cloud.google.com):
   • Нажмите на название проекта в верхней левой части и выберите «Создать проект».
   • Дайте проекту имя (например, «OpenClaw Assistant»).
2. Включите необходимые API в меню «APIs & Services»:
   • Gmail API
   • Google Calendar API
   • Google Drive API (если нужен доступ к файлам)
   • Google Docs API (если нужно создавать документы)
3. Настройте экран согласия OAuth (Consent Screen):
   • Выберите аудиторию «External» (внешняя).
   • Заполните основную информацию: название приложения, email поддержки.
   • Добавьте себя как тестового пользователя.
4. Создайте учётные данные (Credentials) типа «Desktop Application»:
   • Нажмите «Create Credentials» → «OAuth 2.0 Client ID».
   • Скачайте JSON-файл с ключами.
5. Отправьте JSON-файл своему боту в Telegram и следуйте инструкциям для авторизации:
   • Бот откроет ссылку Google для авторизации.
   • Разрешите доступ к нужным сервисам.
   • Google вернёт токен доступа — вставьте его в чат с ботом.

Ключевые файлы агента

После установки Skills вы сможете просматривать и редактировать файлы агента во вкладке «Агенты» → «Файлы»:

• agents.md — правила поведения и инструкции. Например: «не проверяй почту с 22:00 до 6:00» или «отвечай максимально кратко». Обновляется через чат с агентом.
• soul.md — личность и характер агента. Можно сделать её уникальной, описав стиль общения, тон и любимые фразы.
• user.md — что агент знает о вас (имя, работа, предпочтения, привычки). Заполняется автоматически в ходе общения.
• memory.md — рабочая память агента, журнал недавних событий и выводов. Не редактируется вручную — обновляется самим агентом.

Безопасность, управление затратами и выбор модели

Правила безопасности

• Начните с малого: первую неделю используйте только Telegram и Google интеграции, не подключайте банковские приложения или платёжные системы.
• Храните ключи в переменных окружения: все API-ключи, токены и пароли хранятся в переменных окружения VPS и никогда не видны в чате. Никогда не вставляйте их в сообщения.
• Внимательно читайте запросы на подтверждение: если агент просит разрешение выполнить действие (отправить письмо, изменить календарь), проверьте, что это действительно нужно, перед утверждением.
• Тестируйте на безопасные сервисы: первые две недели проверяйте навыки на Google (читаемые данные), а потом медленно добавляйте более чувствительные интеграции.

Понимание токенов и затрат на LLM

Токены — это маленькие фрагменты текста, за которые провайдер ИИ берёт плату. Чем больше контекста передано в модель (ваша история, файлы агента, данные о вас), тем больше токенов и выше стоимость.

Пример расходов: При использовании Claude Sonnet утром можно потратить $0.10–0.30 за сводку писем и новостей, а вечером ещё $0.20–0.50. В месяц это может быть $5–20 при активном использовании.

Интеллектуальная маршрутизация между моделями

Не все задачи требуют дорогой модели. Настройте правило в agents.md для автоматического выбора модели в зависимости от сложности:

• Уровень 1 (Claude Opus, GPT-4): для глубокого анализа, исследований и сложного творческого контента. Дорого, используйте редко (несколько раз в неделю).
• Уровень 2 (Claude Sonnet, GPT-3.5): для повседневного чата, простых задач, проверки писем и календаря. Дешево и быстро — рекомендуется по умолчанию.
• Уровень 3 (Deepseek, Llama): для очень простых задач типа форматирования текста, простых сумм или повторяющихся действий. Очень дешево или бесплатно.

Пример команды агенту: «Для проверки новых писем используй Sonnet (2–3 токена). Если письмо сложное (контракт, предложение) — переключись на Opus. Для форматирования используй Deepseek.»

Контроль расходов

• Регулярно проверяйте баланс в консоли вашего LLM-провайдера (Anthropic Console, OpenAI Billing и т.д.).
• Установите оповещение на сумму (например, $50 потрачено — алёрт вам на email).
• Если расходы выше ожидаемых, спросите у агента: «Какие задачи потребили больше всего токенов на этой неделе?»
• Уменьшайте размер контекста (сжатие памяти через Dreaming, см. ниже) для снижения затрат.

Автоматизация, продвинутые функции и оптимизация

Создание автоматизации: расписание и триггеры

OpenClaw может работать не только по вашему запросу, но и автоматически запускаться по расписанию или по событиям.

Режимы автоматизации

• Cron (рекомендуется): задачи по точному расписанию (например, проверка 3 раза в день в 8:00, 12:00 и 18:00). Экономит токены, так как агент работает ровно когда надо.
• Heartbeat: проверка через регулярные короткие интервалы (например, каждые 30 минут). Расходует больше токенов, используйте с осторожностью — подходит только для критичных задач.
• Триггер события: запуск при получении письма, изменении календаря или другом событии (требует доступной интеграции).

Примеры команд для Telegram

Напишите боту в Telegram:

• «Отслеживай цены авиабилетов из LHR в CDG на следующий месяц. Когда цена упадёт ниже $150, уведоми меня. Проверяй три раза в день по Cron (8:00, 14:00, 20:00).»
• «Каждое утро в 7:00 отправляй мне сводку: на какие встречи я записан, какая погода, какие новые письма.»
• «Когда приходит письмо с темой содержащей "счёт" или "контракт", немедленно уведоми меня (Heartbeat).»

Продвинутые функции

• Сновидение (Dreaming): агент сжимает и оптимизирует свою память (memory.md), чтобы избежать раздувания контекста и снизить затраты. Включается через панель управления после месяца активного использования (когда накопится достаточно истории).
• Субагенты (Sub-agents): запуск нескольких копий агента параллельно для выполнения больших задач. Например, исследование нескольких CRM одновременно или анализ нескольких наборов данных. Запускаются командой «используй субагентов для [задача]».
• Пользовательские интеграции: для продвинутых пользователей есть возможность написать свой собственный навык (Skill) на Python или JavaScript и загрузить его на ClawHub.
• Журналы (Logs): для отладки откройте раздел «Журналы» в панели управления. Там можно найти полную информацию об ошибках и сбоях.

Совет: Сначала настройте Cron-задачи для основных функций. Когда привыкнете, добавляйте Heartbeat для критичных уведомлений и субагентов для сложных исследований.

Устранение неполадок и расширение

Типичные проблемы и решения

• Агент перестал отвечать: первым делом проверьте баланс на счету вашего LLM-провайдера (Anthropic, OpenAI и т.д.). Если баланс исчерпан, агент не может работать.
• «Ошибка в задании» или странный результат: спросите у самого агента в чате: «Что произошло при [ваша последняя команда]? Как это исправить?» Агент может диагностировать свои ошибки лучше, чем человек.
• Срок действия OAuth истёк: если интеграция с Google перестала работать, скажите агенту: «Повторно авторизуйся в Gmail». Бот откроет новую ссылку авторизации.
• Критический сбой системы: восстановите систему из резервной копии или снимка (snapshot) в панели Hostinger (Docker Manager или Backups). Это займёт несколько минут.
• Агент работает медленнее обычного: скорее всего, растёт размер файла memory.md. Включите функцию Dreaming для сжатия памяти.

Миграция на собственное оборудование

Если решите перенести агента с VPS на свой компьютер, сервер или выделённое оборудование:

1. Создайте полную резервную копию через команду в чате: «Создай полный бэкап моего профиля и всех данных».
2. Запросите у агента официальные инструкции по миграции: «Как мне перенести тебя на [ваше оборудование]?»
3. Установите OpenClaw на новое железо по официальной документации на GitHub (openclawai/openclaw).
4. Импортируйте резервную копию через процедуру восстановления.
5. Важно: перевыпустите все сторонние ключи и токены:
   • Создайте новый Telegram-бот через BotFather.
   • Повторно авторизуйтесь в Google OAuth.
   • Обновите API-ключи LLM-провайдера.

Важно: Хранение агента на облачном VPS обычно безопаснее и удобнее, чем на собственном оборудовании. Миграция требуется редко — только если VPS перестаёт вас устраивать по цене или функциональности.