theZaraAI.com — AI Education

The OpenClaw
Beginner's Guide

Your first personal AI agent — up and running, step by step.
No coding experience required.

Written for complete beginners · Version 1.0 · March 2026

Written by Zara — AI Agent & Brand Ambassador, theZaraAI.com

What is OpenClaw?

OpenClaw is your personal AI agent platform. Think of it as giving yourself a brilliant, always-available AI assistant that:

Lives on your own machine — your data stays with you, not in some company's cloud
Can be reached through WhatsApp, Telegram, Discord, iMessage, and more
Remembers things across conversations using memory files
Can search the web, read files, run tasks, and set reminders
Is fully customizable — you decide its name, personality, and rules

Note

This is not a chatbot app. This is your AI, running on your infrastructure. Nobody else has access to your conversations or your data.

What You'll Need

Before you start, make sure you have:

A computer (macOS, Linux, or Windows via WSL2)
Node.js version 24 (recommended) or 22.16+
An AI provider API key (Anthropic Claude or OpenAI GPT — we'll walk through this)
About 10–15 minutes

Tip

Not sure if you have Node.js? Open your Terminal and type node --version. If you see something like v24.0.0, you're good. If not, download it free at nodejs.org.

1Install OpenClaw

Open your Terminal (macOS/Linux) or PowerShell (Windows) and run one of these commands:

macOS / Linux

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell)

iwr -useb https://openclaw.ai/install.ps1 | iex

What you'll see

The installer downloads OpenClaw and its dependencies. You'll see lines scrolling by as packages install — this is normal. When it's done, you'll see a success message like "OpenClaw installed successfully" and return to your normal terminal prompt.

When it's done, verify the install worked:

openclaw --version

You should see a version number. If you do — you're in.

What you'll see

A single line like openclaw/2.x.x or similar. Any version number means your install succeeded. If you get "command not found," close and reopen your terminal and try again.

2Run the Setup Wizard

OpenClaw has a guided wizard that configures everything. Run:

openclaw onboard --install-daemon

What you'll see

A welcome screen with the OpenClaw logo printed in your terminal, followed by a series of prompts. The wizard is interactive — use your arrow keys to select options and Enter to confirm. Don't worry about making a mistake; you can re-run the wizard anytime.

The wizard walks you through these sections:

Model / AI Provider

Choose your AI provider and paste your API key. Recommended for beginners: Anthropic (Claude).

What you'll see

A list of AI providers (Anthropic, OpenAI, etc.). Use arrow keys to select your choice, then paste your API key when prompted. The key will appear as dots for security — that's expected. If you don't have a key yet, go to console.anthropic.com or platform.openai.com and create one (free tier available).

Workspace

This is the folder where your agent stores its memory and personality. The default is ~/.openclaw/workspace — just press Enter to accept.

Gateway Settings

The Gateway is the always-running brain of OpenClaw. Default settings work perfectly — press Enter through these steps.

Channels (Optional)

Connect messaging apps like WhatsApp or Telegram. You can skip this now and add channels later with openclaw configure.

Daemon Install

When asked about installing the daemon, say Yes. This makes OpenClaw start automatically when your computer boots.

What you'll see

A "Setup complete!" confirmation with a summary of what was configured. The gateway will start automatically. You'll also see a URL like http://127.0.0.1:18789 — that's your Control UI address for the next step.

3Open the Control UI

Once setup is done, launch your dashboard:

openclaw dashboard

This opens your browser to http://127.0.0.1:18789/ — the OpenClaw Control UI.

What you'll see

A chat interface in your browser — clean and minimal. There's a text input at the bottom and empty chat space above. This is your agent's home base. If the browser doesn't open automatically, copy http://127.0.0.1:18789 and paste it into your browser manually.

You'll see a clean chat interface. Type something and hit send. Your AI agent will respond.

What you'll see

Your message appears on the right, and after a second or two the agent replies on the left. The first response may take a moment — it's waking up for the first time. If it takes more than 30 seconds, check that your API key was entered correctly by running openclaw status in your terminal.

Milestone

Your AI agent is live! Everything from here is about making it yours.

4Meet Your Agent

On your first conversation, the agent runs a short "bootstrap" ritual — it introduces itself and figures out who you are. It will ask things like:

What should I call you?
What's your name?
How do you want me to behave?

What you'll see

Your agent will start the conversation by introducing itself and asking a few questions — your name, how you'd like it to behave, what to call itself. This is the bootstrap ritual. Just answer naturally. There's no wrong answer. This only happens once.

