Overview

Clawdbot is an open-source AI assistant that runs locally on your machine with persistent memory that survives indefinitely. Unlike cloud-based AI assistants, it maintains 24/7 context retention by storing conversations and learned information in local files that can be searched and referenced across sessions.

The Breakdown

  • Context vs Memory distinction - Context is ephemeral data (system prompts, conversation history) that exists only during a request, while Memory is persistent data stored in local Markdown files that survives restarts and grows indefinitely
  • Two specialized memory tools enable retrieval: memory_search finds relevant information across all memory files using semantic search, while memory_get reads specific content after finding it
  • Local file-based architecture stores everything in user-editable Markdown files (AGENTS.md, SOUL.md, USER.md, MEMORY.md) in the agent’s workspace, giving users full ownership and transparency
  • Semantic search capabilities using embedding models to find relevant memories across all stored files with scoring and snippet extraction
  • Unbounded memory growth - unlike context which is limited by token windows and API costs, memory files can grow indefinitely at no additional API cost