ClaudeClaw Installation Guide

Полное руководство по установке персонального AI-ассистента на ваш сервер. От нуля до работающего бота за 60 минут.

🤖 Что такое ClaudeClaw

ClaudeClaw -- это ваш личный AI-помощник на базе Claude, который работает через Telegram. Он помогает автоматизировать рутину, управлять задачами, общаться с пользователями и многое другое.

💬

Telegram интеграция

Работает как обычный Telegram бот. Поддержка голосовых сообщений, файлов, команд.

🧠

Память и контекст

Помнит историю общения, сохраняет важные данные, учитывает предыдущие разговоры.

⏰

Планировщик задач

Автоматические напоминания, рассылки, выполнение задач по расписанию.

🔧

Расширяемость

MCP-серверы, скиллы, плагины. Настройте под свои задачи.

🚀

Работает 24/7

После настройки бот работает круглосуточно на вашем сервере.

🎨

Настраиваемая личность

Измените тон, стиль общения, роль бота через конфигурацию.

📋 Шаг 0: Подготовка

Перед установкой соберите все необходимые аккаунты и ключи. Этот шаг займёт 20-30 минут.

1. Создайте VPS сервер

Минимальные требования: 1GB RAM, Ubuntu 22.04 LTS. Рекомендуется: 2GB RAM для стабильной работы.

Создать сервер на FirstVDS
Совет: FirstVDS -- рекомендуемый хостинг для запуска ClaudeClaw из РФ.

2. Создайте Telegram-бота

Откройте Telegram, найдите @BotFather, отправьте команду /newbot и следуйте инструкциям. Сохраните токен бота.

3. Узнайте ваш Chat ID

Найдите в Telegram бота @userinfobot, отправьте ему любое сообщение. Он вернёт ваш Chat ID.

4. Получите Groq API ключ

Перейдите на groq.com, зарегистрируйтесь и создайте API ключ. Groq бесплатен и используется для распознавания голоса.

5. Оформите подписку Claude Pro/Max

Claude -- основной AI движок бота. Требуется подписка Pro ($20/мес) или Max. Оплата из РФ через бота.

Оформить Claude Pro (РФ)
Важно: Запишите все токены и ключи в безопасное место. Они понадобятся на Шаге 5.

🔌 Шаг 1: Подключение

1

Подключитесь к серверу

⏱ ~2 минуты

Подключитесь через консоль хостинга или через SSH-клиент:

ssh root@ВАШ_IP_АДРЕС
Готово: Вы увидите приглашение командной строки: root@имя-сервера:~#

📦 Шаг 2: Установка Node.js

2

Установите Node.js 22.x

⏱ ~2 минуты

Выполните команды последовательно:

curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
apt-get install -y nodejs
apt-get install -y make g++

Проверьте установку:

node -v && npm -v
Ожидаемый результат: Должны увидеть версии Node.js (v22.x.x) и npm (v10.x.x).

🛠 Шаг 3: Claude Code CLI

3

Установите и авторизуйте Claude Code

⏱ ~5 минут

Установите Claude Code CLI глобально:

npm install -g @anthropic-ai/claude-code

Запустите авторизацию:

claude
Важно: Claude Code предложит открыть ссылку для авторизации. Скопируйте её и откройте в браузере на вашем компьютере, а не на сервере. Войдите в аккаунт Claude Pro/Max.

После успешной авторизации проверьте работу:

claude -p 'скажи привет'

Если Claude ответил -- всё работает! Выйдите командой:

/exit

🚀 Шаг 4: Генерация проекта

4

Создайте проект ClaudeClaw

⏱ ~15-20 минут

Создайте директорию и запустите Claude Code:

mkdir ~/claudeclaw && cd ~/claudeclaw
claude

Скачайте файл промпта с инструкциями для Claude:

Скачать GeekMonkey_prompt.md

Откройте скачанный файл, скопируйте весь текст и вставьте в окно Claude Code. Нажмите Enter.

Что происходит: Claude прочитает инструкции и расскажет, какой проект он создаст. После этого вставьте команду запуска: 
Platform: telegram. Voice: microphone. Memory: full. Features: scheduler, service. Go

