A lightweight, open-source extension for Claude Code, ClaudeClaw transforms your Claude Code environment into a persistent, personal AI assistant. It targets users seeking to automate tasks, respond to messages, and process voice commands without incurring additional API costs. The primary benefit is leveraging an existing Claude Code subscription for a continuously running agent, simplifying deployment and management.

How It Works

ClaudeClaw operates as a background daemon directly within the Claude Code environment, eliminating external dependencies and API overhead. It utilizes smart context management to ensure efficient operation within the user's Claude Code subscription. The system orchestrates tasks through scheduled cron jobs, real-time Telegram bot interactions, and voice command transcription, providing a unified platform for AI-driven automation.

Quick Start & Requirements

• Installation: Add via claude plugin marketplace add moazbuilds/claudeclaw, then install with claude plugin install claudeclaw.
• Running: Initiate within a Claude Code session using /claudeclaw:start.
• Setup: A guided wizard configures model choice (Opus, Sonnet, Haiku), heartbeat intervals, Telegram integration, and security levels.
• Prerequisites: Requires an active Claude Code subscription. No external infrastructure, containers, or complex dependencies are needed.
• Links: Official quick-start and documentation are implicitly accessed via the Claude plugin marketplace.

Highlighted Details

• Zero API Overhead: Operates entirely within the Claude Code subscription, avoiding separate API keys, token accounting, and associated billing surprises.
• Effortless Deployment: Installable via a single plugin command, requiring no containers or infrastructure management for a running daemon.
• Built-in Observability: Features a real-time web dashboard to monitor agent runs, edit scheduled jobs, and inspect logs.
• Versatile Interaction: Supports periodic "heartbeat" check-ins, timezone-aware cron job scheduling, and chat-based control via a Telegram Bot.
• Model Selection: Allows users to choose between Claude Opus, Sonnet, or Haiku for different projects.

Maintenance & Community

No specific details regarding contributors, sponsorships, or community channels (e.g., Discord/Slack) were provided in the README snippet.

Licensing & Compatibility

The license type is not specified in the provided README snippet. Compatibility is inherently tied to the Claude Code platform.

Limitations & Caveats

The project's functionality is entirely dependent on the Claude Code environment and its subscription model. Users must have an active Claude Code subscription to utilize ClaudeClaw. Performance and capabilities are constrained by the underlying Claude Code execution limits and available models.