FREE GUIDE 8 CHAPTERS ~10 MIN READ NO CODING NEEDED

How to Install OpenClaw on Mac

Your free automation platform — installed in 10 minutes, no coding required

By the time you finish this guide, OpenClaw will be running on your Mac with the dashboard open in your browser. You will have connected an AI brain, run your first test, and be ready to build real automations. Ten minutes. Free. No tech degree.

Before We Get Started

Here is everything you need to follow this guide:

  • A Mac computer (MacBook, iMac, Mac Mini, Mac Studio, or Mac Pro) — Intel or Apple Silicon
  • An internet connection — Wi-Fi or ethernet
  • About 15 minutes of your time
  • A credit card — NOT needed. Everything is free
  • Any coding or tech skills — also NOT needed

That is it. If you can type a web address, you can install OpenClaw.

What This Costs (Spoiler: Nothing)

OpenClaw is free and open-source. FREE FOREVER "Open-source" means the code is public. Anyone can look at it. No hidden fees. No trial that expires. No surprise charges.

Node.js, the engine that powers OpenClaw, is also free and open-source. FREE FOREVER

Here is the total cost breakdown:

ItemCostNotes
Node.jsFreeThe engine. FREE FOREVER Open-source, trusted by millions.
OpenClawFreeThe automation platform. FREE FOREVER Open-source, self-hosted on your Mac.
TerminalFreeAlready on your Mac. FREE FOREVER
AI Brain (optional)Free tier availableOpenAI, Google, or others. Most have a free tier to start.
FREE WITH LIMITS

AI provider API keys (like OpenAI) are free to sign up for, but usage beyond the free tier costs money. OpenAI gives you $5 of free credits when you sign up. Google Gemini has a generous free tier.

You can build and test automations without any AI key at all. Add one later when you are ready.

Bottom line: You will not spend a single dollar today. Everything in this guide is free.

How This Guide Works

Every chapter follows the same pattern. First, we explain what you are doing and why. Then, we walk you through how to do it — step by step, one click or one command at a time. We show you what you will see on screen at every stage so you never get lost.

By the end of all 8 chapters, you will have Node.js installed, OpenClaw running, the dashboard open, an AI brain connected, and your first test automation completed. All on your Mac. All free.

What's Inside

  1. What You Need (And What You Already Have)
  2. Install Node.js — The Engine That Runs OpenClaw
  3. Install OpenClaw with One Command
  4. Start OpenClaw and Open the Dashboard
  5. Take the Dashboard Tour
  6. Connect Your First AI Brain
  7. Run Your First Test Automation
  8. Troubleshooting + Next Steps
Chapter 1

What You Need (And What You Already Have)

What This Is

Good news — you probably already have everything you need sitting on your desk right now. A Mac, an internet connection, and about 15 minutes. That is the complete shopping list.

The Full Checklist

1. A Mac computer. Any Mac that still receives software updates will work. MacBook Air, MacBook Pro, iMac, Mac Mini, Mac Studio, Mac Pro — all fine. It does not matter if your Mac has an Intel chip or one of Apple's newer M1, M2, M3, M4, or M5 chips. OpenClaw runs on all of them.

2. An internet connection. You need the internet to download two free programs and to connect OpenClaw to an AI brain later. Wi-Fi or an ethernet cable — either one works.

3. About 15 minutes of your time. That is it. No credit card, no special account, no tech degree.

What Is Terminal?

You are going to use an app called Terminal during this guide. Terminal is already on your Mac. FREE FOREVER You do not need to download it.

Think of Terminal like a text message conversation with your computer. Instead of tapping icons and clicking buttons, you type a short command and press Enter. Your computer reads the command and does what you asked. That is all Terminal is — a place to type instructions.

How to Open Terminal

Screenshot: Spotlight Search with "Terminal" typed in, showing the Terminal app result
Press Command + Space, type "Terminal," and press Enter. That is how you open it.
What you will see: A window that looks like a text editor with a line ending in a dollar sign ($) or a percent sign (%). That symbol means "I am ready for your command."

Pro Tip: Do not be afraid of Terminal. It cannot break your computer. If you type something wrong, it will just say "command not found" and wait for you to try again. It is very patient.

What Are We Installing?

We are going to install two free programs:

  1. Node.js — This is the engine that powers OpenClaw. Think of it like the motor inside a blender. You never see it, but without it, nothing spins. FREE FOREVER
  2. OpenClaw — This is the actual program you will use. It is a free, open-source automation platform. "Open-source" means anyone in the world can look at the code and verify it is safe. No secrets, no hidden tricks. FREE FOREVER

That is the entire plan. Two programs, both free, both safe. Let us start.

When to Use This

You only need to install once. After that, OpenClaw lives on your Mac and you just open it whenever you want to build or run automations.

Chapter 1 Complete

  • I know what I need (a Mac, internet, 15 minutes)
  • I know how to open Terminal
  • I understand we are installing two free programs: Node.js and OpenClaw
Chapter 2

Install Node.js — The Engine That Runs OpenClaw

What This Is

Node.js is a free program made by a huge community of developers. Thousands of tools on the internet depend on it. It is one of the most popular and trusted programs in the world. OpenClaw is built on top of Node.js, so we need to install it first.

Analogy: If OpenClaw is a car, Node.js is the engine. You cannot drive a car without an engine. You cannot run OpenClaw without Node.js.

How to Do It

1

Open your web browser

Safari, Chrome, Firefox — any one works. This is the app you use to visit websites.

2

Go to nodejs.org

Type nodejs.org in the address bar at the top of your browser. Press Enter.

What you will see: A green web page with the Node.js logo (a hexagon shape). There will be two big buttons. One says "LTS" and the other says "Current."
Screenshot: The Node.js homepage at nodejs.org showing the LTS and Current download buttons
The Node.js homepage. Click the LTS button — that is the one you want.
3

Click the LTS button

LTS stands for Long Term Support. This is the stable, tested version. Do not click "Current" — that is for advanced developers testing new features.

What happens next: A file will download to your computer. It will be called something like node-v22.x.x.pkg. You will see it at the bottom of your browser window or in your Downloads folder.
4

Open the downloaded file

Double-click the .pkg file in your Downloads folder. A friendly installer window will appear.

What you will see: A window that says "Install Node.js" with a Continue button.
5

Click through the installer

Click Continue on each screen. Click Agree when it shows the license. Click Install. Your Mac might ask for your password — type it and click Install Software.

What you will see: A progress bar that fills up. When it finishes, you will see a green checkmark and the word "successful."
6

Verify the installation

Open Terminal (remember: Command + Space, type "Terminal," press Enter). Then type this command and press Enter:

Type This Command
node --version
What you will see: A version number like v22.14.0. The exact number does not matter. If you see a number starting with "v," Node.js is installed.
Node.js is installed. You just completed the hardest part. Everything from here is even easier.

If you see "command not found": Close Terminal completely (Command + Q) and open it again. Then try the node --version command one more time. The installer sometimes needs a fresh Terminal window to take effect.

When to Use This

You only install Node.js once. It stays on your Mac until you remove it. No maintenance needed.

Chapter 2 Complete

  • Downloaded Node.js from nodejs.org
  • Ran the installer and clicked through the steps
  • Verified with node --version and saw a version number
Chapter 3

Install OpenClaw with One Command

What This Is

Now that Node.js is installed, installing OpenClaw takes one single command. You type it into Terminal, press Enter, and wait about 30 seconds. That is it.

Node.js came with a tool called npm (Node Package Manager). Think of npm like an app store for developer tools. You are going to use it to download and install OpenClaw.

How to Do It

1

Open Terminal

If Terminal is still open from the last chapter, great. If not, press Command + Space, type Terminal, press Enter.

2

Type the install command

Copy and paste this exact command into Terminal. Then press Enter.

Type This Command
npm install -g openclaw
What this does: npm is the app store. install means download and set up. -g means install it globally (so you can use it from anywhere). openclaw is the name of the program.
3

Wait about 30 seconds

You will see text scrolling in the Terminal window. This is normal. It is downloading files and setting things up. Do not close the window.

What you will see: Lines of text appearing. Some might say "added X packages." When it finishes, you will see the blinking cursor again. That means it is done.
Screenshot: Terminal showing the npm install command completing with "added X packages" message
When you see the cursor blinking again, the install is done. Look for "added X packages" near the bottom.
4

Verify the installation

Type this command and press Enter:

Type This Command
openclaw --version
What you will see: A version number like 0.42.0. If you see a number, OpenClaw is installed.
OpenClaw is installed on your Mac. Two programs down, zero dollars spent.

If you see a "permission denied" error: Try the command again with sudo in front of it: sudo npm install -g openclaw. It will ask for your Mac password. Type it (you will not see the characters appear — that is normal) and press Enter.

Quick Win: You just installed a professional-grade automation platform with one command. Many freelancers and agencies pay hundreds of dollars a month for tools that do less than what OpenClaw does for free.

