Skip to content

clawinstaller/claw-installer

Repository files navigation

ClawInstaller

Install OpenClaw in 3 minutes instead of 30.
A native macOS GUI wizard that automates the painful setup process.

Download Stars Downloads Swift 6.0 macOS 14+ MIT License

English · Documentation · Telegram · Threads


ClawInstaller

The Problem

OpenClaw has 257K+ stars and 3.1K open issues. A large chunk are installation problems:

Pain Point % of new user issues ClawInstaller fix
Wrong Node.js version, missing native deps ~35% Auto-detect + one-click fix
Config file confusion (JSON, API keys) ~25% Step-by-step guided wizard
"It installed but won't start" ~15% Smart error diagnosis + fix

We automate the painful first 5 minutes — the stage where most people give up.

Download

Direct Download (Recommended)

Download .dmg from GitHub Releases

Build from Source

git clone https://github.com/clawinstaller/claw-installer.git
cd claw-installer
swift build
swift run ClawInstaller

Requires macOS 14+ (Sonoma), Xcode 15+ or Swift 6.0 toolchain.

Features

Module Status Description
Environment Check Done Node.js >=22, package managers, CPU arch, disk space. One-click fix.
One-Click Install Done Install via npm/pnpm/bun with real-time terminal output
LLM Setup Done Anthropic (OAuth + API key), Google Gemini, Ollama. Detects existing config.
Channel Setup Done Telegram, Discord, WhatsApp — step-by-step with token validation
Skills Install Done Select and install OpenClaw skills with one click
Done + Share Done Installation summary, QR code sharing to Threads/X
Health Monitor Planned Gateway status, daemon controls, log viewer
AI Assistant Planned AI-powered troubleshooting with full install context

How It Works

Welcome -> Preflight -> Install -> LLM Setup -> Channels -> Skills -> Done!
              |                                                         |
         Found issues?                                          Scan QR Code
         One-click fix                                        Share to Threads

Smart Error Handling

Error Auto-Fix
Node.js missing One-click install via Homebrew
Native module build failure One-click Xcode CLI Tools install
Network timeout Retry / switch registry mirror
openclaw command not found PATH auto-detection + fix
Existing LLM config detected Shows current config, option to skip or reconfigure

Pricing

Completely free. No hidden costs, no premium tier.

What Cost
Full install wizard $0
LLM + Channel setup $0
Health monitor $0
AI troubleshooting $0 (free credits, on us)

Community

Contributing

Early stage — all contributions welcome:

  1. Test it on your Mac, report issues
  2. Share pain points about OpenClaw setup
  3. PRs welcome — check open issues

License

MIT


Built by @howardpen9 with OpenClaw agents (Friday, Shuri, Muse)
Independent community project, not affiliated with OpenClaw.

About

macOS GUI 安裝精靈 — 讓 OpenClaw 設定從 30 分鐘 CLI 變成 3 分鐘圖形化體驗 | Swift 6.0 | 繁體中文

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors