Интерактивное руководство от Dmitriymarketing

ClaudeClaw:
Создание ИИ-агента
с управлением через Telegram

Полный пошаговый гайд по созданию персонального ИИ-ассистента на базе Claude. От нуля до работающего бота за один вечер.

1–3ч

Время настройки

Шагов

Сложность

Начать пошагово →

Инструменты

Claude Code • МозгGroq Whisper • ГолосDigitalOcean • Сервер

🤖

💡

Что такое ClaudeClaw

Простыми словами — зачем это нужно и чем отличается от обычных ботов.

Ваш личный ИИ-ассистент прямо в Telegram

ClaudeClaw — это Telegram-бот, за которым стоит полноценный Claude (тот же, что на claude.ai). Вы пишете ему в Telegram — он отвечает как настоящий ассистент с памятью, голосом и навыками.

В отличие от обычных «клавиатурных» ботов на API, ClaudeClaw работает через Claude Code — бот может искать в интернете, работать с файлами, выполнять код и помнить ваши предыдущие разговоры. Это безопаснее и мощнее, потому что работает напрямую через инфраструктуру Anthropic.

🧠

Долгосрочная память

Помнит разговоры, задачи и предпочтения. Не начинает с нуля.

🎙️

Голосовые сообщения

Отправляете голосовое — бот понимает и отвечает текстом. Бесплатно.

🧩

Скиллы

Подключаемые промпт-инструкции. Новые навыки без программирования.

🤖

Своя личность

CLAUDE.md задаёт характер, стиль и знания. Полная кастомизация.

🔒

Только для вас

Привязан к вашему Telegram ID. Никто другой не имеет доступа.

⚡

Работает 24/7

На сервере, круглосуточно, даже когда ваш компьютер выключен.

В чём отличие от OpenClaw?

OpenClaw — проект, набравший 100 000 звёзд на GitHub. Делал похожую штуку, но у него оказались серьёзные проблемы: он крал ваш токен авторизации Claude и прогонял через чужой код. Anthropic это запретила — проект по сути забанен.

Преимущества ClaudeClaw

🛡️

Безопасность и легальность

Не трогает токен. Запускает официальный Claude CLI через Agent SDK от Anthropic.

🔗

Не нужно строить заново

Просто мостик к тому, что уже настроено — навыки, MCP-серверы, файлы, память.

💾

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

SQLite вместо внешних баз и платных эмбеддингов.

🔄

Одна система

Улучшил Claude Code на компе — телефонный бот тоже стал лучше автоматически.

⏱️

Настройка за 30–40 минут

Клонировал, запустил, пишешь в Telegram. Без сложных конфигов.

Подготовка: всё, что нужно заранее

~20–30 мин

Перед установкой подготовьте 5 вещей. Делайте по порядку.

0.1 Создаём сервер на DigitalOcean

DigitalOcean — облачный хостинг, где будет жить ваш бот. Работает 24/7, даже когда компьютер выключен.

Зайдите на digitalocean.com и зарегистрируйтесь
Нажмите Create → Droplets
Выберите Ubuntu 24.04
Тариф: $6/мес (1GB) для теста или $12/мес (2GB) для стабильной работы
Регион: выбирайте ближе к вашему городу. Например, для Москвы и европейской части России — Амстердам
Задайте пароль для root (запишите!)
Create Droplet → запишите IP-адрес

0.2 Создаём Telegram-бота

Бот создаётся через @BotFather — специального бота Telegram.

Откройте @BotFather в Telegram
Напишите /newbot
Придумайте имя и username
Сохраните токен (строка вида 8258092538:AAGs...)

0.3 Узнаём Chat ID

Chat ID — ваш уникальный номер. Бот будет отвечать только вам.

Найдите @userinfobot
Напишите /start
Сохраните ID (число вида 12345678)

0.4 Groq API ключ (для голосовых)

Groq — полностью бесплатный сервис для распознавания голосовых сообщений. Щедрые лимиты, платить не нужно.

Зарегистрируйтесь на groq.com (бесплатно, можно через Google)
После регистрации зайдите в консоль → API Keys
Нажмите Create API Key
Сохраните ключ (gsk_...)

