claudeclaw

A lightweight, open-source OpenClaw version built into your Claude Code.

ClaudeClaw turns your Claude Code into a personal assistant that never sleeps. It runs as a background daemon, executing tasks on a schedule, responding to messages on Telegram and Discord, transcribing voice commands, and integrating with any service you need.

Note: Please don't use ClaudeClaw for hacking any bank system or doing any illegal activities. Thank you.

Why ClaudeClaw?

Category	ClaudeClaw	OpenClaw
Anthropic Will Come After You	No	Yes
API Overhead	Directly uses your Claude Code subscription	Nightmare
Setup & Installation	~5 minutes	Nightmare
Deployment	Install Claude Code on any device or VPS and run	Nightmare
Isolation Model	Folder-based and isolated as needed	Global by default (security nightmare)
Reliability	Simple reliable system for agents	Bugs nightmare
Feature Scope	Lightweight features you actually use	600k+ LOC nightmare
Security	Average Claude Code usage	Nightmare
Cost Efficiency	Efficient usage	Nightmare
Memory	Uses Claude internal memory system + CLAUDE.md	Nightmare

Getting Started in 5 Minutes

claude plugin marketplace add moazbuilds/claudeclaw
claude plugin install claudeclaw

Then open a Claude Code session and run:

/claudeclaw:start

The setup wizard walks you through model, heartbeat, Telegram, Discord, and security, then your daemon is live with a web dashboard.

Contributor Note: Plugin Version Metadata

If you change shipped plugin files under src/, commands/, prompts/, or .claude-plugin/, the plugin metadata version may also need to be bumped so Claude Code and marketplace consumers detect the update correctly.

Helpers:

bun run bump:plugin-version
bun run bump:marketplace-version

Docs-only and other non-shipped changes do not require these bumps.

What Would Be Built Next?

Mega Post: Help shape the next ClaudeClaw features. Vote, suggest ideas, and discuss priorities in this post.

Features

Automation

• Heartbeat: Periodic check-ins with configurable intervals, quiet hours, and editable prompts.
• Cron Jobs: Timezone-aware schedules for repeating or one-time tasks with reliable execution.

Communication

• Telegram: Text, image, and voice support.
• Discord: DMs, server mentions/replies, slash commands, voice messages, and image attachments.
• Time Awareness: Message time prefixes help the agent understand delays and daily patterns.

Multi-Session Threads (Discord)

• Independent Thread Sessions: Each Discord thread gets its own Claude CLI session, fully isolated from the main channel.
• Parallel Processing: Thread conversations run concurrently — messages in different threads don't block each other.
• Auto-Create: First message in a new thread automatically bootstraps a fresh session. No setup needed.
• Session Cleanup: Thread sessions are automatically cleaned up when threads are deleted or archived.
• Backward Compatible: DMs and main channel messages continue using the global session.

See docs/MULTI_SESSION.md for technical details.