Accrued Intelligence
Applied Intelligence
Augmented Intelligence
Amplified Intelligence

Beginner guide · Mac · OpenClaw

Install OpenClaw on your Mac.

A SAGE9AI beginner install guide for the current native-app path: download OpenClaw.app, choose This Mac, connect one AI provider, pass the live model check, and open the dashboard.

Primary pathOpenClaw.app (.dmg)

First winLive model check passes

FinishDashboard chat works

OpenClaw on Mac: Beginner Install Guide

Goal: install the official OpenClaw macOS app, let it create a local Gateway on This Mac, verify one AI connection, and send one safe test message.

The current official macOS path supports complete first-run setup inside OpenClaw.app. The app installs its matching external CLI runtime, starts a local Gateway, tests the AI connection you select, and then opens the dashboard.

Requirement: OpenClaw.app needs macOS 15.0 Sequoia or later. On an older Mac, use the CLI/Gateway path only; installing the CLI does not make the native app compatible.

What you install first

OpenClaw.app from the official GitHub release assets.

What success means

The browser dashboard opens and one safe message gets an AI reply.

What you skip now

Source builds, optional chat channels, hooks, webhooks, remote hosting, and deep customization.

Step 01

Before you start

Confirm these basics before installing:

You are on a Mac you control.
You know your Mac login password.
You have reliable internet.
Your Mac runs macOS 15.0 Sequoia or later for OpenClaw.app.

You have a model-provider account or API key ready, or you can create one during setup.
You can receive email/login verification codes.
You will not paste passwords, recovery codes, banking data, health data, or private customer records into test prompts.
You can monitor billing if you choose a paid model provider.

Step 02

Choose the beginner path

Path	Use when	Beginner note
OpenClaw.app	Your Mac runs macOS 15+ and you want the easiest visual setup.	Use this guide. Download the .dmg from official releases.
CLI installer	You only need the CLI/Gateway, use an older supported macOS for Node, or support asks for Terminal setup.	Valid alternative. It launches CLI onboarding and the browser dashboard.
Source build	You are contributing or support specifically asks for it.	Not a beginner path.

Step 03

Download and install OpenClaw.app

Use only the official OpenClaw GitHub release assets. The preferred Mac download is OpenClaw-<version>.dmg.

Open OpenClaw GitHub releases.
Open the newest release that includes a macOS app asset. Some releases do not include one.
Download OpenClaw-<version>.dmg (preferred), or the matching .zip.
Open the .dmg and place OpenClaw.app in Applications, then launch it.
If macOS shows a security prompt, continue only if you personally downloaded the app from the official openclaw/openclaw repository.

No developer tools needed for this path: do not install Xcode, Git, Node, or a separate CLI before first launch. For a new local Gateway, the app installs its matching external CLI runtime.

If the newest release has no Mac app

Use the newest release that does include a .dmg or .zip. Do not download look-alike installers from third-party sites.

Step 04

Complete first launch and the live model check

OpenClaw.app now handles the beginner setup sequence. Make each choice explicitly; detection never authorizes or selects a provider for you.

If OpenClaw asks...	Beginner answer	What happens
Where to connect	Choose This Mac.	The app installs its matching external CLI runtime and starts a local Gateway. Choose an existing Gateway only if you already operate one.
AI connection	Select one provider or existing connection you recognize.	OpenClaw tests only the connection you explicitly select.
Login, OAuth, device code, or API key	Follow the official provider flow. Never share a code or key, and continue only if you initiated it.	The selected provider is authorized for OpenClaw.
Live model check	Wait for it to pass. Retry or choose another connection if it fails.	A real completion proves the AI route can answer before setup finishes.
Memory, channels, or permissions	Finish basic setup first. Grant only the Mac permissions you understand.	The dashboard can guide these later; permissions remain available under Settings → This Mac → Permissions.

Security gate: sensitive capabilities require confirmation. Cancel anything you did not request. Do not weaken Gateway authentication or grant broad Mac access just to clear a warning.

Step 05

Open the dashboard and verify one safe reply

After the live model check succeeds, the app opens the dashboard. Confirm the local Gateway is connected and send one safe message. The commands below are optional checks for users who also use Terminal:

