Claude Telegram

claude-telegram

[](https://www.npmjs.com/package/claude-telegram)

A simple and modular Telegram orchestrator on top of Claude Code CLI.

One npm package that connects a Telegram bot to Claude Code via `--resume` sessions, with whitelist access control and live activity status.

npm install -g claude-telegram

claude-telegram vs OpenClaw

	claude-telegram	OpenClaw
Core	~1500 LOC, one dependency (grammY)	50+ integrations, large codebase
Approach	Minimal orchestrator — Claude Code does the work	Full-featured AI assistant platform
Extensibility	Module system — add anything you need	Built-in, growing feature set
Control	You own the code, easy to audit and modify	Community-driven, fast-moving
Setup	npx claude-telegram start	Multi-step setup

Both are valid choices. claude-telegram is for those who prefer a small, predictable core that they extend themselves.

Installation

**1. Get a server** — a VPS, a home PC, anything with internet access.

**2. Install Claude Code:**

curl -fsSL https://claude.ai/install.sh | bash

**3. Install claude-telegram:**

npm install -g claude-telegram

Or run without installing via `npx claude-telegram`.

Alternatively, give Claude the link and let it handle everything:

claude "install claude-telegram from github.com/bluzir/claude-telegram and set it up for my Telegram bot"

Quick Start

mkdir my-agent && cd my-agent
echo "You are a helpful assistant." > CLAUDE.md

cat > claude-telegram.yaml << 'EOF'
token: ${MY_BOT_TOKEN}
workspace: .
whitelist: [YOUR_USER_ID]
permission_mode: acceptEdits
EOF

export MY_BOT_TOKEN="123456:ABC-DEF..."
npx claude-telegram start

Don't know your Telegram user ID? Run `npx claude-telegram whoami` and send a message to the bot.

Config

Create `claude-telegram.yaml` in your project root: