The Complete OpenClaw Guide:
From Zero to Running
in 30 Minutes
Most people who install OpenClaw spend 10x what they should, get generic responses, and quit by week two. This guide fixes all three problems before they hit you. Free. Copy-paste ready.
What Is OpenClaw?
OpenClaw is an open-source personal AI assistant platform that runs on your own machine and connects to the messaging apps you already use — Discord, Telegram, WhatsApp, and more. It acts as the bridge between you and the AI models from providers like Anthropic (Claude), OpenAI (GPT), and Google (Gemini): you talk to it through a chat interface, and it thinks, researches, writes, and acts on your behalf.
The difference from a regular AI chatbot is ownership and persistence. OpenClaw lives on your hardware, reads files from your computer, maintains memory across sessions, runs on a schedule, and can be deeply configured to reflect your personality, your priorities, and your workflow. Most AI tools are generic by design. OpenClaw is built to become specific — to you.
OpenClaw itself is free and open source. The only costs you pay are the API calls to whichever AI model you choose — which, with the right setup, run as low as $5–20 per month. Out of the box, without optimization, they can run much higher. This guide fixes that.
Installation — Zero to Running
Six steps. No coding. No prior experience required. Each step is complete — no assumptions made.
Install Node.js — the engine everything runs on
Go to nodejs.org in your browser. Click the big button labelled LTS (Long Term Support). Download it and run the installer — click through all defaults. Takes about 2 minutes.
When it finishes, open your terminal (Mac: Cmd + Space, type Terminal — Windows: Windows key, type PowerShell) and run this to verify it worked:
You should see a version number like v20.x.x or higher. If you do, you're ready for step 2.
Install OpenClaw
In your terminal, run:
The -g flag installs it globally so you can use it from anywhere. Wait for it to finish. You’ll see a success message when it’s done.
Get an AI API key — this is what powers the brain
You need an account with at least one AI provider. Pick one and sign up. If you’re not sure, start with Anthropic:
| Provider | Sign Up | Notes |
|---|---|---|
| Anthropic (Claude) Recommended | anthropic.com/api | Best all-round quality. Strongest reasoning. Start here. |
| OpenAI (GPT-4) | platform.openai.com | Most well-known. Widely supported. Good for code-heavy tasks. |
| Google (Gemini) Free tier | aistudio.google.com | Free tier available. Best for high-volume, lower-cost use cases. |
After signing up, go to the API keys section of your account and copy your key. Treat it like a password — keep it private, don’t share it, don’t put it in public files.
Run the setup wizard
Back in your terminal, run:
It walks you through entering your API key, choosing your AI model, and connecting your first messaging app. Discord is the easiest to start with — it’s free and takes 3 minutes to set up. The wizard handles the rest.
Start the gateway — turn it on
Run this command whenever you want your assistant active:
Your assistant is now live. It’s listening. Go to your connected app (Discord, etc.), send a message, and it will respond.
Test it
Send a message to your assistant channel. Say hello, ask it something simple — "What can you do?" is a good opener. If it replies, you’re set up and running.
If something doesn’t work, the troubleshooting section at docs.openclaw.ai covers the common issues (usually a missing API key or wrong Discord bot token).
The Three Problems — and How to Fix All of Them
You’ve got it running. Now here’s why most people abandon it in week one. The real problem isn’t OpenClaw. It’s that your AI doesn’t know who you are yet. Fix these three things and it will.
The Token Hemorrhage
Default OpenClaw runs a heartbeat check every 60 seconds — a short ping to see if there’s anything to do. On Claude Opus (the premium model), that’s roughly $274/month in idle costs alone, before you even ask it anything. Most people see the bill in week two and switch it off permanently.
Cut costs by 97% with three changes
The fix has three parts: stretch the heartbeat interval (from 60s to 900s or longer), minimize the heartbeat prompt (instead of sending context, send a single status token), and use a hybrid model setup (cheap model for monitoring, premium model only when you actually need it). Together, these drop costs from $274/month to under $10/month for idle time.
Generic AI That Doesn’t Know You
Out of the box, OpenClaw starts every session cold. It doesn’t know your name, your industry, your preferences, your tone, or your history. Every conversation begins from scratch. You get the same generic assistant voice you’d get from any chatbot. After a week, it feels disposable.
Three files that make it feel like yours
OpenClaw reads files from your workspace directory at session start. Three files transform it: SOUL.md defines its voice and values (opinionated, direct, no corporate filler), IDENTITY.md gives it a persistent persona (name, role, vibe), and MEMORY.md acts as its working memory — a pointer manifest to everything it needs to know about your current context. Fill these in once; they load automatically every session.
Starting Over Every Session
Even with MEMORY.md in place, AI memory decays. Conversations compress. Context windows fill up. You mention something important in session 3 and by session 10 it’s gone. The assistant that felt like it was learning turns back into a stranger.
Nightly consolidation that actually sticks
The Dream Cycle is a scheduled task that runs while you sleep. It reads the day’s conversation logs, extracts patterns and preferences, updates your MEMORY.md, and writes what it learned to a dated log file. The result: your assistant genuinely gets better over time. By day 30, the behavioral learning is obvious — it stops suggesting things you always reject, starts leading with things you always accept.
The Files — Complete Copy-Paste Templates
Create these six files in your OpenClaw workspace directory. Minimal versions that work out of the box — expand them as you learn what you need.
Best Practices
The difference between a mediocre AI experience and a genuinely useful one is almost entirely in how you use it. These eight habits change everything.
Tell it who you are
The assistant starts fresh each session by default. Write a short IDENTITY.md describing yourself — your name, what you do, your industry. Drop it in the workspace. It reads it every session. This single step makes it feel personal instead of generic.
Give context before asking
Don’t ask cold. Instead of “write me a marketing email” — say “I run a logistics company targeting luxury brands in New York, write me a marketing email about X.” More context, better results. Every time.
Use it for research
It can browse the web, read PDFs you send it, and summarize documents. Use it to research competitors, pull together a brief on a new market, or get a fast overview of any topic. This is where it beats a basic chatbot by miles.
Build a workspace folder
OpenClaw has a workspace folder on your machine. Drop in files you reference often — rate sheets, brand guidelines, templates, contact lists. Ask it to “read my rate sheet and use it when quoting.” It will.
Ask for the format you want
If you want bullet points, ask for bullet points. If you want plain text without formatting, say so. If you want it short and punchy, say “keep it under 100 words.” It adapts instantly. Never settle for the default layout if it doesn’t suit you.
Ask it to save things
After a useful conversation, say “save this as a file.” Your workspace becomes a personal knowledge base. You’re not hunting through chat history later trying to find that brief it wrote three weeks ago.
Don’t settle for the first answer
The first draft is rarely the best one. Ask it to revise, simplify, expand, change the tone, try a different angle. Treat everything as a draft until you’re happy. The iteration is fast — don’t skip it.
Organise your channels
Create dedicated channels by purpose — one for research, one for writing, one for strategy. Keeps history clean and makes it easier to pick up where you left off. A little structure up front saves a lot of time later.
The 20% Most People Miss
These capabilities exist out of the box. Most people never discover them.
What Results to Expect — and When
This is a realistic timeline from practitioners who’ve run the full setup. No hype. Just what actually happens.
The tools are equal. The setup isn’t. The people who get the most out of OpenClaw aren’t the most technical — they’re the most deliberate about what they put in.
You’ve got the guide.
We do the setup.
This guide gives you everything to build it yourself. If you’d rather have it done right — with a system tuned to your specific business, your workflow, your team — that’s what we do. Architecture, configuration, personality system, memory design, cost optimization. Delivered. Not just documented.
Where to Go Next
Official documentation, community, skills marketplace, and this site.
Mr. Glouton · The Complete OpenClaw Guide · 2026