KairoClaw
DhilipBinny/KairoClaw
Self-hosted multi-user AI gateway — Telegram, WhatsApp, web chat. Multi-provider (Anthropic, OpenAI, Ollama), 20+ tools, smart memory, model routing, admin dashboard, cron scheduling.
Instalação
npx convez-ai DhilipBinny/KairoClaw1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
Why KairoClaw
Most AI tools lock you into one chat window, one provider, one user. KairoClaw is different:
- One conversation across every channel — start on Telegram, continue on WhatsApp, finish on the web. Same memory, same context.
- Your team, your rules — add users with role-based permissions. Each person gets isolated memory and workspace.
- Any provider, automatic failover — Anthropic, OpenAI, Ollama. If one goes down, the next picks up. No code changes.
- Self-hosted — your data stays on your infrastructure. No third-party cloud dependency.
Get Started
Docker (recommended)
git clone https://github.com/DhilipBinny/KairoClaw.git
cd KairoClaw
docker compose up -d
Open http://localhost:18181, paste your API key, and start chatting. Works with Anthropic (Claude), OpenAI (GPT-4o), or Ollama (local models).
Bare Metal
git clone https://github.com/DhilipBinny/KairoClaw.git
cd KairoClaw
./scripts/setup-local.sh
Creates a kairo CLI with start, stop, restart, logs, build, dev, status, run commands. Requires Node.js 22+.
Features
| Feature | What it does |
|---|---|
| Multi-Channel | Telegram, WhatsApp, Web Chat — unified conversation across all channels |
| Multi-Provider | Anthropic (Claude), OpenAI (GPT-4o), Ollama, NVIDIA, Azure, Together, vLLM — auto-failover chain |
| Multi-User | Admin, Power User, User roles — per-user workspace, memory, permissions |
| Smart Memory | Auto-extracted user profile + session context. Cross-channel, per-user isolated |
| Model Router | Auto-selects fast/balanced/powerful model per message complexity. Save costs on simple messages |
| Smart Compaction | Two-stage context management — session notes as free compaction summary, eliminates redundant LLM calls |
| Sandbox Execution | Docker-based isolated code execution — Node.js, Python, git pre-installed. Per-session persistent containers with network tiers and workspace isolation |
| 38 Built-in Tools | Shell exec, file ops, web search/fetch, email, cron, sub-agents, PDF reader, browse |
| Plugin System | MCP servers, CLI wrappers, HTTP APIs, OpenAPI auto-discovery — extend without code |
| Cron Scheduling | Cron, interval, one-shot tasks with multi-channel delivery |
| Admin Dashboard | 19 admin pages — providers, models, users, sessions, logs, usage, cron, plugins, MCP, settings, and more |
| Encrypted Secrets | AES-256-GCM envelope encryption for all API keys and tokens |
| Database | SQLite (default) or PostgreSQL — auto-migration between them |
| System Alerting | Channel health, provider errors, cron failures — alerts via Telegram, WebSocket, webhook |
| Automated Backups | Daily SQLite/PostgreSQL backups with 7-day retention |
| Thinking Blocks | Persist and restore Claude's reasoning across session reloads |
| Model Indicator | See which model responded per message — configurable per channel and role |
Multi-User
Add your team, family, or clients. Each person gets isolated memory, files, and tool access.
| Role | Access |
|---|---|
| Admin | Full dashboard, all tools unrestricted, manage users |
| Power User | All tools — host exec, file writes, cron with scoped access |
| User | Safe tools + sandbox — code runs in isolated Docker containers. No host exec |
One person, all channels — link Telegram + WhatsApp to the same user. One memory, one scope.
Onboarding — someone messages your bot? One click: create account, link channel, approve.
Tools & Plugins
38 built-in tools — file read/write/edit, shell exec, sandbox exec, web search/fetch, email, messaging, cron, memory search, sub-agents, PDF reader, image inspection, browsing.
Tool permissions per role from Settings:
| Level | Effect |
|---|---|
| Allow | Available to all users |
| Power User only | Admin + Power User flag required |
| Confirm first | Agent asks before executing |
| Deny | Hidden from agent, blocked at execution |
Extend with plugins — no code required:
| Type | What it does | Example |
|---|---|---|
| MCP | Model Context Protocol servers | GitHub, Slack, Postgres |
| CLI | Wraps any binary with safety controls | gh, docker, kubectl, jq |
| HTTP | Wraps any REST API with typed params | Currency API, image generation |
| OpenAPI | Auto-discovers tools from spec | Self-hosted GPU services |
Security
| Layer | What it does |
|---|---|
| Encryption at rest | AES-256-GCM envelope encryption for all API keys and secrets |
| Scope isolation | File tools, exec, and memory enforce per-user boundaries |
| Tool RBAC | DB-driven, admin-configurable, double-enforced (prompt + execution) |
| Sandbox Execution | Docker containers with CapDrop ALL, non-root, PID/memory limits. Users get sandbox only, admin gets host exec |
| Output redaction | Span-based engine with 22 secret patterns, priority-based overlap resolution |
| HMAC API keys | Keyed hashing for stored API keys (not plain SHA-256) |
| Signed media URLs | HMAC-SHA256 time-limited per-file media access |
| Audit trail | Tamper-evident hash chain on all tool calls and admin actions |
Admin Dashboard
19 admin pages + 4 user portal pages.
| Admin | User Portal (/my/) |
|---|---|
| Dashboard, Personas, Providers, Models | Dashboard |
| Channels, Users, Scoped Channels, WhatsApp | My Sessions |
| MCP Servers, Plugins, Extension | My Usage |
| Cron Jobs, Sessions, Tasks, Progress | My Cron Jobs |
| Logs, Usage, Database, Settings |
Architecture
User → Telegram / WhatsApp / WebChat / API
│
Agent Queue (per-session)
│
Agent Loop (ReAct: LLM → tools → LLM → ...)
│
┌────┴────┐
▼ ▼
Providers Tools (38 built-in + MCP/CLI/HTTP plugins)
│ │
Anthropic File ops, exec, sandbox, web, email,
OpenAI memory, cron, sub-agents, browse...
Ollama
18 packages · @agw/types → @agw/core → @agw/ui · TypeScript strict · SQLite or PostgreSQL · 900+ tests
Docs
| Document | Description |
|---|---|
| Multi-User Guide | Roles, onboarding, tool permissions, user workspace |
| Architecture | Scope isolation, permission pipeline, design decisions |
| Channels | Telegram, WhatsApp, Web Chat — setup, features, constraints |
| Database | SQLite vs PostgreSQL, migration, Docker Compose |
| Memory | Auto-memory system, per-user scoping, consolidation |
| Sandbox | Docker sandbox setup, configuration, security, troubleshooting |
| Product Features | Complete feature inventory with metrics |