Skip to main content
HowOpenClawv2026.4.2

Module 1: How Everything Fits Together

See the simple blueprint behind OpenClaw. Once you understand these five parts, nothing will feel confusing again.

0 of 10 modules complete0%
5 min read
What you will learn
  • 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

ComponentWhat it doesWhere it lives
GatewayReceives messages from all your channelsBackground process on your machine
AgentDecides what to do with each messageCore logic layer
MemoryStores personality, preferences, and contextMarkdown files in your workspace
SkillsGives the agent abilities (email, calendar, search)Installed via ClawHub
AI ModelDoes the actual thinkingCloud (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:

OptionSpeedPrivacyCost
OpenAI (GPT-4o)FastData sent to OpenAI serversPay per use
Anthropic (Claude)FastData sent to Anthropic serversPay per use
Ollama (local)Depends on hardwareEverything stays on your machineFree

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 configuration

No 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 doctor

You should see green checks for Gateway, Agent, and your configured model.

Explore your workspace:

openclaw config get workspace

Then 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