Claude начнёт генерировать проект. Это займёт 15-20 минут. Периодически нажимайте Enter для подтверждения действий.

Готово: Когда генерация завершится, выйдите командой /exit

🔑 Шаг 5: Настройка .env

5

Создайте файл с ключами

⏱ ~2 минуты

Создайте файл .env с вашими токенами и ключами (замените значения на свои):

cat > ~/claudeclaw/.env << 'EOF'
TELEGRAM_BOT_TOKEN=ваш_токен_от_botfather
ALLOWED_CHAT_ID=ваш_chat_id
GROQ_API_KEY=ваш_groq_ключ
EOF
Важно: Замените ваш_токен_от_botfather, ваш_chat_id и ваш_groq_ключ на реальные значения из Шага 0.

Проверьте содержимое файла:

cat ~/claudeclaw/.env

⚙️ Шаг 6: Сборка проекта

6

Установите зависимости и соберите проект

⏱ ~3 минуты

Перейдите в директорию проекта и установите зависимости:

cd ~/claudeclaw
npm install

Скомпилируйте TypeScript в JavaScript:

npx tsc
Тишина = успех: Если компилятор ничего не вывел -- это хорошо. Значит, ошибок нет.

Проверьте, что файлы созданы:

ls dist/
Готово: Вы должны увидеть файлы .js в директории dist/

👤 Шаг 7: Пользователь claw

7

Создайте отдельного пользователя для бота

⏱ ~5 минут

Создайте пользователя claw:

adduser claw --disabled-password --gecos ""

Скопируйте проект и авторизацию Claude в домашнюю директорию claw:

cp -r ~/claudeclaw /home/claw/claudeclaw
chown -R claw:claw /home/claw/claudeclaw
cp -r ~/.claude /home/claw/.claude
chown -R claw:claw /home/claw/.claude

Переключитесь на пользователя claw и запустите бота для проверки:

su - claw
cd ~/claudeclaw
node dist/index.js
Проверка: Откройте Telegram, найдите своего бота и отправьте ему сообщение. Если бот отвечает -- всё работает!

Остановите бота (Ctrl+C) и выйдите из пользователя claw:

exit

🔄 Шаг 8: Автозапуск 24/7

8

Настройте systemd сервис

⏱ ~5 минут

Создайте systemd сервис для автоматического запуска бота:

cat > /etc/systemd/system/claudeclaw.service << 'EOF'
[Unit]
Description=ClaudeClaw Telegram Bot
After=network.target

[Service]
Type=simple
User=claw
WorkingDirectory=/home/claw/claudeclaw
ExecStart=/usr/bin/node dist/index.js
Restart=always
RestartSec=5
Environment=PATH=/usr/bin:/usr/local/bin

[Install]
WantedBy=multi-user.target
EOF

Перезагрузите systemd, включите и запустите сервис:

systemctl daemon-reload
systemctl enable claudeclaw
systemctl start claudeclaw

Проверьте статус:

systemctl status claudeclaw
Готово: Бот теперь работает 24/7 и автоматически перезапускается при сбоях или перезагрузке сервера.

🎭 Шаг 9: Личность бота (CLAUDE.md)

9

Настройте характер и роль бота

⏱ ~5 минут

Файл CLAUDE.md определяет, как бот общается, какие задачи выполняет, его стиль и правила работы.

Скачать шаблон CLAUDE.md

Откройте скачанный файл в текстовом редакторе и измените под свои нужды:

  • Имя и роль бота
  • Стиль общения (формальный/неформальный)
  • Основные задачи и функции
  • Правила и ограничения

После редактирования отправьте файл боту в Telegram с сообщением:

Замени свой CLAUDE.md на содержимое этого файла
Совет: Вы можете менять CLAUDE.md в любое время -- бот адаптируется к новым инструкциям.

💻 Шаг 10: VS Code (опционально)

10

Подключитесь к серверу через VS Code

⏱ ~10 минут

Для удобной работы с кодом на сервере используйте VS Code с расширением Remote-SSH:

1. Установите VS Code

Скачайте и установите Visual Studio Code

2. Установите расширение Remote-SSH

Откройте VS Code → Extensions (Ctrl+Shift+X) → найдите "Remote-SSH" → Install