0.5 Аккаунт Claude с подпиской Pro или Max

Для работы бота нужен аккаунт на claude.ai с активной подпиской Pro или Max.

Если есть аккаунт на claude.ai — отлично
Создать и оплатить аккаунт Claude с русской картой можно по этой ссылке

✅ Чек-лист

У вас должны быть: IP сервера, пароль root, токен бота, Chat ID, Groq ключ, аккаунт Claude.

Результат шага

Все ключи и аккаунты готовы. Приступаем к установке.

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

~2 мин

Сейчас мы подключимся к серверу через консоль — это утилита для управления сервером прямо в браузере. Не пугайтесь, мы будем просто копировать и вставлять готовые команды — никаких специальных знаний не нужно.

Зайдите в панель DigitalOcean
Нажмите на ваш дроплет (дроплет — это сервер, который мы создали в Шаге 0)
Кнопка «Console» справа вверху
Откроется терминал — вы внутри сервера

Результат шага

Вы подключены. Видите root@имя-сервера:~#

Установка Node.js

~2 мин

Node.js — платформа, на которой работает код бота. Как «движок» для программы — без него бот не запустится.

Установка Node.js 22Консоль сервера

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

Вы должны увидеть примерно такое

v22.22.1 и ниже — версия npm (10.x.x)

Установка Claude Code CLI

~5 мин

Claude Code — программа от Anthropic для общения с Claude через командную строку. Через неё бот будет «думать».

Установка

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

Запуск и авторизация

После установки нужно запустить Claude Code и пройти авторизацию в своём аккаунте Anthropic.

Запускаем Claude Code

claude

При первом запуске Claude Code спросит тему оформления, метод логина и другие настройки — не пугайтесь, просто нажимайте Enter на каждый вопрос, соглашаясь со значениями по умолчанию
После этого в консоли появится ссылка для авторизации — она начинается с https://claude.ai/...
Скопируйте эту ссылку и откройте в браузере на вашем компьютере или телефоне (на сервере браузера нет)

⚠️ Важно

Ссылку нужно открыть именно в браузере на вашем компьютере или телефоне — на сервере браузера нет. Просто скопируйте URL и вставьте в адресную строку.

Войдите в свой аккаунт Anthropic (или он уже авторизован)
Нажмите «Разрешить» (Allow) — вы даёте Claude Code доступ к вашему аккаунту
Вернитесь в консоль сервера — там появится подтверждение, что авторизация прошла

Проверяем, что всё работает

Отправим тестовое сообщение, чтобы убедиться, что Claude отвечает:

Тестовая команда

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

Выходим из Claude Code

Проверка пройдена — теперь выходим из Claude Code, чтобы вернуться в обычную консоль:

Выходим из Claude Code

/exit

Результат шага

Claude отвечает «Привет!» — авторизация прошла, всё работает.

Генерация проекта ClaudeClaw

~15–20 мин

Claude Code сам напишет весь код бота. Вы просто вставите промпт ClaudeClaw_prompt, а Claude сделает остальное.

Создаём папку проекта

mkdir ~/claudeclaw && cd ~/claudeclaw

Теперь запускаем Claude Code внутри этой папки:

Запускаем Claude Code

claude

Скачайте ClaudeClaw_prompt (кнопка внизу страницы)
Откройте и скопируйте весь текст
Вставьте промпт прямо в окно Claude Code — именно внутри Claude Code, не в обычную консоль
Claude прочитает промпт и выдаст длинное описание возможностей бота. В конце он напишет что-то вроде «Any questions before we get into the setup choices?» — не пугайтесь, просто скопируйте и вставьте эту команду:

Вставьте этот ответ

Platform: telegram. Voice: microphone. Memory: full. Features: scheduler, service. Go

💬 Что означают эти настройки

telegram — бот будет работать в Telegram

microphone — распознавание голосовых сообщений через Groq (бесплатно)

full — полная система памяти — бот запоминает вас со временем

scheduler, service — планировщик задач + автозапуск при перезагрузке сервера

После вашего ответа Claude начнёт генерировать проект. Подождите 15–20 минут — не закрывайте консоль

⌨️ Подтверждения во время генерации