Check the Gateway

openclaw gateway status

You want to see the Gateway running, usually on port 18789.

Open the dashboard

openclaw dashboard

This opens the browser dashboard. If it loads, you are in the main OpenClaw interface.

The main chat is the normal dashboard chat area. Type a safe test message such as:

Reply with one sentence confirming that the model connection works. Do not change files, connect accounts, or send messages.

If you get a useful reply, the first install goal is complete.

Step 06

Gateway key handling for beginners

The Gateway is the communication hub. OpenClaw’s docs say gateway auth uses a token by default. Treat any gateway token, remote token, API key, or password-like value as private.

Do not paste gateway tokens into public chats, screenshots, support forums, or shared documents.
Do not turn gateway auth off just to make setup feel easier.
Use local/default Gateway settings for your first install.
Only configure remote access if you understand who can reach the Gateway and how the token is stored.
If a key/token is exposed, rotate or replace it instead of reusing it.

Step 07

Add communications after the dashboard works

OpenClaw can connect to many channels, but a complete beginner should not configure all of them during first install. Add one channel only after the dashboard chat works.

Channel choice	Beginner guidance
Dashboard / WebChat	Use this first. It is already connected through the local Gateway and proves the core setup works.
Telegram	Optional later. It requires a bot token and an allowlist/pairing step.
WhatsApp, Signal, Slack, Discord, iMessage, Teams, Google Chat	Useful later. Each has its own setup, account, pairing, permissions, and troubleshooting path.
Group chats or ambient rooms	Skip until you understand mention behavior, allowlists, and bot-loop protection.

Alternative

CLI/Gateway path instead of the Mac app

Use this only when you want a terminal-first installation, only need the CLI/Gateway, or cannot run OpenClaw.app. The hosted installer detects the OS, provisions a supported Node runtime when needed, installs OpenClaw, and launches onboarding.

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

Copy the command from official install documentation, not a forum or message.
Run it in Terminal and choose Quick start for a fresh local setup.
Select one AI connection and wait for the real completion check to pass.
The foreground Gateway opens the browser dashboard. Pressing Control-C stops that foreground process; configuration remains saved.

Quick troubleshooting

Problem	First fix
The Mac app will not install or open.	Confirm macOS 15+ and verify the download came from official releases. If the newest release lacks a Mac asset, use the newest one that includes a .dmg or .zip.
`openclaw: command not found`	Quit and reopen Terminal, then try again. If it still fails, rerun the official installer or check the OpenClaw install docs.
OpenClaw opens but does not answer.	Return to model/provider setup. The first chat requires a provider that passes the live model check.
The dashboard does not open.	Run `openclaw gateway status`. If the Gateway is not running, use `openclaw doctor` or rerun onboarding.
Channel setup is confusing.	Skip channels until dashboard chat works. Add one channel later, starting with Telegram if it fits your needs.
The macOS app asks about local vs remote Gateway.	Choose This Mac for a normal personal Mac setup. Remote is for advanced multi-machine setups.

Checklist

Beginner success checklist

My Mac runs macOS 15+.
I downloaded OpenClaw.app from the official GitHub releases.
I chose This Mac for a new local Gateway.
I explicitly selected one AI connection.

The live model check passed.
I received one useful reply in the dashboard.
I skipped optional channels and remote access for now.
I know codes, gateway tokens, and API keys are private.

Next SAGE9AI step:

Once OpenClaw answers in the dashboard, use one simple workflow first. Do not customize every channel or automation before the first practical win.

Pro Tip:

Once your basic agent is up and running, it can install, configure, and set up anything else you would like within the agent harness. No need to guess or research how to do it, because your agent already knows. Just ask it. For safety, tell it to explain the plan before making changes, connecting accounts, or sending messages.

Official sources checked: macOS, Install, Onboarding Wizard, and GitHub Releases. Key facts: OpenClaw.app requires macOS 15+; .dmg is preferred; This Mac installs a matching external CLI runtime and starts the local Gateway; the user explicitly selects an AI connection; a live model check must pass before the dashboard opens.