When to Use This

You only install once. To update OpenClaw later, run the same command: npm install -g openclaw. It will download the latest version.

Chapter 3 Complete

  • Ran the npm install -g openclaw command
  • Waited for it to finish
  • Verified with openclaw --version and saw a version number
Chapter 4

Start OpenClaw and Open the Dashboard

What This Is

OpenClaw runs on your Mac and gives you a visual dashboard in your web browser. Think of it like a control center where you build and manage your automations by dragging and dropping pieces together. No code. Just point, click, and connect.

How to Do It

1

Open Terminal

Press Command + Space, type Terminal, press Enter. (You might already have it open.)

2

Start OpenClaw

Type this command and press Enter:

Type This Command
openclaw start
What you will see: A few lines of text in Terminal. One of them will say something like "OpenClaw is running at http://localhost:3000" or a similar address. That address is your dashboard.
3

Open your web browser

Open Safari, Chrome, or Firefox. Type this address in the address bar and press Enter:

Type This Address
http://localhost:3000
Screenshot: The OpenClaw dashboard loading for the first time in a web browser
The OpenClaw dashboard. This is your automation control center. It runs locally on your Mac — your data never leaves your computer.
4

Create your account

The first time you open the dashboard, it will ask you to create an account. Pick an email and password. This account is local to your Mac — it does not send your data anywhere.

What you will see: A sign-up form, then the main dashboard with a clean, empty workspace.
OpenClaw is running on your Mac and the dashboard is open. You are looking at your new automation control center.

Pro Tip: Bookmark http://localhost:3000 in your browser. That way you can get back to your dashboard with one click. Just remember: Terminal needs to be running the openclaw start command for the dashboard to work.

Important: Do not close the Terminal window while you are using OpenClaw. Terminal is the engine running in the background. If you close it, the dashboard will stop working. You can minimize the Terminal window — just do not close it.

When to Use This

Every time you want to use OpenClaw: open Terminal, type openclaw start, open your browser to localhost:3000. That is your daily startup routine. Takes 10 seconds.

Chapter 4 Complete

  • Ran openclaw start in Terminal
  • Opened the dashboard at localhost:3000
  • Created my local account
  • I know not to close the Terminal window while using OpenClaw
Chapter 5

Take the Dashboard Tour

What This Is

Before you build anything, take 60 seconds to learn where things are. The OpenClaw dashboard has a few key areas. Once you know them, everything else makes sense.

Analogy: This is like walking into a new kitchen. Before you cook, you find where the knives, pots, and stove are. Same idea.

The Main Areas

AreaWhere It IsWhat It Does
SidebarLeft side of the screenYour main menu. Links to Automations, Connections, Runs, and Settings.
AutomationsSidebar → AutomationsWhere you build and manage your automations. This is where you will spend most of your time.
ConnectionsSidebar → ConnectionsWhere you link OpenClaw to other apps and AI brains. Gmail, Slack, OpenAI, Google Sheets — all go here.
RunsSidebar → RunsA log of every time an automation has run. Great for checking if something worked or finding errors.
SettingsBottom of the sidebarAccount settings, appearance, and advanced options.
Screenshot: The OpenClaw dashboard with sidebar labels pointing to Automations, Connections, Runs, and Settings
The OpenClaw sidebar. This is your main menu. Click each item to explore.

How Automations Work (The Big Picture)

Every automation in OpenClaw has three parts:

  1. Trigger — The event that starts the automation. Examples: "Every morning at 8 AM," "When I get a new email," or "When a form is submitted."
  2. Steps — The actions that happen after the trigger. Examples: "Ask AI to write a summary," "Send an email," or "Add a row to a spreadsheet."
  3. Output — The result. Where does the finished work go? An email inbox, a Slack channel, a Google Doc.

You build automations by dragging and dropping these pieces on a visual canvas. No typing code. Just connecting boxes with lines.

Quick Win: Click "Automations" in the sidebar right now. Then click "New Automation." You will see the blank canvas where you build things. Take a look, then come back here for the next chapter.

When to Use This

Refer back to this chapter any time you forget where something is. The sidebar is your home base. Automations, Connections, Runs, Settings — everything lives there.

Chapter 5 Complete

  • I know the four main areas: Automations, Connections, Runs, Settings
  • I understand the three parts of an automation: Trigger, Steps, Output
  • I clicked into the Automations section and saw the canvas
Chapter 6

Connect Your First AI Brain

What This Is

