HiClaw Quick Start

Deploy your AI Agent team in 5 minutes. One command installs everything — Gateway, Matrix, MinIO, Element Web, and the Manager Agent.

Prerequisites

Step 1: Install HiClaw

macOS / Linux

bash <(curl -sSL https://higress.ai/hiclaw/install.sh)

Windows (PowerShell)

irm https://higress.ai/hiclaw/install.ps1 | iex
Verification: After installation, open http://localhost:18080 in your browser. You should see the Element Web login page.

Step 2: Login to Element Web

  1. Open http://localhost:18080 in your browser
  2. Login with the admin credentials shown in the terminal output
  3. You'll see the Manager's room — this is where you communicate with the HiClaw Manager

Step 3: Create Your First Worker

In the Manager's room, simply type a natural language command:

Create a Worker named alice for frontend development

The Manager will:

  1. Spin up a new Worker container
  2. Register it with the Higress gateway (consumer token + routes)
  3. Create a Matrix account and room for the worker
  4. Push the relevant skills to the worker
  5. Invite you and the worker to a shared room
Verification: You should see a new room named "alice" in your Element Web sidebar. The worker will send a greeting message.

Step 4: Assign a Task

In the shared room with alice, send a task:

alice, please create a landing page for our product with a hero section and feature cards

The worker will begin executing the task, reporting progress in the room. You can watch in real-time as the HiClaw Worker works.

Step 5: Human Intervention

At any point, you can intervene naturally:

alice, stop. Change the hero background to a gradient instead.

The worker will pause, acknowledge your instruction, and adjust its approach. This is the core of HiClaw's human-in-the-loop philosophy — you stay in control.

Next Steps

Multi-Worker Projects

Create multiple workers for different roles and coordinate them on a shared project.

Manager Guide →

Explore Skills

Discover 80,000+ skills from the ecosystem. Extend your workers' capabilities.

See Features →

Understand Security

Learn how HiClaw isolates credentials and protects your infrastructure.

Security Model →

Deep Dive Architecture

Understand the full HiClaw stack: Higress, Matrix, MinIO, and OpenClaw.

Architecture →