ClawMagic Docs

Install on Windows

Get ClawMagic running on Windows. WSL2 is recommended for the smoothest experience.

Recommended: WSL2 + Ubuntu

The easiest path on Windows is WSL2, which gives you a full Linux environment. ClawMagic runs natively in WSL2 with no extra configuration.

# PowerShell (Admin)
wsl --install -d Ubuntu

After WSL installs and Ubuntu opens, follow the Linux install guide.

Native Windows (PowerShell)

Install Node.js 22 and Git:

# PowerShell
winget install OpenJS.NodeJS.LTS
winget install Git.Git

# restart terminal, then verify
node -v   # v20.x or v22.x
npm -v    # 10.x+

Install ClawMagic

git clone https://github.com/clawmagic/clawmagic.git
cd clawmagic

# On native Windows, use the PowerShell installer:
powershell -ExecutionPolicy Bypass -File scripts/install.ps1

# On WSL2, use the bash installer:
bash scripts/install.sh

The installer will prompt you to choose:

1) Mom Setup (default) — Portal + CLI, ~4 min. Opens onboarding in your browser.
2) Quick Install — CLI only, ~2 min. Onboarding runs in the terminal.

If Things Break on Windows

Confirm Node version is 20+ with node -v.
If path or permission issues persist, move to WSL2 for full compatibility.
Run node apps/cli/dist/main.js doctor to diagnose issues.