explaingit

forgesynapseltd/clawlite

Analysis updated 2026-07-24

2PythonAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

TLDR

A personal AI assistant that runs entirely on your computer and chats with you through Telegram. It searches the web, remembers past conversations, and keeps all your data private on your own machine.

Mindmap

mindmap
  root((repo))
    What it does
      Telegram bot
      Web search
      Conversation memory
      Daily brief
    Privacy and security
      Runs locally
      Approved actions only
      Optional cloud fallback
    Tech stack
      Python
      Ollama
      Tavily
    Setup
      Windows installer
      Docker option
      Manual install
    Roadmap
      Voice input
      WhatsApp support
      Plugin marketplace

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Chat with a private AI assistant in Telegram without your data leaving your computer.

USE CASE 2

Get a daily morning news brief summarized by AI at a time you choose.

USE CASE 3

Ask an AI questions that require live web searches while keeping history local.

USE CASE 4

Run a self-hosted AI assistant with a one-click Windows installer.

What is it built with?

PythonOllamaTavilyTelegramDocker

How does it compare?

forgesynapseltd/clawlite0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/52/52/5
Audiencevibe codergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a Telegram bot token and a Tavily API key, local AI responses also require installing Ollama separately.

You can use, modify, and distribute this software freely, including for commercial purposes, as long as you include the license notice and state any changes.

In plain English

ClawLite is a personal AI assistant that lives inside Telegram and runs entirely on your own computer. You chat with it the way you would chat with any Telegram bot: you ask a question, it searches the web if needed, remembers what you told it before, and replies. The key difference from typical AI assistants is that your conversations never leave your machine. There is no subscription, no cloud service holding your data, and no silent background transfer of what you say. Under the hood, ClawLite relies on a tool called Ollama, which runs a language model locally on your computer so responses are generated without sending anything to an outside server. For web searches, it uses a service called Tavily to pull live information from the internet when a question requires current facts. It stores your conversation history in a local database with semantic search, meaning it can recall relevant past exchanges without that data ever sitting on someone else's server. If Ollama is unavailable and you have configured a Groq API key, ClawLite can fall back to a cloud service, but it will tell you explicitly when that happens. Security is built into the design. Every tool call and web request is checked against an approved list before it runs, so the assistant cannot access your files, run arbitrary code, or contact websites you have not authorized. An optional daily brief feature can search for news and deliver a morning summary at a time you choose. Installing it on Windows requires no terminal or technical knowledge. You download an installer, run it, and a setup page asks for a Telegram bot token and a Tavily API key. You get the token from Telegram's BotFather and the Tavily key from the Tavily website. For developers, there is also a manual installation path that works on any operating system, including a Docker option. The project is open source under the Apache 2.0 license and is built by ForgeSynapse LTD. The roadmap lists features already completed, including the Telegram bot, web search, local memory, and sandbox protection, with planned additions like voice input, WhatsApp support, and a plugin marketplace.

Copy-paste prompts

Prompt 1
I want to set up ClawLite on my computer using the Windows installer. Walk me through getting a Telegram bot token from BotFather and a Tavily API key, and where to paste them in the setup page.
Prompt 2
Help me install and run ClawLite using Docker. What are the exact steps and environment variables I need to configure for the Telegram bot token, Tavily API key, and Ollama?
Prompt 3
I have ClawLite running with Ollama but want to configure the Groq API key as a fallback. How do I set that up so it switches automatically and tells me when it's using the cloud?
Prompt 4
How do I enable the daily brief feature in ClawLite so it searches for news every morning and sends me a summary in Telegram at 7 AM?
Prompt 5
What allowed tools and websites does ClawLite check against before running actions, and how can I customize that approved list to let the assistant access specific sites?

Frequently asked questions

What is clawlite?

A personal AI assistant that runs entirely on your computer and chats with you through Telegram. It searches the web, remembers past conversations, and keeps all your data private on your own machine.

What language is clawlite written in?

Mainly Python. The stack also includes Python, Ollama, Tavily.

What license does clawlite use?

You can use, modify, and distribute this software freely, including for commercial purposes, as long as you include the license notice and state any changes.

How hard is clawlite to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is clawlite for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.