Telegram AI Agent
for TON Blockchain
A modular AI agent that operates its own Telegram account (not a bot) with native TON integration. Persistent memory, scheduled tasks, MCP support, web dashboard, and a plugin SDK. Fully customizable, extensible by design.
Telegram
From install to automation
in three steps
Install
Install globally via npm, yarn, or pnpm.
$ npm install -g teleton@latest
Configure
Connect Telegram, choose your AI provider, generate a TON wallet.
$ teleton setup
Start
Launch the agent. Talk to it in any Telegram conversation.
$ teleton start
125+ tools built-in.
Infinitely extensible.
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.
Telegram Messaging
Full MTProto userbot access. Send messages, photos, voice notes, stickers, GIFs, polls, and reactions.
Channel & Group Management
Create, moderate, and manage groups and channels. Ban, mute, promote admins, and automate moderation through natural language.
TON DNS
Check domain availability, place auction bids, and link or unlink wallets to .ton domains.
Gifts & Stars
Buy, sell, and transfer Telegram collectible gifts. Track stars balance, transaction history, and floor prices.
Plugin SDK
Full SDK with TON wallet, Telegram API, database, and secrets management. Drop a file, restart, done.
Web Dashboard
Monitor status, manage tools, edit memory, stream logs, and configure plugins from your browser.
Multi-Model AI
Claude, GPT-4, Gemini, Grok, Groq, and any model via OpenRouter. Switch providers without changing code.
Vision Analysis
Analyze images sent in chat. Understands screenshots, photos, documents, and memes via multimodal LLM.
Web Search
Search the web and extract content from URLs autonomously. Powered by Tavily with topic filtering and relevance scoring.
Scheduled Tasks
Schedule autonomous tasks with DAG-based dependency chains. The agent executes them on its own.
MCP Support
Connect external MCP servers via stdio or SSE. Auto-discovers tools and registers them into the agent.
Persistent Memory
SQLite with full-text search and optional vector embeddings. Remembers context across restarts.
Sandbox Workspace
Isolated file system with path traversal protection. The agent reads, writes, and manages files without accessing your secrets.
Management API
HTTPS control plane for remote management. Start, stop, configure your agent from anywhere with TLS encryption and API key auth.
P2P Deals
Built-in escrow system for peer-to-peer trading. On-chain payment verification, strategy enforcement, and inline Telegram buttons.
User Hooks
Custom triggers that fire on keywords, patterns, or context. Automate responses, moderate content, and build complex workflows.
Plugins for Everything
Extend your agent with community-built plugins. DeFi trading, analytics, social automation, and more.
Or Build Your Own
Full SDK to create custom plugins in minutes. Access TON, Telegram, database, secrets, and more.
import { ton } from 'teleton';
// Send & receive TON
await ton.send(address, amount);
// Swap jettons
await ton.swap(tokenA, tokenB, amount);
// Check balances
const balance = await ton.getBalance(address);
// Verify payments
const verified = await ton.verifyPayment(txHash);
// NFT operations
await ton.mintNFT(collection, metadata);Got Questions?
Read the full FAQ or join the community to ask directly.