Back to blog
GuideOpenClawMac miniAI agentsSetupmacOS

OpenClaw on a Mac mini: Setup, Requirements and Keeping It Running

November 15, 20268 min readby Macyou Team

A Mac mini is one of the simplest machines to run OpenClaw on. One command installs it, a second one registers the gateway as a background service, and the Mac then needs three settings so that the agent stays up: no sleep, restart after a power cut, and automatic login. OpenClaw’s documentation asks for Node.js 24.16 or 26.1 and newer, which its installer sets up for you, and macOS 13.5 or later. It states no memory or processor minimum for the gateway, so with a hosted model any Apple silicon Mac mini with 16 GB is enough. The commands and limits below were checked against OpenClaw’s documentation on 15 November 2026.

OpenClaw requirements on a Mac mini

RequirementWhat OpenClaw’s documentation says
Node.js24.16.0 or newer on the 24 line, or 26.1.0 or newer; Node 26 is recommended, and the installer adds it on macOS when it is missing
macOS for the gatewaymacOS 13.5 or later, the oldest version the official Node 24 and Node 26 builds support
macOS for the menu bar appmacOS 26.2 (Tahoe) or later
Memory and processorNo minimum stated for the gateway; the smallest local model recipe has an 8 GiB floor
Network port18789, bound to the Mac itself (loopback) by default

Memory only becomes the deciding number when the model runs on the Mac too. Which Mac mini to buy for that is covered in the best Mac mini for OpenClaw.

Install OpenClaw on the Mac mini

  1. Open Terminal on the Mac mini, or connect to it over SSH, and run the installer. It installs Node.js if needed and then starts the setup questions.
  2. Answer the setup questions: the model provider and its key, and the chat channels you want.
  3. Install the gateway as a background service and start it. On macOS this creates a LaunchAgent named ai.openclaw.gateway.
  4. Check that it is running and open the control page in a browser on the Mac.
# 1. Install (macOS, Linux, WSL2)
curl -fsSL https://openclaw.ai/install.sh | bash

# or with npm, if Node.js is already installed
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

# 3. Background service, if you skipped it during setup
openclaw gateway install
openclaw gateway start

# 4. Check and open the control page
openclaw gateway status
openclaw dashboard

After the start command the documentation says you should see the gateway listening on port 18789. If you prefer an app, OpenClaw also ships a macOS app as a disk image on its GitHub releases page; it can install and repair the gateway from its Connection tab.

Keep the Mac mini awake and the gateway running

OpenClaw’s documentation recommends hardware that stays powered on, but it gives no command against sleep. These are macOS settings, named as in Apple’s own guides:

  • System Settings, Energy: turn on Prevent automatic sleeping when the display is off. A Mac mini without a screen would otherwise go to sleep.
  • System Settings, Energy: turn on Start up automatically after a power failure, so the Mac comes back by itself after a power cut.
  • System Settings, Users & Groups: choose your account under Automatically log in as. The gateway is a LaunchAgent, and Apple’s developer guide says a user agent runs only while that user is logged in. Without automatic login a restarted Mac mini waits at the login window and the agent stays down.

One limit: Apple says a Mac asks for a manual login when the macOS startup disk encryption setting is turned on, so automatic login and that setting do not go together. Decide which matters more for this machine: restarting with nobody there, or the extra encryption layer.

Reach the gateway from another computer

The gateway listens only on the Mac mini itself. OpenClaw’s remote access page calls loopback with SSH or Tailscale Serve “the safest default” and tells you to keep the gateway loopback only unless you are sure you need more. The SSH tunnel from the documentation:

ssh -N -L 18789:127.0.0.1:18789 user@gateway-host

While the tunnel is open, port 18789 on your own computer leads to the gateway on the Mac mini. With Tailscale installed and logged in on the Mac mini, openclaw gateway --tailscale serve publishes the gateway inside your own Tailscale network and keeps it bound to loopback. Do not forward port 18789 on your router.

What a Mac mini adds over a Linux server

OpenClaw runs on macOS, Linux and Windows. These parts need a Mac:

  • iMessage. OpenClaw reaches Messages through the imsg command line tool. The documentation requires that Messages is signed in on the Mac running it, Full Disk Access for the process, and Automation permission to send through the Messages app. Reactions, edits and other advanced actions also need System Integrity Protection turned off; plain text and media work without that.
  • The menu bar app. It adds notifications, voice input, permission prompts and tools that act on the Mac, and needs macOS 26.2 or later. Voice Wake has the same requirement.
  • A local model. Apple silicon gives the model the whole unified memory. Which model fits which memory size, and how to connect Ollama or LM Studio, is in best local models for OpenClaw.

The macOS permission prompts appear on the screen, so plan for a display or Screen Sharing during setup even if the Mac mini runs without a monitor afterwards.

Update and remove

# update, then check
openclaw update
openclaw gateway status

# remove OpenClaw
openclaw uninstall

The documentation asks you to remove the gateway service before you delete OpenClaw’s files by hand: openclaw gateway stop, then openclaw gateway uninstall.

A Mac mini at home or a rented one

A Mac mini on your desk costs nothing per month beyond electricity, and the agent shares your home network and your power. A rented Mac in a data center keeps it away from both. What each choice costs with tokens included is worked out in OpenClaw cost per month, and other places to run it are compared in OpenClaw hosting. Locking the agent down is covered in OpenClaw security on a Mac.

Macyou rents dedicated Mac minis and Mac Studios by the month or by the year: an M4 Mac mini with 16 GB costs $99 a month, or $80 a month billed annually. Your macOS account is an administrator with sudo, so the install commands above work as written, and you reach port 18789 through the same kind of SSH tunnel. Nothing is installed for you. Signing in to an Apple Account is allowed as long as Find My Mac stays off, and System Integrity Protection stays on under our rules, so the advanced iMessage actions that need it off are not available. Rules for administrator access.

Rent a dedicated M4 Mac mini

Questions

Can OpenClaw run on a Mac mini?

Yes. The gateway needs Node.js 24.16 or 26.1 and newer and macOS 13.5 or later. The documentation states no memory minimum for the gateway, so with a hosted model a 16 GB Mac mini is enough.

How do I keep OpenClaw running all the time on a Mac mini?

Install the gateway as a service with openclaw gateway install, prevent sleep in the Energy settings, turn on start up after a power failure, and set automatic login, because the service runs only while its user is logged in.

Does OpenClaw work on an Intel Mac mini?

The gateway does, if the Mac runs macOS 13.5 or later. The menu bar app needs macOS 26.2, and local models are far slower without Apple silicon.

Do I need a Mac mini for OpenClaw?

No. OpenClaw also runs on Linux and Windows. A Mac is needed for iMessage, the menu bar app and Voice Wake, and it is the practical choice for a local model in unified memory.

Sources