OpenClaw is the body. The AI brain is what makes it smart. Without an AI brain, OpenClaw can still do things like send emails and move data around. But with an AI brain, it can write, summarize, analyze, classify, and think.

A department manager at a mid-size company might connect OpenAI to summarize weekly reports automatically. A freelance writer might use Google Gemini to generate first drafts. The brain you pick depends on what you want to build.

Which AI Brain Should You Pick?

AI ProviderCostBest For
OpenAI (GPT-4o)Free $5 credit, then pay-as-you-goWriting, summarizing, customer service, general tasks
Google GeminiFree tier availableAnalysis, document processing, multilingual tasks
Anthropic (Claude)Free tier availableLong documents, careful analysis, coding help
Ollama (local)Free foreverPrivacy-focused. Runs entirely on your Mac. No data leaves your computer. FREE FOREVER
FREE WITH LIMITS

OpenAI gives you $5 of free credits when you sign up. After that, you pay per use (about $0.01–$0.03 per request). Most individuals and small teams spend less than $5/month.

Start with the free credits. You will know if you need more long before you run out.

Pro Tip: If you are not sure which one to pick, start with OpenAI. It is the most popular and has the most tutorials online. You can always add more brains later.

How to Connect OpenAI (Step by Step)

1

Get your API key from OpenAI

Go to platform.openai.com in your browser. Sign up for a free account (or log in if you already have one). Click your profile icon, then click API Keys. Click Create new secret key. Copy the key — it looks like a long string of random letters and numbers.

What you will see: A string that starts with sk- followed by random characters. Copy it. You will paste it in the next step.

Important: Treat your API key like a password. Do not share it. Do not post it online. If someone gets your key, they can use your account and you will be charged for their usage.

2

Open Connections in OpenClaw

In your OpenClaw dashboard, click Connections in the sidebar. Then click New Connection.

What you will see: A list of available apps and services you can connect to.
3

Find and select OpenAI

Scroll through the list or use the search bar. Click OpenAI.

4

Paste your API key

Paste the key you copied in Step 1. Click Save.

What you will see: A green checkmark or a "Connected" message. Your AI brain is now linked to OpenClaw.
Your AI brain is connected. OpenClaw can now think, write, and analyze for you.
When to Use This

You only connect each AI brain once. After that, every automation you build can use it. You can connect multiple brains and pick which one to use for each automation.

Chapter 6 Complete

  • I picked an AI provider (OpenAI recommended for beginners)
  • I got my API key from the provider's website
  • I connected the key in OpenClaw's Connections section
  • I saw a "Connected" confirmation
Chapter 7

Run Your First Test Automation

What This Is

Time to make sure everything works. You are going to build the simplest possible automation: a button that asks AI to write something, then shows you the result. It takes about 60 seconds to build.

Think of this like turning the key in a new car for the first time. You are not driving anywhere yet. You just want to hear the engine start.

How to Do It

1

Click "New Automation"

In the sidebar, click Automations, then click the New Automation button.

What you will see: A blank canvas with a starting point. This is where you build your automation visually.
2

Add a Manual Trigger

Click the trigger block (the first block on the canvas). Select Manual Trigger from the list. This means the automation runs when you click a button — not on a schedule or in response to an event.

3

Add an AI step

Click the + button below the trigger. Search for OpenAI (or whichever AI brain you connected). Select it. Choose the Ask AI or Generate Text action.

4

Write a simple prompt

In the prompt field, type something simple. Here is a good test:

Test Prompt
Write a 3-sentence motivational message for someone who just installed their first automation tool.
5

Click "Test" or "Run"

Look for a Test button in the top right corner of the canvas. Click it.

What you will see: The automation runs. After a few seconds, you will see the AI's response appear in the output panel. A motivational message written just for you.
Screenshot: The OpenClaw canvas showing a completed test run with AI output visible in the right panel
Your first automation just ran. The AI wrote a response and it appeared in the output panel.
Your first automation worked. OpenClaw is installed, running, connected to an AI brain, and producing results. You are ready to build real automations.

Quick Win: You just built and ran an AI automation in under 60 seconds. An operations team at a 200-person company would use this same pattern to summarize meeting notes, draft status updates, or generate weekly reports — all on autopilot.

When to Use This

Any time you set up a new AI connection or update OpenClaw, run this quick test to make sure everything is still working. It takes 30 seconds and gives you peace of mind.

Chapter 7 Complete

  • Created a new automation with a Manual Trigger
  • Added an AI step with a simple prompt
  • Clicked Test and saw a result from the AI
  • Everything is working end-to-end
Chapter 8

Troubleshooting + Next Steps

