GitHub - higress-group/hiclaw: Open-source Agent Teams system with IM-based multi-Agent collaboration and human-in-the-loop oversight.
github.com
Open-source Agent Teams system with IM-based multi-Agent collaboration and human-in-the-loop oversight. - higress-group/hiclaw

I’d like to introduce HiClaw, an open-source Agent Teams system built on OpenClaw. It allows you to deploy a team of AI agents with a Manager coordinating Workers — all visible in your IM.

Key Features

Manager-Agent Architecture

The Manager Agent acts as your AI chief of staff — it creates Workers, assigns tasks, monitors progress, and reports back. You stay in control, making decisions instead of babysitting agents.

You → Manager → Worker Alice (frontend)
              → Worker Bob (backend)
              → Worker ...

Real-Time Collaboration in Matrix Rooms

All communication happens in Matrix Rooms. You see everything, and can intervene anytime — just like messaging a team in a group chat.

Security by Design

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.

Truly Open IM

Built-in Matrix server means no Slack/Feishu bot approval process. Open Element Web in your browser, or use any Matrix client (Element, FluffyChat) on mobile — iOS, Android, Web.

One-Command Installation

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

That’s it! The script sets everything up — Higress AI Gateway, Matrix server, file storage, web client, and Manager Agent itself.

Prerequisites

  • Docker Desktop (Windows/macOS) or Docker Engine (Linux)
  • Minimum: 2 CPU cores and 4 GB RAM
  • Recommended: 4 CPU cores and 8 GB RAM for multiple Workers

Skills Ecosystem

Workers can pull from skills.sh (80,000+ community skills) on demand. Safe to use because Workers can’t access real credentials anyway.

Manager Workflow

The Manager handles the full Worker lifecycle through natural language:

You: Create a Worker named alice for frontend development

Manager: Done. Worker alice is ready.
     Room: Worker: Alice
     Tell alice what to build.

You: @alice implement a login page with React

Alice: On it... [a few minutes later]
     Done. PR submitted: https://github.com/xxx/pull/1

Comparison with OpenClaw Native

Feature OpenClaw Native HiClaw
Deployment Single process Distributed containers
Agent creation Manual config + restart Conversational
Credentials Each agent holds real keys Workers only hold consumer tokens
Human visibility Optional Built-in (Matrix Rooms)
Mobile access Depends on channel setup Any Matrix client, zero config
Monitoring None Manager heartbeat, visible in Room

System Components

  • Higress AI Gateway: LLM proxy, MCP Server hosting, credential management
  • Tuwunel (Matrix): IM server for all Agent + Human communication
  • Element Web: Browser client, zero setup
  • MinIO: Centralized file storage, Workers are stateless
  • OpenClaw: Agent runtime with Matrix plugin and skills

Human-in-the-Loop

Every Matrix Room has you, Manager, and relevant Workers. You can jump in at any point:

You: @bob wait, change password rule to minimum 8 chars
Bob: Got it, updated.
Alice: Frontend validation updated too.

No black boxes. No hidden agent-to-agent calls.

Documentation & Community

Perfect for anyone who wants to deploy AI Agent Teams with full visibility and control. Check it out at: https://github.com/higress-group/hiclaw