Gobot

Always-On AI Telegram Agent

Claude-Powered Multi-Agent Persistent Memory Voice-Enabled

Created by Goda Go | Autonomee Community

What is Gobot?

Your personal always-on AI assistant that lives in Telegram

🤖 Claude-Powered

Full Claude Code CLI with MCP servers, skills, hooks, and built-in tools

🧠 Persistent Memory

Remembers facts, goals, and context across conversations via Supabase

📱 Multi-Agent

Specialized agents for different tasks via Telegram forum topics

⏰ Proactive

Smart check-ins and morning briefings that know when to reach out

Core Features

  • Message Relay: Send messages on Telegram, get Claude responses back
  • Voice Integration: Text-to-speech replies, voice transcription, phone calls
  • Human-in-the-Loop: Confirmation buttons before taking actions
  • Morning Briefings: Daily summary with goals and MCP server context
  • Smart Check-ins: Proactive outreach that respects your time
  • Auto-Deploy: Push to GitHub, VPS pulls and restarts automatically

Deployment Modes

Choose the setup that fits your needs

Mode How It Works Cost
Local Only Runs on your desktop with Claude Code CLI Free with Claude sub ($20/mo)
VPS ⭐ Always-on server, Claude Code CLI + API key VPS (~$5/mo) + API tokens
Hybrid VPS forwards to local when awake (free), uses API when sleeping VPS cost + subscription

Recommended: VPS mode for 24/7 availability

How It Works

┌─────────────┐     ┌──────────────┐     ┌─────────────────────┐
│  Telegram    │────▶│  Gobot       │────▶│  Claude Code CLI    │
│  (grammY)   │◀────│  (polling)   │◀────│  + ANTHROPIC_API_KEY │
└─────────────┘     └──────┬───────┘     │                     │
                           │              │  ✅ MCP Servers      │
                    ┌──────┴───────┐     │  ✅ Skills           │
                    │  Supabase    │     │  ✅ Hooks            │
                    │  - Messages  │     │  ✅ CLAUDE.md        │
                    │  - Memory    │     │  ✅ Built-in Tools   │
                    │  - Tasks     │     └─────────────────────┘
                    └──────────────┘

Same code, full power — everywhere

Tech Stack

Runtime

Bun

Telegram

grammY

AI (Local)

Claude Code CLI

AI (VPS)

Anthropic API

Database

Supabase

Voice

ElevenLabs

Plus: MCP servers for Gmail, Calendar, Notion, GitHub, and more

Getting Started

Prerequisites

  • Bun runtime installed
  • Claude Code CLI installed and authenticated
  • Windows/Linux: PM2 for services

Setup

# Clone the repo
git clone https://github.com/autonomee/gobot.git
cd gobot

# Install dependencies
bun install

# Open with Claude Code for guided setup
claude

Claude Code Guides You

Just run claude and it reads CLAUDE.md to walk you through:

  • Creating a Telegram bot via BotFather
  • Setting up Supabase for persistent memory
  • Personalizing your profile and agents
  • Testing the bot
  • Configuring always-on services
  • Setting up voice and phone calls (optional)
  • Deploying to VPS (optional)

No manual configuration needed — Claude handles it all

Available Commands

# Local mode
bun run start              # Start bot (polling mode, uses Claude Code CLI)

# VPS mode
bun run vps                # Start VPS gateway (webhook mode, uses Anthropic API)

# Background services
bun run checkin            # Run smart check-in
bun run briefing           # Run morning briefing
bun run watchdog           # Run health check

# Setup & testing
bun run setup              # Install dependencies
bun run setup:launchd      # Configure launchd services (macOS)
bun run setup:services     # Configure services (Windows/Linux)
bun run setup:verify       # Full health check
bun run test:telegram      # Test Telegram connectivity
bun run test:supabase      # Test Supabase connectivity
bun run uninstall          # Remove all services

Why Hybrid Mode?

Your laptop sleeps. Your VPS doesn't.

  • Messages are always processed, even at 3am
  • When your local machine is awake, it handles everything for free with subscription
  • When it sleeps, VPS takes over with API key (pay-per-token)
  • Both have full Claude Code power — MCP servers, skills, hooks, everything
┌───────────┐     ┌──────────────────────────────────────┐
│ Telegram  │     │  VPS (always on, Claude Code + API)  │
│           │────▶│                                       │
│           │◀────│  Is local machine alive?              │
└───────────┘     │  ├── YES → forward (free)            │
                  │  └── NO  → process (API tokens)      │
                  └──────────────┬───────────────────────┘
                                 │
                          ┌──────┴───────┐
                          │  Supabase    │
                          │  (shared)    │
                          └──────────────┘

Learn to Build This

Step-by-step video walkthroughs for every module

Join Autonomee Community

Get help with setup, share your builds, and access exclusive content

Ready to Build Your AI Agent?

View on GitHub

Resources:

README | FAQ | Architecture | Troubleshooting

Built by Goda Go | MIT License