whatisgithub

What is hiclaw?

agentscope-ai/hiclaw — explained in plain English

Analysis updated 2026-06-26

4,555GoAudience · developerComplexity · 4/5Setup · moderate

In one sentence

An open-source platform that runs coordinating teams of AI agents inside a Matrix chat room so you can watch every step and intervene when needed, while keeping API credentials secure in a separate gateway.

Mindmap

mindmap
  root((hiclaw))
    What it does
      AI agent teams
      Chat room interface
      Human oversight
    Architecture
      Manager agent
      Worker agents
      AI gateway
    Security
      Credential isolation
      Limited tokens
      No key leakage
    Deployment
      Single install script
      Kubernetes Helm
      Matrix server
    Tech
      Go
      Matrix
      Kubernetes
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a team of AI agents that plan and execute multi-step tasks while you watch every message in a chat room.

USE CASE 2

Deploy a self-hosted AI collaboration environment on macOS or Linux with a single installer command.

USE CASE 3

Connect any OpenAI-compatible LLM to HiClaw without exposing your API keys to the worker agents.

USE CASE 4

Deploy HiClaw on Kubernetes for production use with multiple simultaneous agent teams.

What is it built with?

GoMatrixKubernetesDocker

How does it compare?

agentscope-ai/hiclawcharmbracelet/freezeergo-services/ergo
Stars4,5554,5574,553
LanguageGoGoGo
Setup difficultymoderateeasymoderate
Complexity4/51/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Single install script handles all components, requires 2 CPU cores and 4 GB RAM minimum, with 4 cores and 8 GB recommended for multiple Workers.

So what is it?

HiClaw is an open-source platform for running teams of AI agents that coordinate with each other and with human users, all inside a chat room interface. Instead of running AI agents in the background where you cannot see what they are doing, HiClaw places you in the same room as the agents so you can watch every message, step in at any point, or redirect them when something goes wrong. The architecture separates agents into a Manager and multiple Workers. The Manager handles overall task planning and delegates subtasks to Workers. Workers are specialized agents that can write and run code, answer questions, or take other actions depending on which runtime they use. HiClaw supports multiple agent runtimes in the same room, including options called OpenClaw, QwenPaw, and Hermes, each suited to different kinds of tasks. The chat layer runs on Matrix, an open messaging protocol that you can host yourself. The Element web client is included and connects to a built-in Matrix server, so there is no dependency on Slack, DingTalk, or any external messaging service. All communication between agents and humans happens through this interface, making the collaboration visible and auditable. On the security side, real API keys and credentials stay inside an AI gateway component. The Worker agents only receive limited-scope consumer tokens, so they cannot access or leak the underlying credentials even if they are given malicious instructions. Installation is a single command that runs an installer script on macOS, Linux, or Windows. The script sets up the AI gateway, Matrix server, file storage, web client, and Manager Agent automatically. A Kubernetes Helm chart is available for shared or production deployments. Minimum requirements are 2 CPU cores and 4 GB of RAM, with 4 cores and 8 GB recommended when running multiple Workers. The project works with any OpenAI-compatible LLM API.

Copy-paste prompts

Prompt 1
Walk me through installing HiClaw on my Linux machine and running my first multi-agent task in the chat room.
Prompt 2
How do I add a new Worker agent in HiClaw and give it a specialized role like code execution or web search?
Prompt 3
How does HiClaw's AI gateway prevent worker agents from accessing or leaking my actual API keys?
Prompt 4
How do I deploy HiClaw on Kubernetes using the Helm chart and what are the minimum resource requirements?
Prompt 5
How do I connect HiClaw to a self-hosted Ollama instance using its OpenAI-compatible API?

Frequently asked questions

What is hiclaw?

An open-source platform that runs coordinating teams of AI agents inside a Matrix chat room so you can watch every step and intervene when needed, while keeping API credentials secure in a separate gateway.

What language is hiclaw written in?

Mainly Go. The stack also includes Go, Matrix, Kubernetes.

How hard is hiclaw to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is hiclaw for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.