RobotsHelp

OpenClaw installeren op je Mac (via de menubalk-app of Terminal, stap voor stap)

Je hoort steeds vaker over OpenClaw en wilt het vanavond op je Mac installeren. Maar in de handleiding zie je een menubalk-app, een Terminal-commando, npm en iets dat Gateway heet. Welke optie past bij jou? En wat als je Mac al een paar jaar oud is?

Dit is het korte antwoord. Draait je Mac op macOS Tahoe 26.2 of nieuwer? Dan installeer je OpenClaw het makkelijkst via de menubalk-app. Download de DMG via de OpenClaw-releasepagina, sleep OpenClaw naar Applications, open de app, kies This Mac en laat de app zichzelf instellen. Voor dat deel heb je geen Terminal, Homebrew of beheerdersrechten nodig. Op een oudere Mac, of als je liever Terminal gebruikt, is één commando genoeg: curl -fsSL https://openclaw.ai/install.sh | bash. Bij beide opties heb je toegang tot een AI-model nodig: via een bestaande Codex- of Claude-login, of een API-sleutel. Volgens de handleiding kun je binnen enkele minuten je eerste chat starten. Trek er 20 minuten voor uit, zodat je rustig kunt meelezen. Hieronder staan de stappen voor beide opties.

Wil je elke week zo’n praktische AI-les?

No password needed – your reset opens instantly.

Geen wachtwoord. Alleen je e-mailadres, en je bent erbij.

Voor je begint: controleer twee dingen op je Mac

Open het Apple-menu linksboven en kies About This Mac (Over deze Mac). In dat venster vind je beide antwoorden.

  • Je macOS-versie. Het venster toont de naam en het versienummer (Apple: welke macOS-versie gebruikt je Mac?). De OpenClaw-app vereist macOS 26.2 (Tahoe) of nieuwer. Via Terminal zijn de eisen minder streng: de Node-versies waarop OpenClaw draait, zijn gemaakt voor macOS 13.5 of nieuwer. Op oudere macOS-versies “werken ze mogelijk nog, maar worden ze niet ondersteund” (OpenClaw-handleiding: macOS-app).
  • Je chip. Zie je Chip met een naam als M1 of M3? Dan heb je Apple silicon. Zie je Processor met een Intel-naam? Dan heb je een Intel Mac (Apple: Mac-computers met Apple silicon). OpenClaw heeft voor beide een download. Er is ook een Universal-versie als je het niet zeker weet.

Verder heb je toegang tot een AI-model nodig. OpenClaw zelf is gratis en opensource onder de MIT-licentie. Het model erachter doet het denkwerk, en daarvoor betaal je. Bij het instellen kun je een bestaande Codex- of Claude-login gebruiken, of een API-sleutel van OpenAI of Anthropic.

Twijfel je nog of OpenClaw de juiste tool voor je is? Lees dan eerst OpenClaw versus Claude Code of OpenClaw versus Claude Cowork. Op deze pagina gaan we ervan uit dat je je keuze hebt gemaakt.

Welke installatiemethode past bij je Mac?

  • De menubalk-app (OpenClaw.app). Een gewone Mac-app met een icoon in de menubalk, een dashboard, een chatvenster en een Quick Chat-balk. De benodigde runtime zit erbij: de software waarmee OpenClaw draait. Je hoeft Node dus niet apart te installeren. De beste keuze als je macOS 26.2 of nieuwer hebt en liever niet met Terminal werkt.
  • Het installatieprogramma voor Terminal. Eén commando installeert zo nodig Node, installeert OpenClaw en helpt je stap voor stap met instellen. De beste keuze voor oudere Macs, of als je graag ziet wat er gebeurt.
  • npm. Alleen als je Node al zelf beheert. Verderop staat hiervoor een kort blok met instructies.

Een term die je overal tegenkomt: de Gateway. Dat is het onderdeel van OpenClaw dat op de achtergrond draait, je instellingen bewaart en je chatapps met de AI verbindt. Bij beide installatiemethoden draait er uiteindelijk een Gateway op je Mac.

