
1. HiClaw 本地安装前先搞清楚它到底解决什么问题如果你最近在折腾 OpenClaw大概率遇到过这几个场景每个 Agent 都要单独配一份 API KeyGitHub PAT 和 LLM Key 散落在不同目录里一个 Agent 又写前端又写后端还兼文档skills/目录越堆越乱MEMORY.md里各种记忆混在一起每次加载都塞进一堆无关上下文想给 SubAgent 手动分配任务、手动同步进度结果自己成了 Agents 的“保姆”。HiClaw 就是冲着这些痛点来的。HiClaw 可以理解为 Team 版的 OpenClaw核心是在 OpenClaw 基础上引入了一个 Manager Agent 角色。它不直接干活而是帮你管理 Worker Agent 团队。你可以只用 Manager 处理简单问答也可以让 Manager 把复杂任务拆解后分派给专业 Worker每个 Worker 有独立的 Skills 和 Memory技能和记忆完全隔离不会互相污染。对想快速体验 OpenClaw 团队协作能力的开发者来说HiClaw 的价值在于它把 LLM 接入、消息服务器、共享文件系统这些原本需要自己拼装的组件做成了 All-in-One 打包。原生 OpenClaw 像一台组装电脑你得自己买显卡、显示器再装驱动HiClaw 更像一台开箱即用的笔记本开机就能干活。这篇就聚焦本地安装给出可复制的命令、依赖清单和启动验证步骤并说明怎么通过 TaoToken 统一 Key/API 通道完成模型接入最后用一次团队任务协作演示验证安装成功。安装前你需要准备的东西不多一台能跑 Docker 的机器macOS、Linux、Windows 都行Docker 版本建议 20.10 以上至少 4GB 可用内存以及一个可用的 LLM API Key。HiClaw 的安装脚本会把 Higress AI Gateway、Tuwunel Matrix Server、Element Web、MinIO 这些组件都封装进容器屏蔽操作系统差异所以真正需要你手动填的配置很少。下面按步骤来。2. TaoToken 前置准备统一 Key 与 API 通道在跑安装脚本之前先把模型接入这条链路理清楚。HiClaw 的 LLM 接入走的是 Higress AI Gateway一个入口可以切换不同模型供应商凭证集中管理API Key 只需要配置一次所有 Agent 共享。Worker 只拿到调用权限永远接触不到真实的 API Key。这个设计对本地安装很友好因为你不用在每个 Worker 里重复填 Key。我这边习惯用 TaoToken 作为统一的模型通道原因是它把 Key 管理和 API 入口收敛到一处配合 HiClaw 的 Gateway 用起来比较顺。你需要先拿到一个可用的 API Key然后确认 Base URL 指向https://taotoken.net/api。注意这个地址不带任何查询参数配置时直接填这个就行。具体操作上先到 TaoToken 控制台创建一个 API Key。打开 API Keys 页面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite登录后点创建把生成的 Key 复制下来后面安装脚本会用到。如果你还没决定用哪个模型可以先到模型对话页面https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite试一下不同模型的响应风格再决定 Manager 和 Worker 分别用哪个。这里有个关键点HiClaw 的 Manager 和 Worker 可以按任务分配不同模型。比如代码开发任务用能力强的模型信息收集任务用轻量模型成本能差出好几倍。TaoToken 的好处是同一个 Key 可以调用多个模型你在 Higress Console 里切换模型供应商时不用换 Key只改 Model ID 就行。所以前置准备其实就三件事拿到 Key、确认 Base URL、想好 Manager 和 Worker 的模型分配策略。如果你打算长期跑编码类或 Agent 类任务可以顺手看一下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite它针对长时间编码场景做了额度优化比按量计费更适合持续跑 Worker 的情况。接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite里面有 Base URL、Key、Model ID 三件套的完整说明配置前扫一眼能少踩坑。3. 可复制配置安装命令与 Gateway 接入片段先把安装命令跑起来。macOS / Linux 用这条bash (curl -sSL https://higress.ai/hiclaw/install.sh)Windows 用 PowerShell 7Set-ExecutionPolicy Bypass -Scope Process -Force; Invoke-Expression ((New-Object System.Net.WebClient).DownloadString(https://higress.ai/hiclaw/install.ps1))这个脚本会做几件事检测你的时区自动选择最近的镜像仓库用 Docker 拉起所有组件然后提示你输入 LLM API Key。安装完成后你会看到几个关键端口Higress Gateway 在 18080Higress Console 在 18001Element Web 也在 18080MinIO 在 9000 和 9001。浏览器访问http://127.0.0.1:18080就能打开 Element Web 登录对话。接下来是重点把 TaoToken 的模型通道接进 Higress AI Gateway。安装脚本跑完后打开 Higress Consolehttp://127.0.0.1:18001找到 AI Gateway 的模型供应商配置。如果你更习惯直接改配置文件HiClaw 的 Gateway 配置走的是 Higress 的标准格式可以在容器挂载的配置目录里找到对应的 YAML。下面给一个可复制的配置片段把 TaoToken 作为 OpenAI 兼容供应商接进去providers: - name: taotoken type: openai baseUrl: https://taotoken.net/api apiKey: ${TAOTOKEN_API_KEY} models: - id: claude-sonnet-4-20250514 name: Claude Sonnet - id: gpt-4o-mini name: GPT-4o mini如果你用的是 JSON 格式的配置部分版本走 settings 风格对应片段是这样{ provider: taotoken, baseUrl: https://taotoken.net/api, apiKey: sk-你的Key, modelId: claude-sonnet-4-20250514, fallbackModelId: gpt-4o-mini }这里的三件套要记牢Base URL 填https://taotoken.net/apiKey 填你在控制台创建的那串Model ID 填具体模型标识。Manager 建议用能力强的模型Worker 可以按任务类型分配比如信息收集类 Worker 用轻量模型。配置保存后Higress Gateway 会热加载不需要重启整个 HiClaw。如果你在配置里用了环境变量${TAOTOKEN_API_KEY}记得在启动容器时通过-e传入或者在.env文件里定义。HiClaw 的安装脚本默认会把配置写到用户目录下的隐藏文件夹你可以用docker inspect找到实际挂载路径。改完配置后在 Console 里点一下测试连接确认 Gateway 能正常拉到模型列表再进行下一步。4. 验证请求从启动到团队任务协作演示配置接好后先做一次最小验证。打开浏览器访问http://127.0.0.1:18080用安装时显示的用户名和密码登录 Element Web。你会看到一个名为 Manager 的对话。先发一条简单消息测试模型通道是否通你好帮我确认一下当前使用的模型和可用工具如果 Manager 正常回复说明 TaoToken 的 Key、Base URL、Model ID 三件套都生效了。如果没回复先看 Higress Console 的日志大概率是 Key 或 Base URL 填错排查方法放在下一节。接下来创建第一个 Worker。在 Manager 对话里输入帮我创建一个前端 Worker名字叫 aliceManager 会自动完成配置、技能分配并在 Matrix 里拉起一个项目群。然后给一个真实任务启动项目一个简单的待办事项 Web 应用alice 负责前端你负责协调Manager 会拆解任务、分配给 alice并在群里同步进度。你可以在 Element Web 里看到 Manager 和 alice 的完整协作过程所有消息都在同一个 Room 里全程透明。如果发现问题直接 alice 就能介入修正。想验证移动端下载 FluffyChatiOS、Android、全平台都有登录时选“其他服务器”填入你的 Matrix 服务器地址安装时显示的地址通常是http://你的IP:18080用同样的账号登录就能在手机上查看 Worker 进度。这一步能验证 HiClaw 内置的 Tuwunel Matrix Server 是否正常工作。最后做一次完整验证让 Manager 创建一个后端 Worker分配一个依赖前端的任务观察两个 Worker 是否通过 MinIO 共享文件系统交换中间产物而群聊里只保留有意义的沟通和决策记录。如果群聊上下文没有因为文件交换而膨胀说明 MinIO 共享文件系统接好了。到这里本地安装和模型接入就算跑通了。5. 本篇常见错排查401、local proxy failed 与 reading choices安装和接入过程中最容易卡在几个报错上逐个说。401 Unauthorized这个最常见基本是 Key 或 Base URL 的问题。先确认你在 Higress Console 里填的 Base URL 是https://taotoken.net/api注意结尾没有多余的斜杠也没有带任何查询参数。然后确认 Key 没有多余空格复制时别把换行带进去。如果用的是环境变量用docker exec进容器echo $TAOTOKEN_API_KEY看一下实际值。还有一种情况是 Key 权限不对到 TaoToken 控制台确认这个 Key 有对应模型的调用权限。local proxy failed这个报错通常出现在 Gateway 转发阶段说明 Higress 到上游的连接没建立起来。先检查容器网络docker ps看 Higress Gateway 容器是否正常运行。然后确认你的机器能访问https://taotoken.net/api可以用curl -I https://taotoken.net/api测一下连通性。如果容器里访问不了但宿主机能访问多半是 Docker 网络配置问题检查一下容器的 DNS 设置。另外确认没有其他进程占用 18080 或 18001 端口。reading choices 相关报错这个一般出现在模型返回格式解析阶段说明请求发出去了但响应结构不符合预期。先确认 Model ID 填对了不同模型的响应字段名可能不一样。如果你在配置里同时写了modelId和fallbackModelId确认两个都是有效模型。还有一种情况是请求超时导致响应被截断可以在 Gateway 配置里把超时时间调大比如从默认的 30 秒调到 120 秒。OAuth 相关报错如果你在 Element Web 登录时遇到 OAuth 问题先确认用的是安装时显示的用户名和密码而不是自己注册的账号。HiClaw 的 Tuwunel Matrix Server 在安装时会自动创建管理员账号密码在安装输出里。如果密码丢了可以重新跑一次安装脚本或者进容器重置。移动端 FluffyChat 登录时选“其他服务器”填的地址要和 Element Web 一致协议头别漏。Worker 不响应如果 Manager 正常但 Worker 没反应先看 Worker 容器是否启动。docker ps里应该能看到对应的 Worker 容器。然后检查 Worker 的 Consumer Token 是否有效这个 Token 是 Manager 自动分配的一般不用手动改。如果 Worker 一直卡住在群里 Manager 让它检查 Worker 状态Manager 有 Heartbeat 自动监工机制能发现卡住的 Worker 并提醒你。6. 接入完成后怎么把 HiClaw 用顺安装跑通只是第一步真正用起来还有几个习惯值得养成。第一Manager 和 Worker 的模型分配别一刀切。代码开发类任务用能力强的模型信息收集、格式整理类任务用轻量模型成本能差出好几倍。TaoToken 同一个 Key 可以调多个模型你在 Higress Console 里按 Worker 角色配不同 Model ID 就行。第二善用 MinIO 共享文件系统。Agent 之间的大量协作比如文件交换、代码片段、临时数据都走 MinIO不要往群聊里发。这样群聊上下文始终保持在合理规模不会因为文件交换迅速膨胀。你可以在 Manager 对话里明确要求“中间产物走共享文件系统群聊只发决策和结果”。第三移动端接入用 FluffyChat 或 Element Mobile登录时选“其他服务器”填 Matrix 地址。这样你不在电脑前也能随时查看进度、随时干预。HiClaw 内置的 Matrix Server 不需要申请飞书或钉钉机器人省掉了审批流程。如果你打算长期跑团队协作任务可以到 Coding Plan 页面https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite看一下额度方案比按量计费更适合持续跑 Worker 的场景。接入过程中遇到配置问题先翻接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteBase URL、Key、Model ID 三件套的说明都在里面。需要新建或管理 Key 就去 API Keys 页面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite。想先试试不同模型的手感模型对话页面https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite可以直接开聊。最后提醒一句HiClaw 的 Worker 运行在完全隔离的容器里不持有任何真实凭证这是它相对原生 OpenClaw 最大的安全改进。所以配置时别图省事把真实 Key 直接塞进 Worker 的环境变量走 Gateway 代理才是正确姿势。安装脚本默认就是这么设计的你只要把 TaoToken 的 Key 配在 Gateway 层Worker 那边什么都不用改。