TeleClaude pro Claude Code v Telegramu

TeleClaude: Vlastnohostovaný Telegram bot pro izolované relace Claude Code

Po zablokování OpenClaw vývojáři ztratili přístup k Claude Code přes Telegram. TeleClaude tento problém řeší: TypeScript aplikace na Bun spouští lokální procesy Claude Code CLI, směruje zprávy z témat supergroup do izolovaných pracovních adresářů. Používá OAuth autorizaci vašeho předplatného Claude bez prostředníků.

Architektura a směrování

TeleClaude se integruje s Telegram Bot API prostřednictvím Grammy. Každá zpráva z tématu supergroup spustí samostatný proces Claude Code s vlastním projektovým adresářem. Podporuje se kontinuita relací, komprese kontextu a deduplikace paměti.

Telegram Bot API → Grammy Router → Správce procesů → Claude Code CLI (na téma)

Klíčové komponenty:

• Směrování podle témat s injekcí kontextu.
• Správce procesů s TTL, limity paralelismu a čištěním.
• Souborový systém paměti: SOUL.md (osobnost), main-memory.md (společná základna), topic-memory.md (projektová).

Systém paměti a její úrovně

Paměť je organizována do tří úrovní pro zachování kontextu mezi relacemi:

project/
├── SOUL.md              # Styl komunikace, pravidla
├── main-memory.md       # Symbolický odkaz na společnou základnu
├── topic-memory.md      # Automaticky aktualizovaná historie projektu
└── memory/
    ├── people/
    ├── services/
    ├── shared/
    └── projects/

Claude Code samostatně aktualizuje topic-memory.md. Při restartu nebo resetu relace je kontext obnoven ze souborů. Deduplikace odstraní opakování mezi soubory periodicky.

Automatizace projektů a komprese

Nové téma v supergroup automaticky vytvoří adresář ze šablony templates/. Bot propojí SOUL.md, main-memory.md a inicializuje paměť. První zpráva spustí Claude Code s připraveným kontextem.

Komprese se aktivuje při přiblížení k limitu kontextu: klíčová fakta jsou uložena do paměti, relace je resetována. Příkaz /compact spustí manuálně.

Možnosti TeleClaude

• Směrování podle témat: izolace procesů a adresářů.
• Trvalá paměť: tři úrovně s křížovým přístupem k projektům.
• Automatické vytváření projektů: šablony pro nová témata.
• Hlasové zprávy: volitelná transkripce přes lokální Whisper.
• Streamování: indikátor "píše" a postupné aktualizace.
• Modely: Opus, Sonnet, Haiku nebo lokální via Claude Code.
• Správa: TTL, limity, ukončení procesů.

Instalace a konfigurace

Požadavky: Bun 1.0+, autorizovaný Claude Code CLI, Telegram bot, supergroup s tématy.

git clone https://github.com/devladpopov/teleclaude.git
cd teleclaude
bun install
cp .env.example .env
cp config/settings.example.json config/settings.json
bun run start

V settings.json nastavte allowedUsers, ttlMinutes (30 výchozí), maxConcurrent (5), claudePath.

Příkazy bota

| Příkaz | Popis |

|---------|----------|

| /help | Seznam příkazů |

| /status | Aktivní procesy, stav |

| /ttl N | Časový limit nečinnosti (1–1440 min) |

| /name <název> | Přejmenování tématu |

| /reset | Reset s uchováním paměti |

| /kill | Zastavení procesu tématu |

| /memory | Statistiky paměti |

Srovnání s OpenClaw

| Aspekt | TeleClaude | OpenClaw |

|--------|------------|----------|

| Hosting | Self-hosted | Cloudový |

| Backend | Claude Code CLI | API |

| Autorizace | OAuth vašeho předplatného | Spravovaná |

| Náklady | Pouze předplatné Claude | Dodatečné |

| Paměť | Souborová, trvalá | Vestavěná |

Co je důležité

• Úplná izolace kontextu podle témat bez přepínání oken.
• Self-hosted řešení bez nákladů nad rámec předplatného Claude.
• Automatická komprese a obnova kontextu.
• Podpora hlasu přes Whisper a streamování odpovědí.
• MIT licence, přizpůsobení šablon a nastavení.

— Editorial Team