convez.ai
MCP Server
DhilipBinny

KairoClaw

DhilipBinny/KairoClaw

Ver no GitHub
BomPluginScore · de 0 a 100

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/KairoClaw

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
85%
Último commit
há 1 mês
Versão
—
Issues abertas
13
Contribuidores
4

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

FeatureWhat it does
Multi-ChannelTelegram, WhatsApp, Web Chat — unified conversation across all channels
Multi-ProviderAnthropic (Claude), OpenAI (GPT-4o), Ollama, NVIDIA, Azure, Together, vLLM — auto-failover chain
Multi-UserAdmin, Power User, User roles — per-user workspace, memory, permissions
Smart MemoryAuto-extracted user profile + session context. Cross-channel, per-user isolated
Model RouterAuto-selects fast/balanced/powerful model per message complexity. Save costs on simple messages
Smart CompactionTwo-stage context management — session notes as free compaction summary, eliminates redundant LLM calls
Sandbox ExecutionDocker-based isolated code execution — Node.js, Python, git pre-installed. Per-session persistent containers with network tiers and workspace isolation
38 Built-in ToolsShell exec, file ops, web search/fetch, email, cron, sub-agents, PDF reader, browse
Plugin SystemMCP servers, CLI wrappers, HTTP APIs, OpenAPI auto-discovery — extend without code
Cron SchedulingCron, interval, one-shot tasks with multi-channel delivery
Admin Dashboard19 admin pages — providers, models, users, sessions, logs, usage, cron, plugins, MCP, settings, and more
Encrypted SecretsAES-256-GCM envelope encryption for all API keys and tokens
DatabaseSQLite (default) or PostgreSQL — auto-migration between them
System AlertingChannel health, provider errors, cron failures — alerts via Telegram, WebSocket, webhook
Automated BackupsDaily SQLite/PostgreSQL backups with 7-day retention
Thinking BlocksPersist and restore Claude's reasoning across session reloads
Model IndicatorSee 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.

RoleAccess
AdminFull dashboard, all tools unrestricted, manage users
Power UserAll tools — host exec, file writes, cron with scoped access
UserSafe 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:

LevelEffect
AllowAvailable to all users
Power User onlyAdmin + Power User flag required
Confirm firstAgent asks before executing
DenyHidden from agent, blocked at execution

Extend with plugins — no code required:

TypeWhat it doesExample
MCPModel Context Protocol serversGitHub, Slack, Postgres
CLIWraps any binary with safety controlsgh, docker, kubectl, jq
HTTPWraps any REST API with typed paramsCurrency API, image generation
OpenAPIAuto-discovers tools from specSelf-hosted GPU services

Security

LayerWhat it does
Encryption at restAES-256-GCM envelope encryption for all API keys and secrets
Scope isolationFile tools, exec, and memory enforce per-user boundaries
Tool RBACDB-driven, admin-configurable, double-enforced (prompt + execution)
Sandbox ExecutionDocker containers with CapDrop ALL, non-root, PID/memory limits. Users get sandbox only, admin gets host exec
Output redactionSpan-based engine with 22 secret patterns, priority-based overlap resolution
HMAC API keysKeyed hashing for stored API keys (not plain SHA-256)
Signed media URLsHMAC-SHA256 time-limited per-file media access
Audit trailTamper-evident hash chain on all tool calls and admin actions

Admin Dashboard

19 admin pages + 4 user portal pages.

AdminUser Portal (/my/)
Dashboard, Personas, Providers, ModelsDashboard
Channels, Users, Scoped Channels, WhatsAppMy Sessions
MCP Servers, Plugins, ExtensionMy Usage
Cron Jobs, Sessions, Tasks, ProgressMy 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

DocumentDescription
Multi-User GuideRoles, onboarding, tool permissions, user workspace
ArchitectureScope isolation, permission pipeline, design decisions
ChannelsTelegram, WhatsApp, Web Chat — setup, features, constraints
DatabaseSQLite vs PostgreSQL, migration, Docker Compose
MemoryAuto-memory system, per-user scoping, consolidation
SandboxDocker sandbox setup, configuration, security, troubleshooting
Product FeaturesComplete feature inventory with metrics

Ver o original no GitHub

Bom para

Relacionados