Пока Claude создаёт файлы проекта, он будет периодически останавливаться и запрашивать подтверждение — например, на создание или изменение файлов. Каждый раз просто нажимайте Enter, чтобы разрешить действие. Это нормальная часть процесса — Claude спрашивает разрешение перед каждой операцией с файлами. Не уходите далеко от консоли.

Файлы проекта ClaudeClaw после генерации

Результат шага

Проект сгенерирован. Появились файлы: src/, package.json и другие.

Выходим из Claude Code

Проект создан — теперь выходим из Claude Code, чтобы вернуться в обычную консоль сервера для следующих шагов:

Выходим из Claude Code

/exit

Настройка токенов (.env)

~2 мин

Файл .env хранит секретные ключи — токен бота, Chat ID, ключ для голосовых. Создадим одной командой.

Замените значения на свои из Шага 0:

Создание .envКонсоль сервера

cat > ~/claudeclaw/.env << 'EOF'
TELEGRAM_BOT_TOKEN=ваш_токен_от_botfather
ALLOWED_CHAT_ID=ваш_chat_id
GROQ_API_KEY=ваш_groq_ключ
EOF

Проверка

cat ~/claudeclaw/.env

Вы должны увидеть

Три строки с вашими токенами.

Сборка проекта

~3 мин

Код на TypeScript нужно «скомпилировать» — превратить в формат, который понимает сервер.

Переходим в папку проекта

cd ~/claudeclaw

Устанавливаем зависимости

npm install

Подождите пока установится (1–3 минуты). Потом компилируем:

Компиляция

npx tsc

💡 Ничего не произошло?

Если после npx tsc консоль просто вернула строку ввода без каких-либо сообщений — это значит, что всё прошло успешно. Ошибки были бы выведены красным текстом. Тишина = всё ок.

Проверяем, что скомпилированные файлы на месте:

Проверка

ls dist/

Вы должны увидеть

Список файлов: bot.js, agent.js, index.js, memory.js, scheduler.js и другие. Если файлы есть — сборка прошла успешно.

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

~5 мин

Claude Code не может работать от root (безопасность). Создаём отдельного пользователя claw.

Создаём пользователяПод root

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

Копируем проект

cp -r ~/claudeclaw /home/claw/claudeclaw

Назначаем владельца

chown -R claw:claw /home/claw/claudeclaw

Копируем авторизацию Claude

cp -r ~/.claude /home/claw/.claude

Назначаем владельца

chown -R claw:claw /home/claw/.claude

Тестируем — переключаемся на пользователя claw:

Переключаемся на пользователя claw

su - claw

Переходим в папку проекта

cd ~/claudeclaw

Запускаем бота

node dist/index.js

✅ Проверка

Напишите боту в Telegram. Если он ответил — всё работает!

Останавливаем бота и выходим

Бот работает — мы это проверили. Теперь остановим его (на следующем шаге настроим автозапуск). Нажмите Ctrl+C в консоли, чтобы остановить бота. Потом выходим обратно на root:

Выходим обратно на root

exit

Результат шага

Бот отвечает в Telegram. Пользователь claw создан. Вы снова под root.

Настройка автозапуска (24/7)

~5 мин

Настроим, чтобы бот работал постоянно и перезапускался при сбоях.

⚠️ Убедитесь

Вы должны быть под root (не под claw). Если в консоли написано claw@... — введите exit. Также бот должен быть остановлен (Ctrl+C на предыдущем шаге).

Создание сервисаПод root

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

Вы должны увидеть

● claudeclaw.service — active (running). Бот работает 24/7!

Настройка личности бота (CLAUDE.md)

~5 мин

CLAUDE.md определяет кто ваш бот: имя, характер, знания, стиль. Меняете файл — меняется «личность».

Скачайте шаблон CLAUDE.md (внизу страницы)
Отредактируйте — впишите имя, бизнес, стиль
Отправьте файл боту в Telegram с подписью:
«Замени свой CLAUDE.md на содержимое этого файла»
Бот подтвердит — у него новая личность!

💡 Совет

CLAUDE.md подхватывается автоматически. Перезапуск не нужен.

Результат шага

Бот знает кто он и общается в нужном стиле.

Подключение VS Code (опционально)

~10 мин

