Soulcast

Soulcast

**Open-source AI agent gateway for Telegram.** Control Claude Code from your phone — with persistent memory, bot identity, and conversation continuity.

Built with **Bun + TypeScript**. Inspired by OpenClaw. Secure by default.

[](LICENSE) [](tsconfig.json) [](https://bun.sh)

---

Why Soulcast?

Most Claude Code Telegram wrappers are either broken, Python-based, or have no identity system. Soulcast takes the best ideas from OpenClaw and rebuilds them in TypeScript/Bun:

vs	Advantage
OpenClaw	Pure TS/Bun, simpler setup, no grammy dependency crashes
claude-code-telegram	Not Python — 3x faster startup, native SQLite, typed end-to-end
Claude Code Channels	No channelsEnabled org policy restriction, works on Claude Max

---

Features

Feature	Description
Full Claude Code Access	Read, write, edit files, run bash, git — all from Telegram
OpenClaw-Style Identity	SOUL.md personality system — bot knows who it is, never says "I'm Claude"
First-Chat Onboarding	Pick a personality (Jarvis, Sherlock, Gandalf, etc.) via inline buttons
Voice Chat	Send voice messages — transcribed via Groq Whisper, replies with Edge TTS voice ($0/mo)
File Uploads	Send documents, photos, videos — Claude reads and analyzes them
Live Streaming Updates	See tools being used in real-time (📖 Read, 💻 Bash, 🔧 Edit)
Scheduled Tasks	Cron jobs with natural language ("every day at 9am") + session isolation
Session Continuity	Auto-resumes Claude sessions with --resume for multi-turn conversations
Conversation Memory	Recent messages injected as context when sessions expire
Persistent Memory	Per-user /remember and /memory with SQLite + Markd