Getting Started

Prerequisites

  • Node.js 20+
  • npm 10+
  • Claude Code CLI (optional) — only needed if using the claude-cli provider. Install guide

Installation

git clone https://github.com/swarmclawai/swarmclaw.git
cd swarmclaw
npm install
npm run dev

The dev server starts on 0.0.0.0:3456.

First-Time Setup

On first launch, SwarmClaw generates an access key and prints it to the terminal:

==================================================
  ACCESS KEY: a1b2c3d4e5f6...
  Use this key to connect from the browser.
==================================================

The key is saved to .env.local automatically.

Open http://localhost:3456 in your browser. The first-time setup screen shows your key with a copy button. Copy it, paste it in, and set your name.

Accessing from Mobile

SwarmClaw binds to 0.0.0.0, so any device on your local network can reach it. Find your machine's IP and open:

http://192.168.x.x:3456

Enter the same access key from the terminal.

Default Agent

A default "Assistant" agent is created on first launch using the Claude CLI provider. You can edit it or create new agents from the sidebar.

Next Steps