HiClaw

为什么选择 HiClaw？

Matrix 协议：基于成熟的 Matrix 即时通讯标准协议，稳定可靠。

Manager-Workers 架构：清晰的任务分发和执行架构，高效协作。

人类可见可干预：人类可以实时查看代理工作，必要时进行干预。

阿里巴巴出品：经过阿里内部验证的企业级解决方案。

核心功能

$#1.
Matrix 协议集成

• 基于 Matrix 房间实现多代理协作
• 人类和代理在同一房间交流
• 标准化的消息格式
• 跨服务器通信

$#2.
Manager-Workers 架构

• Manager: 任务接收、分解、分配
• Workers: 专业代理，执行具体任务
• 结果汇总: 自动汇总各 Worker 结果
• 质量检查: 审核输出质量

$#3.
人类可见可干预

• 人类可在 Matrix 房间查看代理对话
• 实时监督代理工作
• 必要时介入指导
• 审批关键决策

$#4.
Higress AI 网关

• 统一的 AI 服务入口
• 多模型路由
• 流量管理
• 安全控制

$#5.
Element IM 集成

• Element 客户端支持
• 移动端可用
• 消息加密
• 文件共享

$#6.
多代理房间协作

• 每个任务一个 Matrix 房间
• 代理在房间中协作
• 人类可加入任意房间
• 房间历史记录

$#7.
任务分发系统

• 智能任务分解
• 基于能力分配
• 负载均衡
• 优先级管理

$#8.
审计日志

• 完整协作记录
• 决策过程可追溯
• 合规报告
• 数据分析

$#9.
企业级功能

• 权限管理
• 单点登录 (SSO)
• 审计合规
• 数据隔离

$#10.
阿里云集成

• 阿里云账号集成
• 云资源调用
• 成本优化
• 企业支持

安装方式

方式一：Docker Compose（推荐）

version: '3'
services:
  hiclaw-manager:
    image: registry.cn-hangzhou.aliyuncs.com/higress/hiclaw-manager:latest
    ports:
      - "8080:8080"
    environment:
      - MATRIX_SERVER=https://matrix.example.com
      - OPENCLAW_API_KEY=sk-xxx
    volumes:
      - ./config:/config

  hiclaw-worker:
    image: registry.cn-hangzhou.aliyuncs.com/higress/hiclaw-worker:latest
    environment:
      - MANAGER_URL=http://hiclaw-manager:8080
    deploy:
      replicas: 3

方式二：Kubernetes 部署

# 添加 Helm 仓库
helm repo add higress https://higress.io/helm-charts

# 安装 HiClaw
helm install hiclaw higress/hiclaw \
  --namespace hiclaw-system \
  --create-namespace

方式三：源码编译

git clone https://github.com/higress-group/hiclaw.git
cd hiclaw
mvn clean package
# 部署到应用服务器

配置

Manager 配置 (manager.yaml)

manager:
  port: 8080
  matrix:
    server: https://matrix.example.com
    bot_user: @hiclaw_bot:example.com
    bot_password: xxx
  
  workers:
    max_concurrent: 10
    timeout: 300
    
  ai:
    provider: openai
    model: gpt-4
    api_key: sk-xxx

Worker 配置 (worker.yaml)

worker:
  manager_url: http://manager:8080
  capabilities:
    - code_generation
    - document_analysis
    - data_processing
  
  resources:
    max_memory: 2GB
    max_cpu: 2

使用示例

创建任务

在 Matrix 房间中：
@hiclaw_bot 创建一个新产品发布计划

Manager 会自动：
1. 分解任务为多个子任务
2. 分配给合适的 Workers
3. 协调各 Worker 协作
4. 汇总最终结果

人类干预

人类在房间中：
@hiclaw_bot 这个方案需要调整，预算减少 20%

Manager 会：
1. 理解人类指令
2. 通知相关 Workers 调整
3. 重新生成方案

查看进度

@hiclaw_bot status

返回：
- 任务进度
- 各 Worker 状态
- 预计完成时间

定价

免费：HiClaw 完全免费开源（Apache-2.0 许可证）。成本包括：

• 服务器/云资源费用
• AI API 费用
• Matrix 服务器费用（如自托管则免费）

系统要求

使用场景

多代理团队协作

多个专业 AI 代理协同完成复杂任务。

企业级 AI 代理管理

企业管理和编排大量 AI 代理。

人机协作流程

人类和 AI 代理在同一流程中协作。

复杂任务编排

将复杂任务分解为多个子任务，由不同代理执行。

跨部门 AI 协作

不同部门的 AI 代理协同工作。

AI 代理编排

统一编排和管理 AI 代理工作流程。

社区与支持

• 官方网站: https://higress.ai/
• GitHub: https://github.com/higress-group/hiclaw
• 文档: https://github.com/higress-group/hiclaw#readme
• 阿里云: 可获得企业支持

许可证

Apache-2.0 License - 免费用于个人和商业用途。

标签

multi-agent, alibaba, matrix, collaboration, enterprise, manager-workers, human-in-the-loop

FAQ

Is HiClaw free to use?

Yes, HiClaw is free and open source (Apache-2.0 license). You only pay for AI model API costs if using external models.

What are the system requirements for HiClaw?

HiClaw requires 2GB RAM of RAM minimum, Runtime: Python/Node.js. It runs on Windows, macOS, and Linux.

Can I self-host HiClaw?

Yes. HiClaw is open source (Apache-2.0) and can be self-hosted on your own hardware.

What platforms does HiClaw support?

HiClaw supports popular chat platforms. Check the official documentation for the most up-to-date list of supported platforms.

Is HiClaw suitable for beginners?

HiClaw requires some technical knowledge to set up. If you are a beginner, consider starting with simpler alternatives first.

快速入门指南

几分钟内启动 HiClaw。

选项 A: NPM 安装

# Install via NPM

步骤 3: 配置

按照官方文档配置您的系统。

步骤 4: 开始使用

连接您的平台并开始交互。

首次使用时间: ~5-15分钟，具体取决于安装方式。

完整文档: https://github.com/alibaba/hiclaw#readme

常见问题

HiClaw 免费吗？

是的，HiClaw 是免费的开源软件（Apache-2.0 许可证）。您只需支付 AI 模型 API 的费用。

HiClaw 的系统要求是什么？

HiClaw 需要 2GB RAM, Python/Node.js。它可在 Windows、macOS 和 Linux 上运行。

我可以自托管 HiClaw 吗？

可以。HiClaw 是开源软件（Apache-2.0），可以在您自己的硬件上自托管。

HiClaw 支持哪些平台？

HiClaw 支持流行的聊天平台。请查看官方文档获取最新支持的平台列表。

HiClaw 适合初学者吗？

HiClaw 需要一定的技术知识来设置。初学者应该从更简单的替代方案开始。