VS Code — бесплатный редактор кода от Microsoft. С ним файлы на сервере редактируются как обычные документы. Необязательно, но удобно.

Скачайте VS Code и установите
Иконка пазла слева → Remote - SSH → Install

Cmd+Shift+P (Mac) / Ctrl+Shift+P (Win)
Remote-SSH: Connect to Host → root@ВАШ_IP

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

⚠️ VPN

Может блокировать. Выключите VPN → подключитесь → включите обратно.

Результат шага

Файлы сервера в VS Code. Редактируйте CLAUDE.md, добавляйте скиллы.

🧠

Добавление скиллов

~5 мин

Скилл — это обычный текстовый файл с расширением .md, в котором написана инструкция для бота. Например, скилл «копирайтер» может содержать правила написания текстов, tone of voice, примеры. Когда вы отправляете боту задачу, он автоматически подключает нужный скилл.

Как добавить скилл через VS Code

Подключитесь к серверу через VS Code (Шаг 10)
В левой панели раскройте папку .claude → skills
Если папки skills нет — создайте: правый клик на .claude → New Folder → skills
Правый клик на skills → New File → назовите файл, например copywriter.md
Вставьте в файл ваш промпт — инструкцию для бота. Как в Notion: просто текст с правилами, стилем, примерами
Сохраните: Cmd+S (Mac) / Ctrl+S (Win)

✅ Перезапуск не нужен

Скиллы подхватываются автоматически при следующем сообщении боту. Просто сохранили файл — и всё работает.

💡 Идеи скиллов

Копирайтер, аналитик конкурентов, SMM-менеджер, email-маркетолог, генератор хуков, ДНК клиента — любая роль, которую вы хотите дать боту. Один скилл = один файл.

Результат шага

У бота появился новый навык. Отправьте ему задачу по теме скилла — он подключит его автоматически.

💳

Оплата из РФ

Если у вас нет аккаунта Claude, или нужна иностранная почта и карта для оплаты — это легко решается с помощью проверенного сервиса.

Оплатить подписку Claude через бота →

Ребята проверенные — рекомендую их своим студентам для оплаты подписок Claude, ChatGPT и других сервисов. Помогут с полного нуля: создадут аккаунт, настроят почту и оплатят подписку.

Как оплатить аренду сервера зарубежной картой

Вот бот для создания зарубежной карты, с помощью которого можно создать себе карту, выпустить её и оплачивать любые сервисы.

Перейти в бота для создания зарубежной карты →

⚙️

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

Команды для консоли DigitalOcean или терминала VS Code.

Перезапуск

systemctl restart claudeclaw

Статус

systemctl status claudeclaw

Логи

journalctl -u claudeclaw -f

Остановка

systemctl stop claudeclaw

📝 БЕЗ перезапуска

CLAUDE.md и скиллы подхватываются автоматически.

🔄 ТРЕБУЕТ перезапуска

.env и код (src/).

📥

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

Файлы для установки.

📥 ClaudeClaw_prompt — промпт для установки

❓

Частые вопросы

Сервер $6–12/мес. Groq бесплатно. Claude Pro ~$20/мес или Max ~$100/мес.

Да, но бот работает только пока компьютер включён.

Да! Долгосрочная память ~110 дней. Важное помнит, мелочи забывает.

Да, через Groq Whisper (бесплатно).

Привязан к вашему ID. Ваш сервер. Данные никуда не уходят.

Скиллы — файлы в ~/.claude/skills/. Без перезапуска.

ClaudeClaw:Создание ИИ-агентас управлением через Telegram

Что такое ClaudeClaw

Ваш личный ИИ-ассистент прямо в Telegram

В чём отличие от OpenClaw?

Преимущества ClaudeClaw

Подготовка: всё, что нужно заранее

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

Установка Node.js

Установка Claude Code CLI

Генерация проекта ClaudeClaw

Настройка токенов (.env)

Сборка проекта

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

Настройка автозапуска (24/7)

Настройка личности бота (CLAUDE.md)

Подключение VS Code (опционально)

Добавление скиллов

Оплата из РФ

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

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

Частые вопросы

ClaudeClaw:
Создание ИИ-агента
с управлением через Telegram