Files

Selig 4c966a3ad2 Initial commit: OpenClaw Skill Collection

6 custom skills (assign-task, dispatch-webhook, daily-briefing,
task-capture, qmd-brain, tts-voice) with technical documentation.
Compatible with Claude Code, OpenClaw, Codex CLI, and OpenCode.

2026-03-13 10:58:30 +08:00

1.5 KiB

Raw Permalink Blame History

macOS Dev Setup

Prerequisites

The following tools are required:

Xcode 26.2+: Necessary for Swift development
Node.js 22+ & pnpm: Required for the gateway, CLI, and packaging scripts

1. Install Dependencies

pnpm install

2. Build and Package the App

To build the macOS app and package it into dist/OpenClaw.app, run:

./scripts/package-mac-app.sh

If you don't have an Apple Developer ID certificate, the script will automatically use ad-hoc signing instead.

For additional configuration options, see the apps/macos/README.md file in the repository.

Ad-hoc signed apps may trigger security prompts. Immediate crashes with "Abort trap 6" are addressed in troubleshooting.

3. Install the CLI

The app requires a global openclaw CLI installation for background task management.

To install:

Open the OpenClaw app
Navigate to the General settings tab
Click "Install CLI"

Or manually install:

npm install -g openclaw@<version>

Troubleshooting

Build Fails: Toolchain or SDK Mismatch

Verify your toolchain versions:

xcodebuild -version
xcrun swift --version

Update macOS and Xcode if versions don't align.

App Crashes on Permission Grant

Reset TCC permissions:

tccutil reset All bot.molt.mac.debug

Gateway "Starting..." Indefinitely

Check for zombie processes:

openclaw gateway status
openclaw gateway stop
lsof -nP -iTCP:18789 -sTCP:LISTEN

1.5 KiB Raw Permalink Blame History