Module 1: How Everything Fits Together
See the simple blueprint behind OpenClaw. Once you understand these five parts, nothing will feel confusing again.
- Name the five core components of OpenClaw
- Trace how a message flows from your phone to an action
- Understand the difference between local and cloud models
- Know where your data lives and who controls it
Why this matters
Before building anything complex, it helps to see the full picture. OpenClaw has five simple parts. Once you know what they are and how they connect, every future module will make immediate sense.
The five components
| Component | What it does | Where it lives |
|---|---|---|
| Gateway | Receives messages from all your channels | Background process on your machine |
| Agent | Decides what to do with each message | Core logic layer |
| Memory | Stores personality, preferences, and context | Markdown files in your workspace |
| Skills | Gives the agent abilities (email, calendar, search) | Installed via ClawHub |
| AI Model | Does the actual thinking | Cloud (OpenAI/Claude) or local (Ollama) |
How a message flows
When you send "What's on my calendar today?" via WhatsApp:
The whole round trip takes 2-5 seconds depending on your model and network.
Local vs cloud models
You choose where the "thinking" happens:
| Option | Speed | Privacy | Cost |
|---|---|---|---|
| OpenAI (GPT-4o) | Fast | Data sent to OpenAI servers | Pay per use |
| Anthropic (Claude) | Fast | Data sent to Anthropic servers | Pay per use |
| Ollama (local) | Depends on hardware | Everything stays on your machine | Free |
You can switch models at any time. Your data, memory files, and skills are completely independent of which model you use.
Can I use multiple models?
Yes. You can configure different models for different tasks. For example, use a fast local model for simple questions and a cloud model for complex reasoning.
Where your data lives
Everything OpenClaw stores is in your workspace directory:
~/.openclaw/
├── IDENTITY.md # Who your agent is
├── SOUL.md # Personality and behavior rules
├── memory/ # Conversation history and context
├── skills/ # Installed skills
└── config.yaml # All configurationNo data is stored on external servers (unless you choose a cloud AI model, which only sees the messages you send it). You own everything.
Hands-on: Check your components
Confirm everything is working:
openclaw doctorYou should see green checks for Gateway, Agent, and your configured model.
Explore your workspace:
openclaw config get workspaceThen look at the files inside — that is where your agent lives.
For precise definitions of Gateway, Agent, SOUL.md, and every other OpenClaw concept, see the Key Concepts reference.
Finished this module?
Tracks your progress across all 10 modules