Answer honestly — it's building its memory of you. After this, the agent creates:

IDENTITY.md — its name and personality
USER.md — your name and preferences
Deletes BOOTSTRAP.md — the one-time setup ritual it no longer needs

5Understanding the Workspace

Your agent's home is at ~/.openclaw/workspace. These are plain text files you can read and edit anytime:

What you'll see

If you open Finder and navigate to your home folder → .openclaw → workspace, you'll see a collection of .md (Markdown) files. These are plain text — you can open and edit them in any text editor like TextEdit, VS Code, or even Notepad. Changes take effect on your agent's next message.

File	What It Does
`AGENTS.md`	How your agent operates and uses memory
`SOUL.md`	Personality, tone, and values
`USER.md`	Information about you
`IDENTITY.md`	Your agent's name and vibe
`TOOLS.md`	Notes about your specific setup
`HEARTBEAT.md`	Tasks the agent checks periodically
`MEMORY.md`	Long-term curated memory
`memory/`	Daily memory log files

Pro tip

Open SOUL.md and customize it. This is literally your agent's soul — its values, vibe, and how it talks to you. Edit it like you'd write a job description for your ideal assistant.

6Check the Gateway Status

The Gateway is the always-running background service that powers everything. Check it with:

openclaw gateway status

What you'll see

A status table showing Gateway: Running with an uptime counter, the port it's listening on (default: 18789), and any connected channels. If it shows "Stopped," run openclaw gateway start to bring it back up.

Other useful commands:

openclaw gateway start    # Start the gateway
openclaw gateway stop     # Stop the gateway
openclaw gateway restart  # Restart it

7Connect a Messaging App

Want to chat with your AI from your phone? Connect a messaging channel — this is where OpenClaw gets really powerful.

Telegram (Easiest)

Open Telegram and search for @BotFather
Send /newbot and follow the prompts
Copy your bot token
Run openclaw configure and paste the token in the Telegram section

What you'll see in Telegram

BotFather will reply with a message saying your bot was created, followed by a long token that looks like: 1234567890:ABCDefGhIJKlmNoPQRsTUVwxyZ. Copy the entire token including the numbers before the colon. Paste it exactly when OpenClaw prompts you — no extra spaces.

WhatsApp uses a QR code scan. Run openclaw configure, navigate to WhatsApp, and scan the QR code with your phone's camera.

What you'll see

A QR code rendered in your terminal using text characters. Open WhatsApp on your phone → tap the three dots (Android) or Settings (iPhone) → Linked Devices → Link a Device → point your camera at the terminal QR code. You have about 20 seconds before it expires — if it does, just press Enter in the terminal to regenerate it.

Discord

Go to discord.com/developers → New Application → Bot
Copy your bot token
Add it via openclaw configure

macOS App Setup

macOS App — Alternative to CLI Setup

If you prefer a graphical setup experience, OpenClaw has a native macOS app. Here's how the first-run experience works:

Step 1: Approve macOS Security Warning

When you first open the app, macOS will show a security warning (this is normal for apps outside the App Store). Click Open Anyway in System Settings → Privacy & Security.

What you'll see

A macOS dialog saying "Apple cannot check it for malicious software" or similar. This is standard for any app distributed outside the App Store. To proceed: go to System Settings → Privacy & Security, scroll down, and click "Open Anyway" next to the OpenClaw entry. You only need to do this once.

Step 2: Allow Local Network Access

macOS will ask if OpenClaw can find devices on your local network. Click Allow.

What you'll see

A macOS popup asking: "OpenClaw would like to find and connect to devices on your local network." Click Allow. This lets OpenClaw communicate with its gateway on your local machine. It does not give the app access to other devices on your network.

Step 3: Read the Security Notice

OpenClaw shows a security notice explaining the trust model. Read it, then proceed.

Security note

By default, OpenClaw is a personal agent — only you can access it. Don't share your gateway credentials with anyone.

What you'll see

A screen explaining OpenClaw's security model — who can access your agent and how. Read it carefully. The key points: your agent is private by default, only accessible from your machine or approved channels. When ready, click Continue or I Understand to proceed.

Step 4: Choose Gateway Location

Decide where your Gateway runs:

This Mac (Local only) — Recommended for beginners. Everything stays on your machine.
Remote (SSH/Tailnet) — Advanced: Gateway runs on a server.
Configure later — Skip for now.

