OpenClaw for macOS

A native macOS menu bar launcher for OpenClaw — built to make a local AI agent workspace feel like a real Mac app instead of a terminal chore.

OpenClaw for macOS installs, starts, monitors, and opens a local OpenClaw runtime from the menu bar. It includes guided setup, local runtime management, provider authentication, official skills, logs, diagnostics, and drag-to-Applications DMG packaging for testing.

Built by OpenZen. The source code in this repository was generated by AI agent workflows under human direction, review, and product judgment. No source files were hand-written line by line by a human developer.

Why this exists

Local AI agent tools are powerful, but setup is often too technical for normal daily use. OpenClaw for macOS wraps the local runtime in a clean native launcher:

• install or uninstall from a guided wizard;
• start and stop the local server from the menu bar;
• open the browser UI without remembering commands;
• keep provider credentials in macOS Keychain;
• export diagnostics when something goes wrong;
• package a universal Apple Silicon + Intel DMG.

Highlights

• Native SwiftUI MenuBarExtra app.
• First-run wizard for install/uninstall, language, runtime source, data location, port, provider access, skills, and launch preferences.
• OpenClaw runtime install from npm/latest package or supported archive links.
• Localhost-only server model with auth token support.
• Provider authentication flow for Codex / ChatGPT and API-key based providers.
• Bundled official skills installer.
• Preferences, logs, diagnostics export, and clean uninstall.
• Universal launcher binary: arm64 + x86_64.
• Development DMG packaging script with smoke tests and ad-hoc signing.

Download

Download the latest test build from GitHub Releases:

• OpenClaw-20260520-verified.dmg

This is a development/test DMG. It is ad-hoc signed and verified locally, but not yet Developer ID signed or Apple notarized. macOS may show Gatekeeper warnings until a production notarized release is available.

Current build

• Version: 0.1.11-test
• Build: 12
• DMG: OpenClaw-20260520-verified.dmg
• SHA-256: fdb8b93963bb05d4fd220c52069ce0e68e920e1fff7aefe56a447f25b8dde1bd
• Platforms: macOS 13 Ventura or newer, Apple Silicon and Intel

Security model

OpenClaw for macOS is designed around local-first control:

• the local server binds to 127.0.0.1;
• an auth token is generated locally;
• token files are written with restrictive permissions;
• credentials configured through the app are stored in macOS Keychain;
• cloud AI traffic is sent only to providers the user configures;
• uninstall uses an allowlist before removing user data.

See docs/SECURITY.md for details.

Build locally

Requirements:

• macOS 13 or newer;
• Xcode / Xcode command line tools;
• Node.js for runtime smoke tests;
• Apple Developer ID certificate only for production signing/notarization.

./Scripts/package-dev-dmg.sh

Output:

build/OpenClaw-20260520-verified.dmg

For development details, see:

• docs/DEVELOPMENT.md
• docs/ARCHITECTURE.md
• docs/RELEASE.md
• reports/OpenClaw Mac Implementation Report.md

AI-generated project statement

This repository is an experiment in AI-native software creation.

The implementation, documentation, scripts, packaging flow, and release notes were generated by AI agent workflows. The human role was product direction, testing decisions, review, and final publication.

The goal is not to hide that AI wrote it. The goal is the opposite: show that useful, inspectable, improvable software can be created in public with AI agents and then handed to the community for review, fixes, and improvements.

If you see a problem, open an issue or send a pull request.

About OpenZen

OpenZen is a practical AI product studio from Engelskirchen, Germany. We build privacy-first tools for real-world tasks: local AI agent control, help navigation in Germany, medical search assistance, waste sorting guidance, and AI-assisted engineering workflows.

Website: https://openzen.info

License

MIT. See LICENSE.