OpenClaw installeren op je Mac met de menubalk-app

  1. Download de juiste DMG. Ga naar de OpenClaw-releasepagina op GitHub en kies de Apple Silicon-, Intel- of Universal-DMG. Toen deze pagina werd geschreven, verwees de handleiding naar release 2026.10.3. Volgens de handleiding bevatten sommige releases alleen CLI- of Windows-bestanden. Zit er bij de nieuwste release geen Mac-app? Neem dan de nieuwste release die er wel een heeft.
  2. Zet de app in Applications. Open de DMG en sleep OpenClaw naar de map Applications. Start de app niet vanuit Downloads of vanuit de schijfkopie. De pagina over machtigingen legt uit waarom: macOS koppelt machtigingen aan de locatie van de app. Een uitgebrachte versie hoort te draaien vanuit /Applications/OpenClaw.app, zodat je verleende machtigingen behouden blijven (OpenClaw-handleiding: macOS-machtigingen).
  3. Open de app en keur twee verzoeken goed. macOS vraagt of je een gedownloade app wilt openen: klik op Open. Daarna vraagt het of OpenClaw apparaten op je lokale netwerk mag vinden: klik op Allow (Sta toe). De app gebruikt dit om een Gateway op een andere computer te bereiken (OpenClaw-handleiding: de macOS-app instellen).
  4. Lees de beveiligingsmelding. Die legt uit dat OpenClaw standaard een persoonlijke agent is voor één vertrouwde persoon. Ga verder als dat bij jouw gebruik past.
  5. Kies This Mac. In het venster Getting things ready wordt de meegeleverde runtime klaargemaakt en wordt de Gateway gestart en gecontroleerd. Volgens de handleiding hoef je voor deze stap geen runtime te downloaden en heb je geen Node, Terminal, Homebrew of beheerdersrechten nodig. Voor het verbinden met een AI-aanbieder kan wel internet nodig zijn (OpenClaw-handleiding: Gateway op macOS).
  6. Laat de app verbinding maken met je AI. De app probeert achtereenvolgens: opgeslagen OpenClaw-logins, een Codex-login, een Claude CLI-login, een OPENAI_API_KEY of ANTHROPIC_API_KEY en modellen die al geladen zijn in Ollama, LM Studio of llama.cpp. Elke optie wordt met een echt verzoek getest. De eerste die werkt, wordt gebruikt. Werkt er niets? Dan stelt de app de officiële Codex-plugin in en biedt hij aan om met ChatGPT in te loggen. In het dashboard zie je wat er is gekozen. Je kunt daar ook wisselen.
  7. Rond het instellen af in het dashboard. Een begeleid gesprek helpt je met de rest: geheugen importeren, chatkanalen en machtigingen. Alles is optioneel en je kunt er later op terugkomen.

Eén instelling om meteen te kennen. Bij een nieuwe installatie draait de Gateway via de app zelf. Hij stopt dus als je de app afsluit. Wil je dat OpenClaw blijft werken wanneer de app gesloten is? Zet dan Keep OpenClaw running when the app is closed aan. Je vindt die optie naast Launch at login in de apparaatinstellingen van het dashboard. Standaard staat hij uit. Probeer ook Quick Chat: druk op Option-Space voor een chatbalk zoals Spotlight, zonder een volledig venster te openen.

OpenClaw installeren op je Mac via Terminal

Heb je een oudere Mac, of werk je gewoon liever met Terminal? Druk op Command-Space, typ Terminal en druk op Return. Plak daarna:

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

Het script controleert je Node-versie en installeert Node 26 via Homebrew als Node ontbreekt. Het installeert Homebrew alleen als dat nodig is voor Node of Git (OpenClaw-handleiding: hoe het installatieprogramma werkt). Daarna installeert het OpenClaw en start het de installatiewizard. Vervolgens:

  1. Kies Quick start. Deze optie zoekt een bestaande Codex- of Claude Code-login of API-sleutel, test die met een echt verzoek, bewaart je instellingen en opent het webdashboard (OpenClaw-handleiding: aan de slag).
  2. Laat OpenClaw op de achtergrond draaien. Quick start houdt de Gateway actief in dat Terminal-venster. Druk op Control-C om hem te stoppen en voer daarna openclaw gateway install uit. Op een Mac maakt dit een LaunchAgent aan. Daardoor start de Gateway wanneer je inlogt en start hij opnieuw als hij crasht. Je instellingen blijven bewaard.
  3. Controleer of alles werkt:
openclaw --version
openclaw doctor
openclaw gateway status

De status hoort aan te geven dat de Gateway luistert op poort 18789. Voer daarna openclaw dashboard uit om de Control UI, het bedieningsscherm, in je browser te openen. Laadt die pagina? Dan werkt alles.

Beheer je Node al zelf? De handleiding geeft deze methode voor npm 12 of 11.16 en nieuwer. Bij npm 11.15 of ouder laat je --allow-scripts=openclaw weg:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

OpenClaw vereist Node 24.16+ of 26.1+. Node 26 is de aanbevolen versie (OpenClaw-handleiding: installeren).

