Self-hosted AI agent gateway that connects LLM providers to messaging platforms (Telegram, Discord, WhatsApp) with a built-in web dashboard, tool execution, persistent memory, and skill system.
- Sessions are stored in SQLite (
/data/eazyclaw/sessions/sessions.db), not JSON files. - Web API and dashboard session history use built-in pagination (
limit/offsetand keysetbefore_seq). - Token telemetry is persisted per session:
last_prompt_tokens- cumulative
total_input_tokens/total_output_tokens - per-turn
last_turn_input_tokens/last_turn_output_tokens
- Auto-compaction uses message thresholds plus token headroom checks, and can run a pre-compaction memory flush.
- This repository is treated as greenfield: there is no legacy JSON session migration path.
# Clone and configure
git clone https://github.com/Naveenxyz/eazyclaw.git
cd eazyclaw
cp .env.example .env
# Edit .env — set at least one provider API key (e.g. KIMI_API_KEY)
# Build and run
docker compose up -d
# Open dashboard
open http://localhost:8080Get a personal AI agent running for ~$1/month (Kimi Coding $1 + Railway free tier).
See the Getting Started Guide — deploy to Telegram + Railway in under 10 minutes.
- Web Dashboard — Browser-based chat, enabled by default on port 8080
- Telegram — Set
TELEGRAM_BOT_TOKENto enable - Discord — Set
DISCORD_BOT_TOKENto enable - WhatsApp — Set
WHATSAPP_ENABLED=true, scan QR once
Six LLM providers supported. Set any combination of API keys:
| Provider | Env Var |
|---|---|
| Kimi Coding (recommended) | KIMI_API_KEY |
| Anthropic (Claude) | ANTHROPIC_API_KEY |
| OpenAI (GPT) | OPENAI_API_KEY |
| Google Gemini | GEMINI_API_KEY |
| Moonshot | MOONSHOT_API_KEY |
| Zhipu | ZHIPU_API_KEY |
See Providers for details and model configuration.
shell · read_file · write_file · edit_file · list_dir · web_fetch · web_search · memory_read · memory_write · memory_search · cron
Runtime includes git, gh, rg, fd, tree, wget, jq, tmux, node, npm, python3, uv.
| Guide | Description |
|---|---|
| Getting Started | Onboarding: Kimi + Railway in 10 minutes |
| Providers | All 6 providers, model config, multi-provider routing |
| Configuration | config.yaml reference + environment variables |
| Memory System | Persona, bootstrap files, compaction, day-wise memory |
| Skills | Using and creating skill packages |
| Architecture | System diagram, project structure, message flow |
| Development | Local build, tests, Docker |
| Channel Guides | |
| Discord | Bot token, permissions, guild config |
| Telegram | BotFather setup, user approval |
| Bridge setup, QR login, troubleshooting | |
| Web Dashboard | Password, tabs, features |
MIT. See LICENSE.