3. Подключитесь к серверу

Нажмите F1 → "Remote-SSH: Connect to Host" → введите root@ВАШ_IP

4. Откройте проект

File → Open Folder → /home/claw/claudeclaw/

Готово: Теперь вы можете редактировать код прямо на сервере через VS Code.

⚡ Скиллы и MCP-серверы

Расширьте возможности вашего бота с помощью MCP-серверов и скиллов:

🔍

Serena

Анализ кода перед правками. Понимание структуры проекта, поиск символов, рефакторинг.

📚

Context7

Актуальная документация библиотек и фреймворков. React, Next.js, Node.js и другие.

🧠

RAG

Поиск по базе знаний. Векторные индексы для быстрого поиска релевантной информации.

👨‍💼

Борис

Менеджер проектов. Планирование, координация, отслеживание прогресса.

🎨

Алексей

Frontend разработчик. React, Next.js, UI/UX дизайн, адаптивная вёрстка.

📊

Галина

Аналитик данных. Бизнес-метрики, отчёты, визуализация, инсайты.

Установка: Скиллы устанавливаются через claude mcp add и хранятся в ~/.claude/skills/. Подробнее в документации Claude Code CLI.

💳 Оплата из РФ

Способы оплаты Claude Pro/Max и VPS-хостинга из России:

Claude Pro/Max

Оплата из России доступна через Telegram бота с поддержкой российских карт и криптовалюты.

Оплатить Claude через бота

VPS хостинг (FirstVDS)

FirstVDS принимает российские карты и работает с клиентами из РФ. Рекомендуемый хостинг для ClaudeClaw.

Перейти на FirstVDS

⚙️ Управление ботом

Проверка статуса

systemctl status claudeclaw

Просмотр логов

journalctl -u claudeclaw -f

Перезапуск бота

systemctl restart claudeclaw

Остановка бота

systemctl stop claudeclaw

Обновление проекта

cd ~/claudeclaw && git pull
npm install && npx tsc
systemctl restart claudeclaw

Редактирование кода

Используйте VS Code Remote-SSH (Шаг 10) или консольные редакторы (nano, vim).

📥 Скачать файлы

Скачать GeekMonkey_prompt.md Скачать шаблон CLAUDE.md Скачать все файлы (ZIP)
Совет: Сохраните все файлы в надёжном месте. Они пригодятся при настройке новых ботов или восстановлении после сбоя.

❓ FAQ

Нужно ли держать компьютер включённым?
Нет, бот работает на DigitalOcean 24/7 независимо от вашего компьютера. После настройки вы можете выключить компьютер -- бот продолжит работать.
Сколько стоит в месяц?
VPS сервер (FirstVDS): от 200-400₽/мес (зависит от конфигурации). Claude Pro: ~$20/мес (≈2000₽). Groq: бесплатно. Итого: около 2200-2400₽/мес.
Что если бот не отвечает?
Проверьте статус сервиса: systemctl status claudeclaw. Если статус не active -- посмотрите логи: journalctl -u claudeclaw -f. Часто помогает перезапуск: systemctl restart claudeclaw
Можно ли использовать на Windows?
Можно, но потребуется WSL2 (Windows Subsystem for Linux) или ручная настройка PM2 вместо systemd. Рекомендуется использовать Linux-сервер для стабильной работы.
Как обновить бота?
Если проект подключён к Git: cd ~/claudeclaw && git pull && npm install && npx tsc && systemctl restart claudeclaw. Если нет -- вручную замените изменённые файлы и перезапустите сервис.
Можно ли запустить несколько ботов на одном сервере?
Да. Создайте отдельную директорию для каждого бота, настройте разные .env файлы и systemd сервисы с уникальными именами (например, claudeclaw1.service, claudeclaw2.service).
Как изменить личность бота после установки?
Отредактируйте файл CLAUDE.md (через VS Code или nano) или отправьте боту в Telegram новый файл с сообщением "Замени свой CLAUDE.md на содержимое этого файла".
Безопасно ли хранить токены в .env?
Да, если файл .env имеет правильные права доступа (только пользователь claw может читать). Убедитесь, что .env добавлен в .gitignore и не попадает в публичные репозитории.