What This Is

You have OpenClaw running on your Mac. This final chapter covers the most common issues people run into and gives you a clear plan for what to build next.

Most people install a tool, feel excited, and then never build anything real. The action plan at the bottom makes sure that does not happen to you.

Common Issues and Fixes

ProblemWhat HappensHow to Fix It
"command not found: node"Terminal does not recognize Node.jsClose Terminal (Command + Q) and open it again. If still broken, reinstall Node.js from nodejs.org.
"command not found: openclaw"Terminal does not recognize OpenClawRun npm install -g openclaw again. If you get a permission error, add sudo in front.
"permission denied" errorYour Mac is blocking the installRun sudo npm install -g openclaw and type your Mac password when asked.
Dashboard will not loadBrowser shows an error at localhost:3000Make sure Terminal is still running openclaw start. If you closed it, open Terminal and run the command again.
AI step shows an errorThe AI brain is not respondingCheck your API key in Connections. Make sure it is correct and your account has credits.
"port already in use"Something else is using port 3000Try openclaw start --port 3001 and open localhost:3001 in your browser instead.

Warning: Do not share your API keys. If you post your API key in a forum, on social media, or in a screenshot, someone can use your account and you will be charged. Treat API keys like passwords.

How to Stop and Restart OpenClaw

To stop OpenClaw: Go to the Terminal window where it is running and press Control + C. (That is the Control key, not the Command key.) The dashboard will stop working.

To start it again: Type openclaw start and press Enter. Open your browser to localhost:3000.

Pro Tip: Your automations and settings are saved on your Mac. Stopping and starting OpenClaw does not delete anything. It is like turning off your computer and turning it back on — everything is still there.

How to Update OpenClaw

OpenClaw is updated regularly with new features. To get the latest version, run this command:

Type This Command
npm install -g openclaw@latest

That is it. One command. It downloads the newest version and replaces the old one. Your automations are not affected.

Your Next Steps Action Plan

Today (Done)

  • Installed Node.js and OpenClaw
  • Opened the dashboard and took the tour
  • Connected an AI brain and ran your first test

Tomorrow (15 minutes)

  • Build your first real automation — try a Heartbeat (scheduled) trigger that sends you a daily email summary
  • Explore the Connections page and connect one more app (Gmail, Slack, or Google Sheets)

This Week (30 minutes)

  • Build 2–3 automations for tasks you do every week
  • Check the Runs page to see your automation history
  • Share OpenClaw with a coworker, a teammate, or a friend who would benefit from it

This Month

  • Build a library of go-to automations for your most common tasks
  • Try connecting a second AI brain for comparison
  • Join the OpenClaw community forum to discover automations other people have built

Action Step: Open your OpenClaw dashboard right now and click "New Automation." Build something real. Even a small one. The people who win with automation are not the ones who understand the technology best. They are the ones who actually use it. Every single day.

When to Use This

Come back to this troubleshooting section whenever something goes wrong. And follow the action plan this week — it turns a one-time install into a permanent habit that saves you hours every week.

Chapter 8 Complete

  • I know how to fix the most common issues
  • I know how to stop, start, and update OpenClaw
  • I have a clear action plan for this week
Quick Reference

All Commands — The Bookmarkable Cheat Sheet

Bookmark this section. Come back every time you need a command.

#TaskCommandWhat It Does
1Check Node.jsnode --versionShows which version of Node.js is installed
2Install OpenClawnpm install -g openclawDownloads and installs OpenClaw globally
3Check OpenClawopenclaw --versionShows which version of OpenClaw is installed
4Start OpenClawopenclaw startLaunches the OpenClaw server and dashboard
5Stop OpenClawControl + CStops the running server (press in Terminal)
6Update OpenClawnpm install -g openclaw@latestDownloads the newest version
7Use different portopenclaw start --port 3001Starts on port 3001 if 3000 is taken
8Fix permissionssudo npm install -g openclawInstalls with admin access (asks for your password)
What's Next

What to Do Next

You now have OpenClaw installed and running on your Mac. Here are three ways to keep building:

Our recommendation: When connecting an AI model to OpenClaw, we recommend Claude by Anthropic. It follows instructions precisely, handles structured data well, and takes your privacy seriously. You're welcome to use any AI tool — ChatGPT, Gemini, Perplexity all work great. But if you want our honest pick, try Claude.

claude.ai (web)  ·  iPhone app  ·  Android app

Ready to Automate Your Work?

Join thousands of people who use CreatorHQ to work smarter, not harder.

Explore CreatorHQ