OpenClaw Won’t Bite, A Zero-to-Hero Guide for People Who Hate Terminal
Author(s): Kamrun Nahar Originally published on Towards AI. What Even Is OpenClaw, Though? Let me tell it straight. OpenClaw is an open-source, self-hosted AI agent built by Peter Steinberger. It started life as “Clawdbot” in November 2025, got renamed to “Moltbot” after Anthropic raised an eyebrow about trademark stuff, then finally settled on “OpenClaw” a few days later. The lobster logo stuck around through every name change, because apparently crustaceans are the spirit animal of autonomous computing. Here’s the part that matters: OpenClaw is NOT a new AI model. It doesn’t compete with Claude or GPT. It’s the software that gives those models hands. And eyes. And the ability to remember who you are between conversations. Think of it this way. ChatGPT is a brain in a jar. You talk to it, it talks back, and then it forgets you exist the second you close the tab. OpenClaw takes that same brain and plugs it into your actual computer. Files. Terminal. Browser. Messaging apps. Cron jobs. Everything. My neighbor’s kid summarized it better than any docs page: “So it’s like Siri, but it actually does stuff?” Yes. Exactly that. When your AI assistant files your taxes while the others are still telling you the weather. Why Should You Care? Three words. It actually works. Regular chatbots are like texting a really smart friend who has amnesia. Every conversation starts from zero. You have to re-explain your project, your preferences, your name. Exhausting. OpenClaw flips that. It stores everything locally on your machine. Your conversations, your preferences, your ongoing projects. When you message it on Tuesday about a bug you mentioned on Friday, it remembers. When your server crashes at 3 AM, it can message you on Telegram before you even check your monitoring dashboard. My laptop fan was screaming while I was writing this section, which is fitting because OpenClaw also takes up real estate on your actual hardware. It’s not in the cloud. It’s right here, on your disk, eating your RAM, reading your files, and occasionally doing things that make you say “wait, I didn’t ask you to do that.” By February 2026, the project hit 200,000+ GitHub stars. It became one of the fastest-growing repositories in open source history. Companies in Silicon Valley and China started adapting it. Steinberger got hired by OpenAI. The whole thing moved to an open-source foundation. And it all runs on Markdown files. “This Is a Pet Lobster” OK here’s the deal. Everyone talks about OpenClaw like it’s some terrifying autonomous system from a sci-fi movie. It’s not. It’s a pet lobster. Stay with me. A pet lobster needs a tank. That’s your computer (or a VPS). OpenClaw runs locally. It lives on your hardware. A pet lobster needs food. That’s your LLM API key. OpenClaw doesn’t have its own brain. You feed it Claude, GPT, DeepSeek, or even a local model through Ollama. The smarter the model, the smarter the lobster. A pet lobster needs rules. That’s SOUL.md. A plain text file where you write down how it should behave. "Be professional. Don't delete files without asking. Send me morning briefings at 7:30 AM." The lobster reads this file every single time it wakes up. A pet lobster has memory. That’s the memory/ folder. Every day, it writes a diary entry. Every important fact goes into MEMORY.md. It remembers you. It remembers your projects. It remembers that you hate pie charts. A pet lobster can learn tricks. Those are Skills. Markdown instruction files that teach your lobster how to do specific things: manage your Gmail, organize Obsidian notes, monitor server health, or post to social media. A pet lobster has a heartbeat. Literally. OpenClaw has a heartbeat system. Every 30 minutes (configurable), it wakes up, checks HEARTBEAT.md, and decides if it needs to do something for you. Without being asked. That’s it. That’s OpenClaw. A lobster, in a tank, with rules, memory, tricks, and a heartbeat. The $200-billion AI agent industry explained The Architecture (Don’t Run Away) Here’s what actually happens under the hood when you send a message to your OpenClaw agent. I’m going to walk through it step by step, and I promise not a single step is scary. DIAGRAM: OpenClaw Message Flow Every time you text your lobster, this happens in about 2 seconds. Let me break it down in human words. Step 1: You say something. Could be on Telegram. Could be on Discord. Could be the built-in web interface. Doesn’t matter. OpenClaw has adapters for WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Microsoft Teams, Google Chat, and more. Each adapter translates your message into a standard format. Step 2: The Gateway routes it. The Gateway is OpenClaw’s control plane. It runs on port 18789 by default. It figures out which agent should handle your message, loads the right session, and passes it along. Step 3: The Agent Runtime wakes up. This is where the magic happens. The runtime reads your workspace files (AGENTS.md, SOUL.md, TOOLS.md), loads any relevant Skills, searches your memory for context from past conversations, and builds a massive system prompt. Then it ships all of that to your configured LLM. Step 4: The LLM thinks. Claude, GPT, DeepSeek, whatever you chose. It reads all that context and generates a response. If it needs to DO something (run a command, open a browser, read a file), it requests a tool call. Step 5: Tool execution. The runtime intercepts the tool call and actually executes it. Run a bash command? Done. Open a website with Chromium? Done. Write a file? Done. Optionally, this all runs inside a Docker sandbox so a rogue command can’t nuke your system. Step 6: You get an answer. The response flows back through the Gateway, through the channel adapter, and lands in your messaging app. The entire loop takes a couple of seconds. And you didn’t write a single line of code to make it happen. I was eating cold leftover biryani when this architecture finally clicked for me. It’s […]
This article was originally published by Towards AI. View original article
Get AI news in your inbox
Daily digest of what matters in AI.
Key Terms Explained
An autonomous AI system that can perceive its environment, make decisions, and take actions to achieve goals.
An AI safety company founded in 2021 by former OpenAI researchers, including Dario and Daniela Amodei.
Anthropic's family of AI assistants, including Claude Haiku, Sonnet, and Opus.
Generative Pre-trained Transformer.