The AI agent
for Telegram & TON
Teleton connects AI models with Telegram and the TON blockchain. Send messages, manage groups, execute DeFi transactions, and automate workflows. All through natural language.
Telegram
Integrated with
From install to automation
in three steps
// Install Teleton globally with npm or your preferred package manager
npm install -g teleton@latest
// Interactive wizard: connect Telegram, choose AI models, configure TON wallet
teleton setup
// Start the agent and talk to it in any Telegram conversation
teleton start
120+ tools built-in.
Infinitely extensible.
Telegram Messaging
Full MTProto userbot access. Send messages, photos, voice notes, stickers, GIFs, polls, and reactions.
Group Management
Create groups, ban, kick, mute, promote admins, and moderate communities through natural language.
Multi-Model AI
Claude, GPT-4, Gemini, Grok, Groq, and any model via OpenRouter. Switch providers without changing code.
TON Wallet
W5R1 wallet built-in. Send and receive TON, check balances, view transaction history, and track live prices.
DeFi Trading
Swap jettons on STON.fi and DeDust with automatic best-price routing. Track trending tokens, pools, and holders.
TON DNS
Check domain availability, place auction bids, and link or unlink wallets to .ton domains.
Gift Trading
Buy and sell Telegram collectible gifts with real-time floor prices and strategy-enforced secure deals.
Market Intelligence
Automated price scraping across all gift collections. Floor tracking, price history, and trend analysis.
Casino
On-chain slot machine and dice games with jackpot system, leaderboard, and automatic payouts in TON.
Persistent Memory
SQLite with full-text search and optional vector embeddings. Remembers context across restarts.
Plugin System
Drop a .js file in a folder and restart. Build custom tools without touching the core codebase.
Self-Hosted
Runs entirely on your infrastructure. Your API keys, your wallet, your data. No third-party servers.
Common questions
Is Teleton free to use?
Teleton is open source and free under the MIT license. You only pay for the AI provider you choose (Anthropic, OpenAI, etc.) based on your own usage.
How is this different from a Telegram bot?
Teleton runs as a userbot, not a bot. It connects to your personal Telegram account via MTProto and has access to the full API: reading messages, joining groups, sending media, managing channels. A regular bot can only respond when someone talks to it first.
Will Telegram ban my account?
Teleton uses the official MTProto protocol, which is the same protocol used by all Telegram clients. As long as you don't spam or abuse the platform, your account remains safe.
Which AI models are supported?
Teleton supports Anthropic (Claude), OpenAI (GPT), Google (Gemini), xAI (Grok), Groq, and OpenRouter. Through OpenRouter, you can access hundreds of additional models including Mistral, DeepSeek, Qwen, and Llama.
How secure are my keys and wallet?
All credentials are stored locally in your workspace directory. Wallet keys never leave your machine and all transaction signing happens locally. The configuration is sandboxed and immutable at runtime.
What are the system requirements?
Node.js 20 or higher, a Telegram account, and an API key from at least one AI provider. Works on Linux, macOS, and Windows. Can also run via Docker.
Can I run it on a VPS or server?
Yes. Teleton is designed to run headless on any server. Use Docker or run directly with Node.js. It persists memory and state across restarts, so it can run 24/7 unattended.
Can I add my own tools or integrations?
Yes. Drop a JavaScript file in the plugins folder and restart. Your tool becomes available to the agent immediately, no rebuild required. See the documentation for the plugin API.
Do I need programming knowledge?
Not to use it. The setup wizard guides you through configuration and the agent operates through natural language. Programming knowledge is only needed if you want to build custom plugins.
How does the agent handle TON transactions?
Teleton uses a W5R1 wallet created during setup. It can send and receive TON, swap jettons on STON.fi and DeDust, bid on DNS auctions, and manage NFTs. All transactions are signed locally.
Ready to automate?
Install Teleton and connect your Telegram account in minutes.