Configuration - Teleton Agent Documentation

File Locations

Teleton stores all configuration and data in the ~/.teleton directory:

File	Purpose
`~/.teleton/config.yaml`	Main configuration file
`~/.teleton/memory.db`	SQLite database for memory and embeddings
`~/.teleton/wallet.json`	Encrypted TON wallet
`~/.teleton/session.json`	Telegram session data
`~/.teleton/workspace/`	Agent workspace with personality files

config.yaml

The main configuration file. Run teleton setup to create it interactively, or create it manually:

~/.teleton/config.yaml

# Teleton Agent Configuration

# Telegram Settings
telegram:
  apiId: 12345678
  apiHash: 'your_api_hash_here'
  phoneNumber: '+1234567890'

# LLM Provider
llm:
  provider: anthropic  # anthropic | openai | google | xai | groq | openrouter
  model: claude-sonnet-4-20250514
  apiKey: ${ANTHROPIC_API_KEY}  # Use env var
  maxTokens: 4096
  temperature: 0.7

# Agent Behavior
agent:
  maxIterations: 5        # Tool-calling iterations per message
  debounceMs: 2000        # Group message debounce
  enableToolRag: true     # Semantic tool selection

# Memory Settings
memory:
  embeddings:
    provider: local       # local (ONNX) | voyage
    model: all-MiniLM-L6-v2
  autoCompact: true       # AI-powered memory compaction
  compactThreshold: 1000  # Compact after N entries

# TON Wallet
wallet:
  network: mainnet        # mainnet | testnet
  version: W5R1

# Access Control
policy:
  defaultScope: dm        # dm | group | admin
  adminUsers:
    - 123456789           # Your Telegram user ID

# WebUI (optional)
webui:
  enabled: false
  port: 3000
  auth:
    username: admin
    password: ${WEBUI_PASSWORD}

Environment Variables

Sensitive values can be stored in environment variables and referenced with ${VAR_NAME} syntax:

~/.bashrc or .env

export ANTHROPIC_API_KEY='sk-ant-...'
export OPENAI_API_KEY='sk-...'
export VOYAGE_API_KEY='pa-...'
export WEBUI_PASSWORD='secure-password'

Security: Never commit API keys or passwords to version control. Always use environment variables for sensitive data.

Workspace Files

The workspace directory contains files that define your agent's personality and behavior:

File	Purpose
`SOUL.md`	Agent's core personality and communication style
`STRATEGY.md`	Decision-making guidelines and priorities
`SECURITY.md`	Security policies and restrictions
`MEMORY.md`	Long-term facts and user preferences

Example SOUL.md

~/.teleton/workspace/SOUL.md

# Agent Personality

You are a helpful assistant specialized in TON blockchain operations.

## Communication Style
- Be concise and technical when appropriate
- Use emojis sparingly for friendly interactions
- Always confirm before executing financial transactions

## Language
- Default: English
- Adapt to user's language preference

LLM Providers

Teleton supports multiple LLM providers:

Provider	Models	Config Key
Anthropic	Claude 3.5 Sonnet, Claude 3 Opus	`anthropic`
OpenAI	GPT-4o, GPT-4 Turbo	`openai`
Google	Gemini Pro, Gemini Ultra	`google`
xAI	Grok-2, Grok-2 Mini	`xai`
Groq	Llama 3.1, Mixtral	`groq`
OpenRouter	Any supported model	`openrouter`