Your Claude Code CLI, delivered to your phone via Telegram.
概览
Your Claude Code CLI, delivered to your phone via Telegram. ClaudeClaw OS is not a chatbot wrapper. It spawns the actual claude CLI on your Mac or Linux machine and pipes the result back to your Telegram chat. Everything that works in your terminal (your skills, your tools, your context) works from your phone. ClaudeClaw has two tiers of features. The features work out of the box with just a Telegram bot token. The features are opt-in and require additional setup. Everything below works with just TELEGRAM_BOT_TOKEN and ALLOWED_CHAT_ID. No extra API keys. These are powerful but require extra API keys or services. Each one has its own setup section below. Follow these steps in order. The whole thing takes about 5 minutes. Run these two commands first (use your own name and email): Without this, git operations will fail with a confusing error about missing identity.
README
以下为原文 README 节选，完整内容请查看原文。
ClaudeClaw OS
██████╗██╗ █████╗ ██╗ ██╗██████╗ ███████╗
██╔════╝██║ ██╔══██╗██║ ██║██╔══██╗██╔════╝
██║ ██║ ███████║██║ ██║██║ ██║█████╗
██║ ██║ ██╔══██║██║ ██║██║ ██║██╔══╝
╚██████╗███████╗██║ ██║╚██████╔╝██████╔╝███████╗
╚═════╝╚══════╝╚═╝ ╚═╝ ╚═════╝ ╚═════╝╚══════╝
██████╗██╗ █████╗ ██╗ ██╗ ██████╗ ███████╗
██╔════╝██║ ██╔══██╗██║ ██║ ██╔═══██╗██╔════╝
██║ ██║ ███████║██║ █╗ ██║ ██║ ██║███████╗
██║ ██║ ██╔══██║██║███╗██║ ██║ ██║╚════██║
╚██████╗███████╗██║ ██║╚███╔███╔╝ ╚██████╔╝███████║
╚═════╝╚══════╝╚═╝ ╚═╝ ╚══╝╚══╝ ╚═════╝ ╚══════╝
Your Claude Code CLI, delivered to your phone via Telegram.
Getting Started
git clone https://github.com/earlyaidopters/claudeclaw-os.git
cd claudeclaw-os
npm install
npm run setup
ClaudeClaw OS is not a chatbot wrapper. It spawns the actual claude CLI on your Mac or Linux machine and pipes the result back to your Telegram chat. Everything that works in your terminal (your skills, your tools, your context) works from your phone.
What You Get
ClaudeClaw has two tiers of features. The core features work out of the box with just a Telegram bot token. The experimental features are opt-in and require additional setup.
Core Features (zero to hero in 5 minutes)
Everything below works with just TELEGRAM_BOT_TOKEN and ALLOWED_CHAT_ID. No extra API keys.
| Feature | What it does |
|---|---|
| Text messaging | Full Claude Code from your phone. All tools, all skills. |
| Photos and documents | Send a photo or PDF, Claude reads and analyzes it |
| Session persistence | Context carries across every message, even after restarts |
| Memory system | SQLite-backed memory that learns about you over time |
| Scheduled tasks | Ask Claude to run anything on a cron schedule |
| Web dashboard | Live monitoring, task management, memory viewer |
| Mission Control | Create tasks, assign to agents, track progress |
| Multi-agent | Run specialist agents (research, comms, content, ops) in parallel |
| All your skills | Every skill in ~/.claude/skills/ auto-loads |
| File sending | Claude can create and send files back to you |
| Voice output (macOS) | Uses say + ffmpeg locally, no API key needed |
Experimental Features (opt-in, additional setup)
These are powerful but require extra API keys or services. Each one has its own setup section below.
| Feature | What you need | Notes |
|---|---|---|
| Voice input | GROQ_API_KEY (free) |
Transcribes your voice notes via Whisper |
| Voice output (cloud) | ElevenLabs, Gradium, or Kokoro | Higher quality than macOS say |
| Video analysis | GOOGLE_API_KEY |
Gemini analyzes videos you send |
| Memory consolidation | GOOGLE_API_KEY |
Gemini detects patterns across conversations |
推荐工具
换一个关键词，或者移除筛选条件。
安装
npx skillfish add g-baskin/claudeclaw-os