Claude Telegram Relay

Claude Telegram Relay

A personal AI assistant on Telegram powered by Claude Code.

You message it. Claude responds. Text, photos, documents, voice. It remembers across sessions, checks in proactively, and runs in the background.

**Created by [Goda Go](https://youtube.com/@GodaGo)** | [AI Productivity Hub Community](https://skool.com/autonomee)

You ──▶ Telegram ──▶ Relay ──▶ Claude Code CLI ──▶ Response
                                    │
                              Supabase (memory)

What You Get

• Relay: Send messages on Telegram, get Claude responses back
• Memory: Semantic search over conversation history, persistent facts and goals via Supabase
• Proactive: Smart check-ins that know when to reach out (and when not to)
• Briefings: Daily morning summary with goals and schedule
• Voice: Transcribe voice messages (Groq cloud or local Whisper — your choice)
• Always On: Runs in the background, starts on boot, restarts on crash
• Guided Setup: Claude Code reads CLAUDE.md and walks you through everything

Quick Start

Prerequisites

• Bun runtime (curl -fsSL https://bun.sh/install | bash)
• Claude Code CLI installed and authenticated
• A Telegram account

Option A: Guided Setup (Recommended)

git clone https://github.com/godagoo/claude-telegram-relay.git
cd claude-telegram-relay
claude

Claude Code reads `CLAUDE.md` and walks you through setup conversationally:

1. Create a Telegram bot via BotFather
2. Set up Supabase for persistent memory
3. Personalize your profile
4. Test the bot
5. Configure always-on services
6. Set up proactive check-ins and briefings
7. Add voice transcription (optional)

Option B: Manual Setup

git clone https://github.com/godagoo/claude-telegram-relay.git
cd claude-telegram-relay
bun run setup          # Install deps, create .env
# Edit .env with your API keys
bun run test:telegram  # Verify bot