Installation
System Requirements
- macOS 12 Monterey or later (Apple Silicon recommended; Intel works)
- 4 GB RAM minimum (8 GB recommended)
- 500 MB free disk space
- An AI provider key (OpenAI, Anthropic, etc.) OR a local model server
Download
Grab the latest macOS build from GitHub Releases.
Direct link: DevClaw-latest.dmg
Install
- Open the downloaded
.dmgfile - Drag DevClaw to your Applications folder
- Eject the disk image
- Launch DevClaw from Applications (or Spotlight)
First launch
On first launch DevClaw will:
- Create
~/.devclaw/(config directory) - Detect any existing VSCode settings and offer to import them
- Prompt you to configure your AI provider
Configuring an AI provider
Open Settings → AI Provider and choose one:
- OpenAI — paste your
sk-...API key - Anthropic — paste your Claude API key
- OpenAI-compatible — point at any local or remote endpoint (Ollama, LM Studio, vLLM, etc.)
- Local model — DevClaw will auto-detect common local servers
Keys are stored in macOS Keychain, not in plain text.
Troubleshooting
"DevClaw can't be opened because it is from an unidentified developer"
Right-click the app in Finder, choose Open, then confirm. macOS will remember your choice for future launches.
Agent windows don't appear
Check Settings → Extensions → make sure the DevClaw Agent extension is enabled. Restart the IDE after toggling.
Build errors with local models
Make sure your local server exposes an OpenAI-compatible endpoint
(/v1/chat/completions). Ollama works out of the box.
Uninstall
rm -rf /Applications/DevClaw.app
rm -rf ~/.devclaw
Project files stay where they are.