TeleClaude dla Claude Code w Telegram

TeleClaude: samohostowany bot Telegram dla izolowanych sesji Claude Code

Po blokadzie OpenClaw, programiści utracili dostęp do Claude Code przez Telegram. TeleClaude rozwiązuje ten problem: aplikacja w TypeScript na Bun uruchamia lokalne procesy Claude Code CLI, kierując wiadomości z tematów supergrupy do izolowanych katalogów roboczych. Wykorzystuje autoryzację OAuth Twojej subskrypcji Claude bez pośredników.

Architektura i routing

TeleClaude integruje się z API bota Telegram przez Grammy. Każda wiadomość z tematu supergrupy uruchamia oddzielny proces Claude Code z własnym katalogiem projektu. Obsługiwana jest ciągłość sesji, kompresja kontekstu i deduplikacja pamięci.

Telegram Bot API → Grammy Router → Menedżer procesów → Claude Code CLI (na temat)

Kluczowe komponenty:

• Routing według tematów z iniekcją kontekstu.
• Menedżer procesów z TTL, limitami równoległości i czyszczeniem.
• System plików pamięci: SOUL.md (osobowość), main-memory.md (baza ogólna), topic-memory.md (projektowa).

System pamięci i jej poziomy

Pamięć jest zorganizowana w trzy poziomy, aby zachować kontekst między sesjami:

project/
├── SOUL.md              # Styl komunikacji, zasady
├── main-memory.md       # Symlink do bazy ogólnej
├── topic-memory.md      # Automatycznie aktualizowana historia projektu
└── memory/
    ├── people/
    ├── services/
    ├── shared/
    └── projects/

Claude Code samodzielnie aktualizuje topic-memory.md. Po restarcie lub zresetowaniu sesji kontekst jest przywracany z plików. Deduplikacja usuwa powtórzenia między plikami okresowo.

Automatyzacja projektów i kompresja

Nowy temat w supergrupie automatycznie tworzy katalog z szablonu templates/. Bot linkuje SOUL.md, main-memory.md i inicjalizuje pamięć. Pierwsza wiadomość uruchamia Claude Code z gotowym kontekstem.

Kompresja aktywuje się przy zbliżaniu do limitu kontekstu: kluczowe fakty są zapisywane w pamięci, a sesja jest resetowana. Komenda /compact uruchamia ją ręcznie.

Możliwości TeleClaude

• Routing według tematów: izolacja procesów i katalogów.
• Trwała pamięć: trzy poziomy z dostępem między projektami.
• Automatyczne tworzenie projektów: szablony dla nowych tematów.
• Wiadomości głosowe: opcjonalna transkrypcja przez lokalny Whisper.
• Streaming: wskaźnik "pisze" i stopniowe aktualizacje.
• Modele: Opus, Sonnet, Haiku lub lokalne przez Claude Code.
• Zarządzanie: TTL, limity, zabijanie procesów.

Instalacja i konfiguracja

Wymagania: Bun 1.0+, autoryzowany Claude Code CLI, bot Telegram, supergrupa z tematami.

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

W settings.json ustaw allowedUsers, ttlMinutes (domyślnie 30), maxConcurrent (5), claudePath.

Komendy bota

| Komenda | Opis |

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

| /help | Lista komend |

| /status | Aktywne procesy, status |

| /ttl N | Limit bezczynności (1–1440 min) |

| /name <nazwa> | Zmiana nazwy tematu |

| /reset | Reset z zachowaniem pamięci |

| /kill | Zatrzymanie procesu tematu |

| /memory | Statystyki pamięci |

Porównanie z OpenClaw

| Aspekt | TeleClaude | OpenClaw |

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

| Hosting | Samohostowany | Chmurowy |

| Backend | Claude Code CLI | API |

| Autoryzacja | OAuth Twojej subskrypcji | Zarządzana |

| Koszt | Tylko subskrypcja Claude | Dodatkowy |

| Pamięć | Plikowa, trwała | Wbudowana |

Co jest ważne

• Pełna izolacja kontekstu według tematów bez przełączania okien.
• Rozwiązanie samohostowane bez kosztów ponad subskrypcję Claude.
• Automatyczna kompresja i odzyskiwanie kontekstu.
• Obsługa głosu przez Whisper i streaming odpowiedzi.
• Licencja MIT, dostosowanie szablonów i ustawień.

— Editorial Team