LocalTaskClaw

LocalTaskClaw

Personal AI agent controllable via Telegram and a Web Admin UI. Built around a ReAct agent loop with FastAPI, SQLite persistence, real token streaming, a multi-agent kanban board, and MCP server support. Works with any OpenAI-compatible model (local via Ollama or cloud).

Quick Install

curl -fsSL https://raw.githubusercontent.com/vakovalskii/LocalTaskClaw/main/install.sh | bash

The interactive wizard walks through mode selection, Telegram bot setup, model choice, and service registration. Takes about 5 minutes.

Features

• Telegram bot with live typing preview (Bot API 9.3+ sendMessageDraft, editMessageText fallback)
• Admin UI (SPA) -- chat, sessions, kanban board, tasks, files, logs, settings
• Kanban board -- 5-column board (Backlog / In Progress / Review / Done / Needs Human), up to 10 agents with custom identities and roles
• Orchestrator / Worker model -- orchestrator agents dispatch workers via kanban_run, read artifacts via kanban_read_result, verify via kanban_verify, send reports via kanban_report
• Auto-retry -- rejected tasks retry up to 2 times, then escalate to Needs Human
• Repeat / heartbeat -- tasks with repeat_minutes > 0 auto-rerun on schedule
• Parallel tool calls -- agents run multiple tools concurrently via asyncio.gather
• Real token streaming -- SSE streaming in both Admin UI and Telegram
• Web search via DuckDuckGo (Brave API optional)
• MCP servers -- extend the agent with any Model Context Protocol tool
• Skills system -- SKILL.md scanner + npx skills add ecosystem
• Security -- hard-block (fork bombs, exfil), soft-confirm (rm -rf, DROP TABLE), injection detection
• Any OpenAI-compatible model -- Ollama (local) or cloud API

Architecture

core/           Python ReAct agent + FastAPI + SQLite
bot/            Telegram bot (single-user, OWNER_ID guard)
frontend/       Admin UI — React + TypeScript + Tailwind CSS (builds to admin/