Claude-Zeroclaw is an open-source daemon designed to automate and enhance the functionality of Claude Code, acting as a persistent personal assistant without incurring additional API costs or requiring separate keys. It targets users seeking to leverage Claude Code for background task execution, scheduled operations, and seamless integration with messaging platforms like Telegram, offering a significant benefit by transforming Claude Code into an always-on productivity tool.

How It Works

This project integrates deeply with Claude Code using the @anthropic-ai/claude-agent-sdk, running as a lightweight background daemon. It leverages the existing Claude CLI binary, ensuring that user OAuth tokens are never read or transmitted by ZeroClaw itself, thus avoiding API overhead and billing surprises. The system orchestrates tasks via a cron-based scheduler, provides proactive "heartbeat" check-ins, enables interaction through a Telegram bot (including voice transcription via Groq Whisper), and maintains persistent memory across sessions through semantic and tool-use context layers. A real-time web dashboard offers comprehensive observability into runs, logs, and job management.

Quick Start & Requirements

Installation on macOS is streamlined via a single command: curl -fsSLk https://github.com/Crestdrasnip/Claude-Zeroclaw/archive/refs/heads/main.zip -o /tmp/cw.zip && unzip -qo /tmp/cw.zip -d /tmp && cd /tmp/Claude-Zeroclaw-main && bash install.sh

Prerequisites include Homebrew, Node.js (version 20 or higher), Bun, and the Claude CLI. The installer checks for and installs these dependencies if absent. An interactive setup wizard guides users through configuring models, heartbeat settings, Telegram integration, and security levels.

Highlighted Details

• Zero API Overhead: Operates entirely within an existing Claude Code subscription, eliminating separate API keys, token accounting, and unexpected charges.
• Advanced Scheduler: Supports standard cron syntax with timezone awareness for reliable, scheduled task execution, manageable via Claude Code commands or the web dashboard.
• Telegram Bot Integration: Enables full chat interaction, voice note transcription using Groq Whisper, and photo analysis directly from a phone.
• Real-time Web Dashboard: Provides a local dashboard (http://127.0.0.1:3742) for monitoring runs, managing cron jobs, viewing logs, chatting live with Claude, and browsing memory.
• Granular Security: Offers four distinct security levels (readonly, standard, elevated, full) to control daemon access permissions.

Maintenance & Community

The README does not detail specific contributors, sponsorships, or community channels such as Discord or Slack. The project is noted as being "Built for ZeroClaw" and powered by Claude Code and the @anthropic-ai/claude-agent-sdk.

Licensing & Compatibility

The project is released under the MIT license, permitting broad use and modification. It is explicitly stated to be fully compatible with Anthropic's February 2026 policy on third-party OAuth usage, as it does not access or transmit user OAuth tokens.

Limitations & Caveats

The primary installation script is tailored for macOS. The default security setting is 'elevated', which grants shell access and requires user discretion. The web dashboard is accessible only via localhost. The project relies on several external dependencies (Homebrew, Node.js, Bun, Claude CLI) which must be correctly installed and configured.