OpenClaw Agent Builder

A tool that creates OpenClaw agents and multi-agent teams through a friendly AI conversation. No forms, no jargon — just describe what you want your helper to do and it handles the rest.

Available as a desktop app (macOS / Windows) or via npx for those who already have Node.js.

Download the desktop app

Grab the latest release for your platform:

• macOS — Download DMG
• Windows — Download EXE Installer

The app checks for updates automatically and will prompt you when a new version is available.

Note: The app is not yet code-signed.

macOS: After dragging the app to Applications, open Terminal and run:

xattr -cr "/Applications/OpenClaw Agent Builder.app"

Then open it normally. Without this, macOS will say the app is "damaged" because it has no code signature.

Windows: SmartScreen will warn on first launch — click "More info" → "Run anyway."

Quick start (npx)

If you have Node.js 18+ installed:

npx openclaw-agent-builder

Or install globally:

npm install -g openclaw-agent-builder
openclaw-agent-builder

Opens at http://localhost:3847. If OpenClaw isn't installed yet, it offers to install it for you.

How it works

1. Connect an AI — Use your Anthropic or OpenAI API key. If you don't have one, step-by-step instructions walk you through getting one (free credit included for Anthropic).

2. Choose your mode — On a fresh install, the wizard goes straight to setting up your main agent. On an existing install, choose to add a new specialist or rebuild your main agent.

3. Have a conversation — The AI asks you plain-English questions about what your helper should do. No technical knowledge needed. It recommends relevant skills (Spotify, GitHub, Home Assistant, etc.) as it learns what you're building.

4. Review the spec — See exactly what was captured before anything is written to disk.

5. Generate files — Creates all workspace markdown files for your agent(s).

6. Set up capabilities — Choose a memory model (vector/LanceDB, lightweight/Core, or none), enable web search or browsing, connect Home Assistant or Google Places, and set per-agent tool restrictions.

7. Connect a channel — Step-by-step Discord bot setup (5 minutes) or Telegram bot setup (2 minutes). Skip and configure later if you prefer.

8. Validate — Shows a setup summary (what was configured, what still needs doing manually) and optionally runs openclaw doctor to confirm everything is correct.

9. Chat with your agent — Test your agent's personality and responses directly before going live. Start the gateway with one click (or copy the openclaw gateway command) to deploy to Discord/Telegram.

What gets generated

For each agent, in ~/.openclaw/workspace-<id>/ (or ~/.openclaw/workspace/ for the main agent):

| File | Purpose | |------|---------| | SOUL.md | Identity, mission, and hard rules | | AGENTS.md | Session startup checklist and operating rules | | IDENTITY.md | Name, role, personality | | USER.md | Profile of the human the agent serves | | TOOLS.md | Inputs, triggers, and outputs | | BOOTSTRAP.md | First-run startup ritual | | MEMORY.md | Long-term memory template | | memory/README.md | Memory directory conventions | | skills/README.md | Recommended skills with install commands |

For multi-agent teams:

| File | Purpose | |------|---------| | ~/.openclaw/team/TEAM.md | Full team charter | | ~/.openclaw/gateway/openclaw.routing.json5 | Gateway routing fragment |

Requirements

• Desktop app: No prerequisites — just download and run
• npx: Node.js 18+

OpenClaw itself is required for agents to work. The builder will install it if missing.

Development

npm install
npm run dev              # starts at localhost:3847 with Vite hot-reload
npm run build            # builds client into dist/
npm start                # serves production build
npm run electron:dev     # launches the desktop app in dev mode
npm run electron:build   # builds DMG/EXE into release/