Protoagent

[!CAUTION] This project has been archived in favor of newer and more complete initiatives, like [OpenClaw](https://openclaw.ai). See [this blog post](https://dev.to/ggondim/how-i-built-a-deterministic-multi-agent-dev-pipeline-inside-openclaw-and-contributed-a-missing-4ool) to understand why.

---

🤖 Protoagent

**Your AI assistant, your way.** A powerful multi-channel wrapper that lets you interact with AI agents (Claude, Copilot) through Telegram or REST API, using your own subscriptions and running entirely under your control.

Protoagent is a production-ready AI agent orchestrator that bridges the gap between powerful AI providers (Claude SDK, GitHub Copilot CLI) and your preferred communication channels. Built with resilience, memory, and flexibility in mind — no vendor lock-in, just pure control over your AI interactions.

---

🎯 Why Protoagent?

• 🔌 Bring Your Own Subscription: Use your existing Claude Desktop or GitHub Copilot subscriptions — no additional API costs
• 💬 Multi-Channel: Interact via Telegram bot OR REST API (perfect for Siri/Apple Watch integration)
• 🧠 Built-in Memory: Short-term and long-term memory with automatic context injection
• 🛡️ Production-Ready: Crash recovery, circuit breaker, watchdog, and comprehensive logging
• 🎙️ Voice Support: Integrated Whisper transcription for voice messages
• 🔧 Zero Lock-in: Switch providers on-the-fly without changing your workflow

---

⚡ Quick Start

Prerequisites

• Docker and Docker Compose
• Claude Code CLI OR GitHub CLI with GitHub Copilot subscription
• A Telegram Bot token (or enable API mode only)

Installation

# Clone repository
git clone 
cd protoagente

# Configure environment
cp .env.example .env
nano .env  # Edit with your settings (see below)

# Build and start
docker-c