teleclaw

v1.0.0

Published

14 hours ago

AI Agent for Telegram & TON Blockchain

Downloads

710

0High
0Medium
0Low

teleclaw

telegram ai agent ton blockchain bot llm telegram-bot defi fragment gifts otc self-hosted

Quick Start

npm install -g teleclaw
teleclaw setup
teleclaw start

Setup walks you through bot token, AI provider, and wallet — you're live in under 2 minutes.

What Is This?

Teleclaw is a personal AI agent that runs as your Telegram bot. You chat with it in plain text, and it uses 150+ built-in tools to handle everything on TON.

Teleclaw Agent is based on the open-source TONresistor/teleton-agent project and includes Teleclaw-specific modifications, improvements, and additional features.

Named by Durov — Pavel Durov demoed a bot called TeleClaw when announcing real-time streaming for Telegram bots.

Features

| Category | What It Does | |----------|-------------| | Fragment | Username sniping, whale tracking, valuation engine, market analytics | | OTC Marketplace | Cross-bot P2P trading for usernames, gifts, and +888 numbers | | Gifts | Rarity analysis, price comparison, portfolio valuation, marketplace aggregator | | DeFi | STON.fi & DeDust swaps, pool analytics, trending tokens | | Agentic Wallet | TON wallet with transfers, safety rules, and PIN protection | | Whale Watcher | Track large wallet movements in real-time | | Alpha Radar | Monitor channels for early signals | | Multi-Model AI | Claude, GPT, Gemini, Grok, DeepSeek, Mistral, local models — 30+ providers | | Memory | Per-user conversations, persistent context across sessions | | Plugin System | Build custom tools with hot-reload SDK |

Configuration

# ~/.teleclaw/config.yaml
telegram:
  bot_token: "your-bot-token"    # from @BotFather
  admin_ids: [123456789]

agent:
  provider: anthropic            # or openai, google, xai, groq, local...
  api_key: "your-api-key"
  model: claude-sonnet-4-20250514

wallet:
  mnemonic: "your 24 words"      # optional — enables TON features

Self-Service Commands

Users can configure their own AI provider without touching config files:

| Command | What It Does | |---------|-------------| | /addprovider | Set up AI provider with inline buttons (supports ChatGPT & Claude subscriptions) | | /models | Switch between providers and models mid-conversation | | /removeprovider | Clear custom provider settings | | /otc | OTC marketplace info and how-to |

Docker

docker run -d \
  -v teleclaw-data:/data \
  -e BOT_TOKEN=your_token \
  -e AI_PROVIDER=anthropic \
  -e AI_API_KEY=sk-ant-... \
  teleclaw/agent:latest

CLI

teleclaw setup          # Interactive setup wizard
teleclaw start          # Start the agent
teleclaw doctor         # Diagnose issues
teleclaw skill create   # Create a custom tool
teleclaw skill list     # List installed tools
teleclaw config set     # Update config values
teleclaw mcp add        # Add MCP server

Architecture

User ──→ Telegram Bot API ──→ Teleclaw Agent ──→ AI Provider
                                    │
                          Tool Registry (150+)
                          ├── Fragment (70+ tools)
                          ├── DeFi (swaps, pools)
                          ├── Agentic Wallet
                          ├── OTC Marketplace
                          ├── Memory & Sessions
                          └── Custom Plugins

$TELECLAW

| | | |---|---| | Token | TELECLAW 🦞 | | Chain | TON | | DEX | DeDust | | Chart | DexScreener | | Utility | OTC Marketplace access (0.1% supply gate) |

CA: EQD01TwE1plYpYKvRwWOLwAzzAJaDKwpB2bR3nfg-wkJJwks

Requirements

Node.js 20+
Telegram bot token (free from @BotFather)
AI provider API key

Contributing

PRs welcome. Please target the dev branch.

git clone https://github.com/teleclawagent/teleclaw-agent.git
cd teleclaw-agent
npm install
npm run typecheck
npm test

License

MIT