HiClaw 完整部署教程：5分钟搭建你的 AI 开发团队（Team 版 OpenClaw）

HiClaw 完整部署教程5分钟搭建你的 AI 开发团队Team 版 OpenClaw导语你用过 OpenClaw 的单 Agent 模式HiClaw 就是它的团队升级版——Manager 负责派活Worker 负责干活你只需要给需求。本文从架构原理到全平台部署手把手带你搭建一套开箱即用的 AI 多智能体协作系统。目录HiClaw 完整部署教程5分钟搭建你的 AI 开发团队Team 版 OpenClaw一、HiClaw 是什么1.1 一句话定义1.2 为什么需要 HiClaw1.3 核心技术栈二、架构深度解析2.1 Manager Worker 团队模型2.2 Higress AI 网关安全的关键2.3 Matrix 群聊协作机制三、环境准备3.1 硬件要求3.2 软件依赖3.3 API Key 准备四、安装方式一交互式脚本推荐新手4.1 macOS / Linux 安装4.2 Windows 11 安装4.3 交互式配置选项详解4.4 安装成功标志五、安装方式二源码克隆高级用户5.1 克隆仓库5.2 最简安装必须提供 API Key5.3 非交互式安装适合自动化脚本5.4 完整环境变量参考六、安装方式三阿里云计算巢云端 3 分钟部署6.1 进入部署页面6.2 填写部署参数6.3 确认并创建6.4 获取访问地址七、首次登录与初始化配置7.1 配置 hosts 文件本地部署必须7.2 登录 Element Web7.3 确认 Manager 已在线7.4 访问管理控制台八、核心功能创建与管理 Worker 团队8.1 创建第一个 Worker8.2 创建多 Worker 协作团队8.3 下达任务8.4 查看工作成果九、进阶Higress 控制台配置9.1 管理 API Key9.2 多模型路由9.3 Token 用量监控十、升级与卸载10.1 升级到最新版本10.2 升级到指定版本10.3 日常运维命令源码安装十一、常见问题排查Q1容器无法启动Q2Element Web 无法访问Q3Manager 不回复消息Q4Windows 下安装卡住或乱码Q5Worker 创建失败Q6文件无法同步到 MinIO十二、实战演练46分钟零代码开发一个网页游戏12.1 任务描述12.2 Manager 自动拆解任务12.3 执行过程约 46 分钟12.4 成果十三、与 OpenClaw 对比什么时候选 HiClaw十四、总结参考资料一、HiClaw 是什么1.1 一句话定义HiClaw Team 版 OpenClaw。如果说 OpenClaw 是一名万能员工那 HiClaw 就是一个分工明确的开发团队——有人管项目、有人写代码、有人跑测试你只需要做决策。1.2 为什么需要 HiClaw用过 OpenClaw 的同学可能有这些感受痛点表现单 Agent 上下文膨胀任务越来越长Token 消耗爆炸无法并行工作写代码和跑测试只能串行凭证安全隐患API Key 直接暴露给 Agent有泄漏风险配置门槛高从安装到用起来可能要半天某鱼甚至有付费安装服务HiClaw 一次性解决了上面所有问题。1.3 核心技术栈HiClaw 是一个开源的协作式多智能体运行平台。让多个 Agent 在一个受控、可审计的房间中协作人类全程可见、随时可介入。 采用 Manager-Workers 架构Manager 统一调度多个 Workers专注于企业内的人和 Agent、Agents 之间的协作场景。HiClaw 并不和其他 xxClaw 对标自己不实现 Agent 逻辑而是编排和管理多个 Agent 容器Manager 和众多 Workers。‍ 设计了 Manger-Workers 架构不用真人去管理每个干活的 Worker Claw实现由 Agent 管理 Agents。 每个 Agent 支持自定义OpenClaw、Copaw、NanoClaw、ZeroClaw 以及企业自建的 Agent从养虾到开虾场提供 worker 和 Team 模板市场。 引入 MinIO 共享文件系统用于 Agent 之间的信息共享大幅降低多 Agent 协作带来的 Token 消耗。⛑️ 引入 Higress AI Gateway流量入口和各类凭证风险降低了减少了用户对原生龙虾在安全上的顾虑。 使用 Element IM 客户端Tuwunel IM 服务器均基于 Matrix 实时通信协议节省钉钉、飞书 IM 的接入和企业内的审批成本方便用户快速体验在 IM 的交互环境中体验模型服务的爽感同时支持以 OpenClaw 原生的方式接入 IM。二、架构深度解析理解架构是高效使用和排查问题的前提花 3 分钟值得。2.1 Manager Worker 团队模型用户 │ ▼ 自然语言指令 ┌─────────────────────────────────┐ │ Manager Agent │ │ (项目管理 任务调度 监控) │ └─────────────────────────────────┘ │ │ ▼ ▼ ┌────────────┐ ┌────────────┐ │ Worker A │ │ Worker B │ ...更多 Worker │ (前端开发) │ │ (后端开发) │ └────────────┘ └────────────┘ │ │ └─────┬──────┘ ▼ Matrix 群聊共享上下文 │ ▼ MinIO共享文件系统Manager 核心职责接收用户需求自动拆解为子任务创建并管理 Worker 生命周期Heartbeat 监控定期检查 Worker 状态卡顿自动告警防惊群设计只有被 的 Worker 才触发 LLM 调用节省 TokenWorker 核心职责专注执行具体任务代码/测试/文档/部署…通过 Higress 网关调用外部服务不持有真实 API Key在 Matrix 群聊中接收任务、上报进度2.2 Higress AI 网关安全的关键这是 HiClaw 相比普通 OpenClaw 最重要的安全升级传统 OpenClaw 用户 API Key → 直接写入 Agent 配置 → 存在泄漏风险 HiClaw 用户 API Key → 统一存储在 Higress 网关 │ ▼ Worker 持有消费令牌 → 通过网关代理调用 LLM 消费令牌有时效、有权限限制、不暴露真实 Key即便 Worker 被攻击攻击者拿到的也只是消费令牌无法获取真实 API Key。2.3 Matrix 群聊协作机制HiClaw 用 Matrix 协议而不是专有 IM实现多 Agent 协作所有 Worker 和 Manager 在同一 Matrix 房间信息自动同步 机制只有被提及的 Worker 才会被激活避免无效 LLM 调用多端兼容Element Web、FluffyChat 等客户端均可访问自建服务无需依赖第三方 IM 平台数据完全自主可控三、环境准备3.1 硬件要求配置最低推荐多 Worker 场景CPU2 核4 核内存4 GB8 GBOpenClaw 运行时内存较高磁盘20 GB50 GB存储 Docker 镜像 MinIO 数据网络可访问 Docker Hub同左3.2 软件依赖工具版本要求说明Docker Desktop / Docker Engine最新稳定版所有服务都跑在容器里PowerShell7.5 (Windows)运行安装脚本WSL 22.6 (Windows)Windows 下 Docker 底层依赖⚠️重要提醒官方镜像不支持虚拟机ECS/云桌面上的 Windows 系统。如果在虚拟机中部署请使用 Linux推荐带图形界面的 Ubuntu。3.3 API Key 准备HiClaw 支持任何 OpenAPI 协议兼容的大模型不支持 Anthropic 协议。推荐选项提供商推荐模型获取地址适用场景阿里云百炼qwen3.5-plusCodingPlanbailian.aliyun.com首选快速安装模式默认支持DeepSeekdeepseek-chatplatform.deepseek.com性价比极高兼容 OpenAPIOpenAIgpt-4oplatform.openai.com最强代码能力本地模型Ollama qwen2.5ollama.ai完全内网无 Token 费用四、安装方式一交互式脚本推荐新手4.1 macOS / Linux 安装打开终端执行一行命令bash(curl-sSLhttps://higress.ai/hiclaw/install.sh)4.2 Windows 11 安装Windows 需先确保 Docker Desktop、PowerShell 7、WSL 2 已安装。Step 1安装 Docker Desktop官网下载 Docker Desktop for Windows安装时勾选“使用 WSL 2 而不是 Hyper-V”安装完成后重启电脑。Step 2升级 WSL不要用系统自带的wsl --update很慢直接下载最新 MSI 包安装# 检查当前 WSL 版本wsl--version# 如果版本低于 2.6手动下载并安装 wsl.2.x.x.x64.msi# https://github.com/microsoft/WSL/releasesStep 3安装 PowerShell 7PowerShell 5.x 执行脚本可能有编码问题建议升级到 PowerShell 7下载地址https://github.com/PowerShell/PowerShell/releases 安装包PowerShell-7.x.x-win-x64.msi 安装完成后桌面搜索PowerShell 7打开Step 4运行 HiClaw 安装脚本以管理员身份打开 PowerShell 7执行Set-ExecutionPolicyBypass-ScopeProcess-Force;$wcNew-ObjectNet.WebClient;$wc.Encoding[Text.Encoding]::UTF8;iex$wc.DownloadString(https://higress.ai/hiclaw/install.ps1)4.3 交互式配置选项详解脚本会依次询问以下选项以下是推荐配置━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ HiClaw 安装向导 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ [1] 语言选择 → 选 1中文直接回车确认 [2] 安装模式 → 选 1快速开始 - 阿里云百炼 → 推荐所有新手一键搞定默认配置 [3] LLM 提供商 → 选 1阿里云百炼 → 也可选 Other填写兼容 OpenAPI 协议的自定义 Base URL [4] 模型接口百炼专属 → 选 1CodingPlan 接口 → 专为编程和 Agent 任务优化强烈推荐 [5] 模型系列 → 选 1qwen3.5-plus → 默认值后续可在 Matrix 房间中动态切换 [6] API Key → 输入你的阿里云百炼 API Key → 脚本会自动测试连通性 [7] 网络访问模式 → 选 1Local Use Only仅本机 → 如需团队共用选 2Allow External Access [8] GitHub 集成 / 技能库 / 数据持久化 → 均直接回车使用默认值 [9] Worker 运行时 → 选 1OpenClaw功能最全 → 选 2CoPaw内存占用更低推荐内存不足时使用4.4 安装成功标志安装完成后终端会输出类似以下信息✅ HiClaw Manager 已启动 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 访问信息 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 主界面Element Web http://matrix-client-local.hiclaw.io:8080 或 http://127.0.0.1:18088/#/login 管理员账号admin 管理员密码xxxxxxxxxx请妥善保存 Higress 控制台http://localhost:8001或 18001 MinIO 控制台http://localhost:9001 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━密码务必保存后续可通过 Higress 控制台修改但首次登录必须用安装时生成的密码。五、安装方式二源码克隆高级用户适合需要自定义配置、二次开发或 CI/CD 集成的场景。5.1 克隆仓库gitclone https://github.com/higress-group/hiclaw.gitcdhiclaw5.2 最简安装必须提供 API KeyHICLAW_LLM_API_KEYsk-你的APIKeymakeinstall5.3 非交互式安装适合自动化脚本通过环境变量预设所有参数实现真正的一键部署# 最基础配置HICLAW_NON_INTERACTIVE1\HICLAW_LLM_API_KEYsk-xxx\makeinstall# 完整自定义配置示例HICLAW_NON_INTERACTIVE1\HICLAW_LLM_PROVIDERqwen\HICLAW_DEFAULT_MODELqwen3.5-plus\HICLAW_LLM_API_KEYsk-xxx\HICLAW_ADMIN_USERmyadmin\HICLAW_ADMIN_PASSWORDMySecurePass123\HICLAW_PORT_GATEWAY8080\HICLAW_PORT_CONSOLE8001\HICLAW_DATA_DIR/data/hiclaw\makeinstall5.4 完整环境变量参考环境变量说明默认值HICLAW_LLM_PROVIDERLLM 提供商qwenHICLAW_DEFAULT_MODEL默认模型名qwen3.5-plusHICLAW_LLM_API_KEYLLM API Key必填HICLAW_LLM_BASE_URL自定义 API Base URL由 Provider 自动推断HICLAW_ADMIN_USER管理员用户名adminHICLAW_ADMIN_PASSWORD管理员密码自动随机生成HICLAW_PORT_GATEWAYAI 网关端口8080HICLAW_PORT_CONSOLEHigress 控制台端口8001HICLAW_PORT_MATRIXMatrix 服务端口18080HICLAW_PORT_WEBElement Web 端口18088HICLAW_DATA_DIR数据持久化目录~/hiclaw-managerHICLAW_VERSION指定安装版本最新版HICLAW_NON_INTERACTIVE非交互模式0六、安装方式三阿里云计算巢云端 3 分钟部署不想折腾本地环境阿里云计算巢提供一键云端部署3 分钟即可完成。6.1 进入部署页面访问HiClaw 计算巢社区版6.2 填写部署参数参数说明推荐值地域选择离用户近的区域华东 1杭州实例规格ECS 规格ecs.c7.xlarge4 核 8G实例密码ECS 登录密码复杂密码VPC 网络选择已有 VPC 或新建默认新建AI 模型类型大模型接口类型DashScope百炼API Key大模型 API Key你的百炼 AKManager 配置Manager Agent 的模型同网关配置技能库地址OpenClaw 技能注册中心https://skills.sh默认6.3 确认并创建确认费用估算后点击立即创建等待 3-5 分钟系统自动完成所有容器部署。6.4 获取访问地址在计算巢服务实例详情页查看Element Web 客户端地址Higress AI 网关地址管理员初始密码七、首次登录与初始化配置7.1 配置 hosts 文件本地部署必须本地部署后需要配置本地 DNS 解析否则 Matrix 服务相互调用会失败。macOS / Linuxsudotee-a/etc/hostsEOF 127.0.0.1 matrix-local.hiclaw.io 127.0.0.1 matrix-client-local.hiclaw.io 127.0.0.1 aigw-local.hiclaw.io 127.0.0.1 fs-local.hiclaw.io EOFWindows以管理员身份打开 PowerShell$hostsPathC:\Windows\System32\drivers\etc\hosts$entries (127.0.0.1 matrix-local.hiclaw.io,127.0.0.1 matrix-client-local.hiclaw.io,127.0.0.1 aigw-local.hiclaw.io,127.0.0.1 fs-local.hiclaw.io)$entries|Add-Content-Path$hostsPathWrite-Hosthosts 配置完成7.2 登录 Element Web浏览器打开http://matrix-client-local.hiclaw.io:8080 # 或者 http://127.0.0.1:18088/#/login输入安装时生成的admin账号密码登录。7.3 确认 Manager 已在线登录后你会看到 Matrix 聊天界面。找到名为Manager的对话或房间直接发消息测试你好请介绍一下你自己如果 Manager 正常回复说明部署成功 7.4 访问管理控制台各服务的管理界面控制台地址用途Element Web主界面http://127.0.0.1:18088与 AI 团队对话Higress 控制台http://localhost:8001管理 API Key、路由、限流MinIO 控制台http://localhost:9001查看 Worker 生成的文件八、核心功能创建与管理 Worker 团队8.1 创建第一个 Worker在 Matrix 房间向 Manager 发送指令帮我创建一个名叫 Alice 的 Worker她是一名前端开发工程师 擅长 React 和 TypeScript工作目录为 /workspace/frontendManager 会自动创建 Worker 并将 Alice 加入当前房间。8.2 创建多 Worker 协作团队一次性建立完整开发团队帮我组建一个完整的开发团队 - Bob后端工程师Python FastAPI负责 API 开发 - Alice前端工程师React TypeScript负责 UI 实现 - Charlie测试工程师pytest Playwright负责质量保障 - DaveDevOps 工程师Docker Nginx负责部署上线8.3 下达任务Bob Alice 我需要一个用户登录功能 - 后端Python FastAPI支持邮箱密码JWT Token 认证bcrypt 加密 - 前端React 实现登录页面包含表单验证和错误提示 - 两人协调好接口设计完成后汇报Manager 会自动拆解任务到子任务分配给 Bob 和 Alice在群聊中协调接口定义监控进度发现卡顿自动告警8.4 查看工作成果# 进入 MinIO 控制台查看文件http://localhost:9001# 账号/密码安装时自动配置可在 docker-compose.yml 中查看所有 Worker 生成的代码、文档、测试报告都会同步到 MinIO可以直接下载。九、进阶Higress 控制台配置9.1 管理 API Key进入 Higress 控制台http://localhost:8001在AI 消费者模块添加真实 API Key如百炼sk-xxx系统自动生成对应的消费令牌分配给 WorkerWorker 持有消费令牌调用 LLM真实 Key 不外露9.2 多模型路由在 Higress 控制台配置多个 LLM 提供商实现按任务分配模型# 示例为不同 Worker 配置不同模型routes:-match:/v1/chat/completionsconsumer:worker-alice# 前端 Workerbackend:qwen3.5-plus# 通义千问便宜-match:/v1/chat/completionsconsumer:worker-bob# 后端 Workerbackend:gpt-4o# GPT-4o强代码9.3 Token 用量监控Higress 控制台内置 Token 用量统计可以查看各 Worker 的 Token 消耗每日/每月总用量费用估算十、升级与卸载10.1 升级到最新版本运行与安装相同的命令脚本会自动检测到已安装并询问升级方式# macOS/Linuxbash(curl-sSLhttps://higress.ai/hiclaw/install.sh)# Windows PowerShell 7Set-ExecutionPolicy Bypass-ScopeProcess -Force;$wcNew-Object Net.WebClient;$wc.Encoding[Text.Encoding]::UTF8;iex$wc.DownloadString(https://higress.ai/hiclaw/install.ps1)升级选项原地升级 (In-place Upgrade)保留所有数据和配置全新重装 (Fresh Re-installation)删除所有数据全新安装10.2 升级到指定版本HICLAW_VERSIONv1.0.5bash(curl-sSLhttps://higress.ai/hiclaw/install.sh)10.3 日常运维命令源码安装cdhiclaw# 发送任务给 Manager命令行方式makereplayTASK帮我分析 /workspace/src 目录的代码结构# 查看对话日志makereplay-log# 重启所有容器dockercompose restart# 查看容器运行状态dockercomposeps# 查看某个容器的实时日志dockerlogs-fhiclaw-manager-agent# 卸载 HiClaw保留数据makeuninstall# 完全清理删除容器和镜像makeclean十一、常见问题排查Q1容器无法启动症状docker compose ps显示某个容器 Exit排查步骤# 查看所有容器状态dockerps-a|grephiclaw# 查看 Manager Agent 日志dockerlogs hiclaw-manager-agent# 查看详细内部日志dockerexec-ithiclaw-manager-agentcat/var/log/hiclaw/manager-agent.logQ2Element Web 无法访问症状浏览器打开http://127.0.0.1:18088提示连接失败排查步骤# 1. 确认 hosts 配置正确cat/etc/hosts|grephiclaw# macOS/LinuxGet-ContentC:\Windows\System32\drivers\etc\hosts|Select-Stringhiclaw# Windows# 2. 检查端口是否被占用lsof-i:18088# macOS/Linuxnetstat-ano|findstr :18088# Windows# 3. 确认容器正常运行dockerps|grepelementQ3Manager 不回复消息症状在 Matrix 房间发消息Manager 没有任何响应原因和排查# 最常见原因 1API Key 无效或余额不足# → 进入 Higress 控制台测试 API Key 连通性curl-XPOSThttp://localhost:8080/v1/chat/completions\-HContent-Type: application/json\-HAuthorization: Bearer your-consumer-token\-d{model:qwen3.5-plus,messages:[{role:user,content:hello}]}# 最常见原因 2Manager 容器崩溃dockerlogs hiclaw-manager-agent--tail50# 尝试重启 Managerdockerrestart hiclaw-manager-agentQ4Windows 下安装卡住或乱码解决方案# 确认使用 PowerShell 7不是 5.x$PSVersionTable.PSVersion# 确认 Docker Desktop 在运行docker info# 如果 WSL 版本太低wsl--update# 或手动下载最新 MSI 安装Q5Worker 创建失败症状告诉 Manager 创建 Worker但房间里没有新成员出现# 检查 Worker 运行时日志dockerlogs hiclaw-openclaw# OpenClaw 运行时dockerlogs hiclaw-copaw# CoPaw 运行时# 检查内存是否不足Worker 创建需要额外内存dockerstats --no-streamQ6文件无法同步到 MinIO# 检查 MinIO 容器状态dockerlogs hiclaw-minio# 验证 MinIO 可访问curlhttp://localhost:9001/minio/health/live十二、实战演练46分钟零代码开发一个网页游戏以下是 HiClaw 真实使用记录展示 AI 团队自动完成完整开发流程。12.1 任务描述向 Manager 发送 开发一个 1024 网页游戏完成后部署到服务器的 9999 端口 确保可以用键盘方向键和触摸操作支持移动端。12.2 Manager 自动拆解任务Manager 接收需求后自动1. 创建 web-dev Worker前端开发 2. 创建 devops Worker运维部署 3. 给 web-dev 分配游戏开发任务 4. 给 devops 分配部署任务等 web-dev 完成后 5. 协调两个 Worker 的工作交接12.3 执行过程约 46 分钟阶段执行者耗时产出需求拆解Manager2 分钟任务分配方案核心逻辑开发web-dev20 分钟game.js移动逻辑合并算法UI 实现web-dev10 分钟index.html style.css触摸/键盘优化web-dev5 分钟事件监听完善服务器部署devops8 分钟Nginx 配置 端口验证最终验证Manager1 分钟访问测试报告12.4 成果游戏地址http://localhost:9999 功能清单 ✅ 键盘方向键控制↑↓←→ ✅ 触摸滑动支持移动端 ✅ 数字合并动画效果 ✅ 分数实时统计 ✅ 游戏结束检测 人工预估时间7.5 小时 实际完成时间46 分钟 效率提升~90%十三、与 OpenClaw 对比什么时候选 HiClaw场景OpenClawHiClaw单人使用简单任务✅ 更轻量杀鸡用牛刀复杂项目多任务并行受限✅ Manager 自动调度团队共用同一套 AI需自行搭建✅ 开箱支持多用户API Key 安全管理⚠️ 需自行处理✅ Higress 统一管理企业内网私有化部署✅ 支持✅ 支持5 分钟快速上手⚠️ 配置繁琐✅ 一键安装选 HiClaw 的核心理由任务复杂度超过单 Agent 能处理的范围需要多 Worker 并行工作缩短完成时间有 API Key 安全合规要求团队多人共用需要权限管理十四、总结HiClaw 的核心价值在三个字降门槛。部署门槛从半天配置到 5 分钟一键安装使用门槛从写复杂 Prompt 到自然语言下指令安全门槛从 API Key 裸露到 Higress 统一管理对于想把 AI 真正用于生产的团队来说HiClaw 提供了一个已经把底层复杂度封装好的起点——你不需要懂 Matrix 协议不需要手写 Docker Compose不需要搭 MinIO。这些都在那个install.sh里帮你做了。剩下的就是想清楚你的 AI 团队要做什么。参考资料HiClaw 官方文档HiClaw GitHub 仓库HiClaw 快速入门阿里云计算巢部署Higress AI Gateway 文档OpenClaw 官方文档TagsHiClawOpenClaw多智能体Multi-AgentAI开发团队HigressMatrixDocker部署教程作者圣殿骑士 |更新时间2026-04-09