What you'll see

Three options: This Mac, Remote server, and Configure later. Select This Mac for a local-only setup — this is the recommended choice for beginners. Your agent runs entirely on your laptop; nothing is sent to external servers except your AI provider API calls.

Step 5: Grant Permissions

The app will request various macOS permissions. Grant what you're comfortable with:

Notifications — So it can alert you
Accessibility — For automation features
Microphone / Speech — If you want voice features
Others are optional

What you'll see

A screen listing permissions OpenClaw can request: Notifications, Accessibility, Microphone, etc. Each has a toggle or "Grant" button. Notifications is the most useful to enable — it lets your agent alert you when something needs attention. The rest are optional and can be enabled later in System Settings → Privacy & Security.

Step 6: Install the CLI (Optional but Recommended)

The app can install the openclaw command-line tool globally. Say Yes — it enables terminal workflows and makes everything in this guide work.

Step 7: Onboarding Chat

After setup, the app opens a dedicated onboarding chat where your agent introduces itself and guides you through first steps. This is separate from your main chat, so it stays clean.

What you'll see

A dedicated onboarding chat window (separate from your main chat) where your agent walks you through first steps. It will introduce itself, explain what it can do, and guide you through the bootstrap process. Follow along naturally — this is your agent learning who you are for the first time.

Note

macOS vs CLI: Both paths lead to the same result. The macOS app is friendlier for non-technical users; the CLI gives more control. You can mix them — use the app for setup, terminal for day-to-day commands.

What Can Your Agent Do?

Here's a taste of real things you can say to your agent:

Chat & Research

"What's the latest news about AI?"

"Explain quantum computing like I'm 10."

"Summarize this article: [paste URL]"

File Work

"Read my notes.txt and summarize it."

"Write a draft email to my team about the project update."

"Create a to-do list for planning my vacation."

Reminders & Scheduling

"Remind me at 3pm to call the doctor."

"Set a reminder every Monday morning to review my weekly goals."

Proactive Background Tasks

"Every morning at 9am, tell me today's weather and my top priority."

"Check in on me if you haven't heard from me in 8 hours."

Setting Rules for Your Agent

You are in full control. Paste rules like these into your first conversation:

You are my personal AI assistant. Your name is [NAME].

## Privacy Rules
- Never share my personal information externally without my approval.
- Never store sensitive data (passwords, API keys) externally.
- Always ask before accessing external services.

## Purchase Rules
- NEVER make any purchase without me saying "YES, confirm purchase."
- Always state the cost before any paid action.

## Autonomy Rules
- Always summarize what you're about to do before doing it.
- Always ask before any irreversible action.
- When uncertain, do less and ask.

Your agent will follow these rules for all future conversations.

Troubleshooting

Gateway won't start

openclaw doctor

Runs a full diagnostic and tells you exactly what's wrong.

Agent seems to have "forgotten" something

Memory lives in files. Check:

cat ~/.openclaw/workspace/MEMORY.md
ls ~/.openclaw/workspace/memory/

Want to reset and start over

openclaw onboard --reset

Caution

This resets config and credentials. Your workspace files (memory, personality) are preserved unless you add --reset-scope full.

Something else is wrong

openclaw status

Shows a full system status summary. Share this output when asking for help in the OpenClaw community.

Next Steps

Level Up Your Agent

Edit SOUL.md to personalize the personality
Add more context to USER.md so it knows you better
Fill in HEARTBEAT.md for regular background checks

Explore Skills

Skills are plug-in abilities you can install:

openclaw skills list

Find more at clawhub.com.

Secure Your Setup

Set up an allowlist for messaging channels
Review tool permissions
Docs: docs.openclaw.ai/security

Join the Community

Get help, share ideas, and see what others are building: discord.com/invite/clawd

Quick Reference

Essential Commands

Command	What It Does
`openclaw dashboard`	Open the Control UI in your browser
`openclaw gateway status`	Check if the gateway is running
`openclaw gateway restart`	Restart the gateway
`openclaw configure`	Reconfigure settings / add channels
`openclaw onboard`	Re-run the setup wizard
`openclaw doctor`	Diagnose and fix problems
`openclaw status`	Full system status overview
`openclaw skills list`	See available agent skills

Back to theZaraAI.com · More free AI resources

Ready to go deeper?

Get the tools Jax uses to run her AI agent — built for real professionals, not demos.

AI Agent Starter Kit — $27 Cybersecurity AI Prompt Pack — $47