Liteclaw

LiteClaw

[](./LICENSE) [](https://www.python.org/downloads/) [](#platform-support) [](https://github.com/breaktheready/liteclaw/actions/workflows/ci.yml) [](https://github.com/breaktheready/liteclaw/stargazers)

Control Claude Code CLI remotely via Telegram. No API key needed.

[한국어](README_KO.md)

---

Why I made this

I'm not really a programmer — more of a power user who relies on Claude Code daily. When OpenClaw got cut off, I needed a way to keep using Claude Code from my phone.

My solution was pretty basic: a Python script that connects Telegram to a Claude Code session running in tmux. It types your message into the terminal (`send-keys`) and reads back what's on screen (`capture-pane`). That's it.

No API key needed. No extra cost. If you're already paying for Claude Code, this just lets you use it remotely.

It works for what I need, so I figured I'd share it in case others are looking for something similar.

---

How is this different?

Unlike tools that call Claude's API directly (which means extra costs), LiteClaw operates your **existing Claude Code CLI session** through tmux. You're already paying for Claude Max — this just lets you use it from your phone.

• Single Python file (~900 lines), not a framework
• No API keys to Anthropic needed
• No containers, no Docker
• Your subscription covers everything

Features

• Remote access — Control Claude Code from anywhere via Telegram
• AI summarization — Responses cleaned up by an LLM before delivery (toggleable)
• Busy detection — Knows when Claude is working, queues your message autom