ESC
Start typing to search...

Teleton Agent

Autonomous AI agent that operates as a real Telegram user with native TON blockchain integration. 132 built-in tools, persistent memory, and 15 LLM providers.

Quick Install

Terminal 
npm install -g teleton@latest

Then run the setup wizard:

Terminal 
teleton setup      # Interactive wizard
teleton start      # Begin agent
teleton start --webui  # Enable dashboard

Capabilities

  • Real Telegram User. Operates via MTProto/GramJS as an actual user, not a limited bot. Full access to all Telegram features.
  • TON Native. W5R1 wallet, TON transfers, DEX swaps on STON.fi & DeDust, NFTs, and DNS domain management.
  • Multi-LLM. 15 LLM providers: Anthropic, OpenAI, Google Gemini, xAI Grok, Groq, OpenRouter, Moonshot, Mistral, Cerebras, ZAI, MiniMax, HuggingFace, and more.
  • Persistent Memory. Hybrid RAG with sqlite-vec and FTS5. AI-powered auto-compaction keeps context relevant.
  • 132 Built-in Tools. Telegram messaging (76), blockchain ops, DEX trading, DNS, escrow deals, journals, exec, workspace, web, and more.
  • Plugin SDK. Extend with custom plugins. Frozen namespaced API (sdk.ton, sdk.telegram, sdk.bot, sdk.db), isolated databases, and lifecycle hooks.
  • Bot SDK. Plugin inline mode with colored buttons (GramJS Layer 222) and rate limiting.
  • WebUI Dashboard. Optional Hono + React dashboard with run/stop controls, live token usage, and setup wizard.
  • MCP Servers. Connect external Model Context Protocol servers via Streamable HTTP + SSE.

Tech Stack

Component Technology
Framework TypeScript 5.7, Node.js 20+
Telegram GramJS (MTProto) + Grammy (Bot API)
Blockchain TON SDK with W5R1 wallet
Database better-sqlite3 (WAL mode)
Search sqlite-vec + FTS5 hybrid
Embeddings ONNX local, Anthropic API, or FTS5-only
WebUI Hono + React + Vite
MCP @modelcontextprotocol/sdk

Agentic Loop

Teleton implements a think-act-observe loop with configurable iterations per message. Each cycle: analyze request → select tool → execute → observe results → repeat until done.

See Architecture for details.

Admin Commands

Control your agent with these commands (prefix with /, !, or .):

Command Description
/status Show agent status and stats
/model [name] Switch LLM model
/policy [scope] Manage access policies
/wallet Show wallet info
/task [action] Manage scheduled tasks
/pause Pause agent
/resume Resume agent
/stop Stop agent

Next