Channels Features Security Architecture Commands GitHub
Open Source Personal Assistant

Your Personal AI Assistant. Powered by Claude Code.

ClaudeClaw runs the real Claude Code CLI on your machine, controlled through Telegram. Persistent memory, autonomous tasks, voice messages, and the full power of every MCP tool you have.

terminal
$ npx tsx scripts/setup.ts Node.js v22.15.0 Dependencies installed Build successful Database OK $ npm start Dashboard started on :3141 Scheduler started (polling every 60s) ClaudeClaw is running

What is Claude Channels?

Claude Channels is an official Anthropic feature that connects Claude Code to messaging platforms. ClaudeClaw is built entirely on top of it — no hacks, no workarounds, no third-party middleware.

Official Anthropic Plugin

Channels is a first-party feature of Claude Code CLI. Your tokens and credentials never leave Anthropic's infrastructure. No third-party code touches your auth.

Telegram Bridge

Run claude --channels plugin:telegram and your Claude Code session becomes accessible via Telegram. Voice messages, photos, documents — everything works.

Full Claude Code Power

Not a wrapper. Not an API proxy. Channels runs the real Claude Code CLI with all your MCP servers, skills, file system access, and tools. The phone is just a remote control.

Why ClaudeClaw?

Not another chatbot wrapper. A real CLI agent under your full control.

Not a Wrapper

Spawns the real Claude Code CLI process. Not an API proxy, not a UI skin. The actual agent with full tool access, skills, and session management.

Your Machine, Your Data

Everything runs locally. Your tokens stay with Anthropic's infrastructure. No third-party servers, no external databases, no data middlemen.

All Your Tools

MCP servers, custom skills, browser automation, file system access, Obsidian, databases. If Claude Code can use it, ClaudeClaw can too.

Security: Channels vs. OpenClaw

How your tokens flow matters. ClaudeClaw uses the official Channels plugin.

OpenClaw / API Proxy

  • × Tokens pass through external code
  • × Prohibited by Anthropic ToS
  • × Security and legal risks
  • × Middleware between you and Claude

ClaudeClaw (Channels)

  • Official Claude Code Channels plugin
  • Tokens stay with Anthropic infrastructure
  • Official Agent SDK — guaranteed compatibility
  • Direct connection — no middleware

Features

Everything you need for a persistent, autonomous AI assistant.

Persistent Memory

SQLite with FTS5 full-text search. Semantic and episodic memories with salience decay. Your assistant remembers across sessions.

Cron Scheduler

Autonomous background tasks. Daily briefings, email monitoring, memory consolidation, and custom scheduled actions.

Web Dashboard

Monitor everything: memory stats, scheduled tasks, token usage, conversation history, and audit log. Served on localhost.

Voice Messages

Groq Whisper transcribes voice notes for free. Send a voice message on Telegram and it's processed as normal text input.

Email Integration

Any IMAP provider. Yandex, Gmail, Outlook. Scheduled email checking, summaries, and action triggers.

Heartbeat

Proactive health checks run in the background. Only notifies you when something actually needs your attention.

Architecture

Two-process model. Channels plugin handles the connection. Your machine does the work.

Telegram
Channels Plugin
Claude Code CLI
Your Project Directory
CLAUDE.md · AGENT.md · USER.md · CLI tools · Skills
SQLite DB
Memory, conversations, scheduled tasks
npm start
Dashboard :3141 · Scheduler · Heartbeat

How It Works

Three steps to a running assistant.

01

Clone & Setup

Clone the repo and run the setup script. It checks Node.js, installs dependencies, builds, and initializes the database.

npx tsx scripts/setup.ts

02

Personalize

Edit CLAUDE.md for agent instructions, USER.md for your profile, and AGENT.md for persona. Your assistant adapts to you.

03

Talk

Send messages via Telegram. Text, voice notes, commands. The full power of Claude Code, always in your pocket.

Telegram Commands

Quick actions available in chat.

Command Description
/newStart a new conversation
/memory search <query>Search memories by keyword
/memory save <text>Save a new memory manually
/schedule listView all scheduled tasks
/schedule createCreate a new scheduled task
/mailCheck email and summarize
/briefingGet a daily briefing
/checkpointForce memory consolidation
/convolifeShow current conversation stats

Tech Stack

TypeScript Node.js 22+ SQLite Hono Groq Whisper Claude Code SDK

Ready to build your assistant?

$ git clone https://github.com/kalbac/claudeclaw.git && cd ClaudeClaw && npx tsx scripts/setup.ts

View on GitHub