Mac-machtigingen, helder uitgelegd

Bij Mac-installaties ontstaat de meeste verwarring rond machtigingen. Neem hier dus twee minuten voor. macOS regelt de toegang tot je scherm, microfoon, bestanden en toetsenbordbediening met aparte machtigingen. OpenClaw vraagt er pas om als een tool er een nodig heeft. Je ziet dan een kaart met Grant (toestemming geven) in de chat. De agent wacht op jou voordat hij het opnieuw probeert.

  • Geef toestemming voor wat je gebruikt, niet voor alles. De volledige lijst staat onder Dashboard > Settings > This Mac > Permissions: Automation, Notifications, Accessibility, Screen Recording, Microphone, Speech Recognition, Camera en Location. Gebruik je de chat om te schrijven en informatie uit te zoeken? Dan kun je de uitgebreidere machtigingen uit laten staan totdat een tool erom vraagt.
  • Blijft Screen Recording als ontbrekend staan? Klik op Grant, zet OpenClaw aan onder Privacy & Security > Screen & System Audio Recording in System Settings en sluit OpenClaw daarna af en open het opnieuw.
  • Geef Accessibility nooit aan “node”. Volgens de handleiding kan elk script dat via die Node draait de interface van je Mac bedienen als node toegang heeft via Accessibility. Geef die machtiging aan OpenClaw.app en verwijder een node-vermelding als je die per ongeluk hebt toegevoegd.
  • Loopt het werken met bestanden op je bureaublad of in Documenten vast? macOS kan achtergrondprocessen de toegang tot die mappen ontzeggen. De eenvoudige oplossing uit de handleiding: zet de bestanden waarmee OpenClaw moet werken in zijn eigen werkmap, ~/.openclaw/workspace.

Nog een opslagtip: bewaar de gegevens van OpenClaw op de eigen schijf van je Mac, niet in iCloud Drive of een andere gesynchroniseerde map. Volgens de handleiding kunnen synchronisatievertragingen en vergrendelde bestanden sessies en inloggegevens onbruikbaar maken. openclaw doctor geeft een melding als je gegevens in een gesynchroniseerde map staan.

Je eerste 15 minuten na de installatie

Een installatie levert pas iets op als je er werk mee gedaan krijgt. Doe daarom meteen deze drie dingen:

  1. Stuur je eerste bericht. Kies iets kleins uit je eigen werk: “Maak van deze notities een checklist voor morgenochtend: [plak hier]”. Krijg je antwoord? Dan werkt de verbinding met de AI.
  2. Koppel Telegram als je vanaf je telefoon berichten wilt sturen. Volgens de handleiding is dit het snelst in te stellen kanaal, omdat je alleen een bottoken nodig hebt. Standaard krijgt iedereen die je bot voor het eerst een bericht stuurt een koppelcode van 8 tekens. Niets van wat die persoon stuurt, wordt verwerkt totdat jij de koppeling goedkeurt. Codes verlopen na één uur (OpenClaw-handleiding: koppelen).
  3. Voer de beveiligingscontrole uit: openclaw security audit. Die laat zien of je instellingen afwijken van de veilige standaardinstellingen (OpenClaw-handleiding: beveiliging). Los de gemelde punten op voordat je meer kanalen toevoegt.

Geef de agent daarna één taak die elke week terugkomt, zoals op vrijdag een samenvatting maken van je notitiebestand. Bouw je liever AI-agents met tools waarin je onderdelen sleept en neerzet? Lees dan hoe je een AI-agent bouwt zonder code.

Kun je het AI-model ook op je Mac draaien?

Ja, maar weet wat erbij komt kijken. Heb je al een model geladen in Ollama, LM Studio of llama.cpp? Dan kan de app dat tijdens het instellen vinden. Volgens de handleiding downloadt de app nooit uit zichzelf een model. Wil je stap voor stap worden geholpen? Installeer dan de llama.cpp-plugin, voer openclaw onboard uit en kies Managed local server. Voordat de download begint, zie je het model, de downloadgrootte en de backend. Ook wordt een echte toolaanroep getest voordat het model als standaard wordt ingesteld. De kleinste configuratie vereist minstens 8 GiB geheugen. Grotere configuraties hebben meer nodig (OpenClaw-handleiding: lokale modellen). Dezelfde pagina benoemt ook eerlijk de beperking: lokale modellen hebben niet de veiligheidsfilters van modellen die bij een aanbieder draaien. Begin met een model bij een aanbieder, zorg dat één echte taak werkt en ga daarna experimenteren.

