Open Source|Powered by Matrix

Open Source Multi-Agent OS

Let multiple AI Agents collaborate in Matrix rooms, fully visible to humans, with real-time intervention capability. Manager Agent coordinates multiple Worker Agents to complete complex tasks.

Fast-track your OPOC (One Person One Company) and enterprise digital workforce.

terminal
# Quick install (interactive)
$ bash <(curl -sSL https://higress.ai/hiclaw/install.sh)
# Or clone and install
$ git clone https://github.com/alibaba/hiclaw.git && cd hiclaw
$ HICLAW_LLM_API_KEY="sk-xxx" make install

Why HiClaw?

Featuring enterprise-grade security and designed specifically for multi-agent collaboration, enabling AI agent teams to work together as efficiently as human teams

Enterprise Security

Workers never hold real API keys or GitHub PATs. They only carry a consumer token (like a badge). Even a compromised Worker can't leak your credentials.

Multi-Agent Collaboration

Manager Agent intelligently decomposes tasks and coordinates multiple Worker Agents for parallel execution, significantly improving complex task handling.

Matrix Protocol

Built on the open Matrix IM protocol, all Agent communications are transparent and auditable, with native support for distributed deployment and federation.

Human Supervision

Humans can enter any Matrix room at any time to observe Agent conversations, intervene or correct Agent behavior in real-time, ensuring safety and control.

Manager-Worker Architecture

Clear two-tier Manager-Worker architecture with distinct responsibilities, easy to extend with custom Worker Agents for different scenarios.

Fully Open Source

Completely open source, community-driven development, no vendor lock-in, supports local private deployment with full data sovereignty.

System Architecture

Matrix-based collaboration hub with Higress AI Gateway providing a security and governance layer — agents never hold real credentials.

HiClaw System Architecture

Collaboration Hub (Matrix Based)

Manager Agent orchestrates Control Flow, Worker Agents handle Task Flow, all communicating through a central Matrix Server with end-to-end encryption. Humans observe via Matrix Client.

Security & Governance Layer

Credentials pass-through and secure API proxy ensure no keys are held by agents. Even a compromised Worker cannot leak your credentials.

Higress AI Gateway

Central gateway providing secure external API access to LLM providers (Qwen, Claude, OpenAI, local models) and external APIs / MCP Servers / Skills.

Quick Start

One command to install. The script asks for your LLM API key, then sets everything up.

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

When it's done:

=== HiClaw Manager Started! ===
Open: http://127.0.0.1:18088
Login: admin / [generated password]
Tell the Manager: "Create a Worker named alice for frontend dev"

Prerequisites

Docker Desktop (Windows/macOS) or Docker Engine (Linux). That's all.

  • Docker Desktop (Windows / macOS)
  • Docker Engine (Linux) or Podman Desktop (alternative)

The Docker VM needs at least 2 CPU cores and 4 GB RAM. In Docker Desktop, go to Settings → Resources to adjust.