ESC
Start typing to search...

Teleton Agent

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

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. Anthropic, OpenAI, Google Gemini, xAI Grok, Groq, and OpenRouter support.
  • Persistent Memory. Hybrid RAG with sqlite-vec and FTS5. AI-powered auto-compaction keeps context relevant.
  • 114 Built-in Tools. Telegram messaging, blockchain ops, DEX trading, DNS, escrow deals, journals, and more.
  • Plugin SDK. Extend with custom plugins. Frozen namespaced API, isolated databases, and lifecycle hooks.

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 or Voyage AI
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