Wil je speciaal hiervoor een Mac kopen? Bekijk dan welke Mac mini-specificaties OpenClaw echt nodig heeft, voor een model in de cloud en voor een lokaal model.

Als de installatie niet werkt

  • Weet je niet precies wat er misgaat? Voer openclaw triage uit. Dit commando voert controles uit zonder iets te wijzigen en maakt een duidelijke probleembeschrijving. Het kan die doorgeven aan Claude Code, Codex of de eigen agent van OpenClaw. Volgens de handleiding verlaat niets je Mac totdat jij een van die opties kiest.
  • “command not found: openclaw”: sluit eerst Terminal en open een nieuw venster. Heb je de app gebruikt? Controleer dan of die vanuit Applications draait. Volgens de handleiding voegen exemplaren die vanuit Downloads, het bureaublad of een schijfkopie draaien het commando openclaw niet toe aan je shell. Bij een installatie via Terminal ligt het bijna altijd aan PATH. De Node.js-pagina in de handleiding helpt je stap voor stap verder.
  • Het instellen van de app lukt niet: kies Retry setup. Je kunt ook Connection… openen via het icoon in de menubalk. Daar biedt de app Install, Update of Repair Gateway aan. Meldt de app dat de runtime ontbreekt of niet goed werkt? Installeer OpenClaw.app dan opnieuw.
  • Een verzoek om toestemming verschijnt niet: sluit de app af, verwijder OpenClaw onder System Settings > Privacy & Security, open de app opnieuw vanuit Applications en geef opnieuw toestemming. Volgens de handleiding komen sommige machtigingen pas terug nadat je de Mac volledig opnieuw hebt opgestart.
  • De Gateway blijft opnieuw starten: voer openclaw gateway status en openclaw doctor uit. Het logbestand staat in ~/Library/Logs/openclaw/gateway.log.

Is installeren op je werk-Mac verstandig?

Overleg eerst. OpenClaw draait op de achtergrond, is bereikbaar via chatapps en kan tools krijgen die handelingen op je Mac uitvoeren. De beveiligingsmelding tijdens het instellen zegt dat het is gebouwd voor één vertrouwde persoon. Gedeelde installaties hebben extra beveiligingsmaatregelen nodig. Wil je het op een bedrijfslaptop gebruiken? Bespreek dat dan met je IT-team. Op een eigen Mac kun je makkelijker leren hoe het werkt.

Wil je weten of een desktopagent die door je apps klikt beter bij je kantoorwerk past? Onze gids over de beste AI-agent voor werkprocessen op je desktop vergelijkt de opties. Wil je OpenClaw ook op een pc instellen? Lees dan hoe je OpenClaw op Windows installeert.

Korte antwoorden

Werkt OpenClaw op een oudere Mac?

De menubalk-app vereist macOS 26.2 of nieuwer. De installatie via Terminal draait op Node. De Mac-versies daarvan zijn gemaakt voor macOS 13.5 en nieuwer. Op oudere macOS-versies werkt het mogelijk, maar die worden niet ondersteund.

Apple silicon of Intel?

Allebei. Voor elk is er een aparte DMG. Er is ook een Universal-DMG als je niet zeker weet welke je hebt.

Heb ik Homebrew nodig?

Niet voor de app. Het installatieprogramma voor Terminal gebruikt Homebrew alleen als het nodig is om Node of Git te installeren.

Is OpenClaw gratis?

De software is gratis en opensource (MIT-licentie). Je betaalt voor het AI-model dat je koppelt, tenzij je een lokaal model op je eigen Mac draait.

Hoe verwijder ik OpenClaw?

Bekijk eerst wat er wordt verwijderd met openclaw uninstall --dry-run --all. Voer daarna openclaw uninstall --all uit om de achtergrondservice, instellingen, werkmap en app te verwijderen. Wil je de bestanden van je agent bewaren? Voer dan alleen openclaw uninstall uit en kies wat je wilt verwijderen. Heb je de app geïnstalleerd? Verwijder die dan ook uit Applications (OpenClaw-handleiding: verwijderen).

Controleer je macOS-versie, kies je installatiemethode en stuur je eerste bericht voordat je vanavond je laptop dichtklapt.

Wil je de volgende les in je inbox?

No password needed – your reset opens instantly.

Geen wachtwoord. Alleen je e-mailadres, en je bent erbij.

Wil je OpenClaw de hele dag laten draaien zonder je laptop? Zo stel je een Mac mini in als OpenClaw-computer die altijd aanstaat.

Bronnen

🇬🇧 Read this page in English