HiClaw数字员工云上一键部署最佳实践(企业版)

更新时间:
复制为 MD 格式

HiClaw的企业版云上可视化一键部署方案,实现基于阿里云SAE、AI网关、NLB的快速部署并自动接入AI可观测。

涉及产品

方案架构

image

操作步骤

注册阿里云百炼平台

  1. 登录阿里云百炼平台,在密钥管理中创建API Key,后续用于HiClaw的大脑(大模型提供商)。image005

  2. 在百炼平台可以查看阿里云免费额度,后续体验HiClaw默认使用qwen3.5-plus模型按照Tokens进行计费,优先使用免费额度。113

  3. (可选)目前阿里云推出Coding Plan 活动,推荐购买Lite套餐40元/月用来完成本次体验,后续HiClaw默认使用qwen3.5-plus模型按照次数进行计费更划算。image006image007

CADT一键部署

  1. 登录云速搭CADT管理控制台image009

  2. 新建 ->官方解决方案 -> 模板,搜索 HiClaw,选择企业版参考截图点击快速部署image

  3. 填写必填配置后,点击创建方案

    • 区域配置:杭州

      资源配置:采用自动生成的配置即可,无需修改

      部署配置:

      百炼ApiKey来源:选择已有|手动输入

      LLM API Key:自动获取第1章中创建的百炼API Key|手动输入

      默认模型:qwen3.5-plus | kimi-k2.5|etc

  4. 点击下一步:询价1

  5. 核对资源价格无误后,点击部署资源2

    自动部署云资源和自动安装HiClaw,预计需要5~6分钟左右。3

  6. 部署成功后记录必要信息,后续登录HiClaw时需要

    • Web登录地址:xxx

    • Homeserver 地址:xxx

    • 用户名:xxx

    • 密码:xxx

    4

  7. (可选)后续也可以在云速搭的应用 -> 我的应用,查看部署成功信息。image017

    6

  8. (可选)HiClaw登录地址直接使用AI网关的公网域名,存在1000次/天的访问限制,如果作为生产使用推荐在云解析DNS的公网权威解析中进行配置CNAME至访问域名。

    AI网关创建域名官方参考文档:创建域名

    重要

    若配置云解析DNS的公网权威解析域名,则需要修改HiClaw登录的Matrix Server地址为自定义的云解析DNS公网权威域名。

505152

HiClaw 体验

1.登录HiClaw

  1. 推荐Chrome浏览器输入:HiClaw登录页面(第3章步骤6部署成功返回的信息),点击Continue Anyway7

  2. 推荐设置为简体中文,点击登录

    输入用户名和密码(3章步骤6部署成功返回的信息,点击登录8

  3. 输入用户名和密码(2章步骤6部署成功返回的信息,点击登录9

    重要

    如果提示账号密码错误,稍等SAE启动预计需要1~2分钟。

    成功登录,进入Manager房间,开始HiClaw之旅。10

说明

提示:如果提示账号密码错误,稍等SAE启动预计需要1~2分钟。

成功登录,进入Manager房间,开始HiClaw之旅。

2.体验HiClaw

  1. 推荐完成Manager风格设定。121

  2. Manager创建任务:请创建一个差旅助手,用来负责我的行程规划。122点击接受进入差旅助手房间,可以看到Managertravel-assistant的交互过程。123

    重要

    助手(worker)创建后会启动一个SAE应用,预计需要2~3分钟,所以需要等待一会助手(worker)才能执行任务。

  3. Manager创建任务:我需要在03.20~03.24 从北京到上海出差,请帮我制定一份差旅行程安排,包括飞机、酒店等安排,以及费用清单。结果以PDF发送给我,PDF的可读性要好。124

    可以看到Managertravel-assistant的交互过程。125

  4. 经过多次沟通和调整,最终获取一份可读性较好的PDF,一般第一次返回的PDF会存在乱码的可能性,只需告诉Manager进行调整即可。

    126

3.团队HiClaw

在企业级使用中,推荐管理员直接控制和管理Manager,为团队成员分别创建“数字分身”也就是团队成员的个人助理。

  1. 创建任务:帮我创建3个助理,名称分别为Allen、John、Seven。11

  2. 管理员受邀进入每个助理的房间内,后续可以查看每个助理与Manager的交互过程,可以进行监督和跟踪。12

  3. 为团队3位员工分别创建HiClaw登录账号:帮我创建3个登录账号,登录名称为 H-Allen、H-John,H-Seven。13

  4. 将团队成员分别邀请到对应的房间内,以h-allen为示例。14

    h-allen 成功进入房间。15

    管理员通过Manager配置h-allen可以在allen房间内直接给allen下发任务。16

  5. h-allen给数字分身managerallen直接下发任务:帮我查询一下最近prometheus的动态。其中Manager是不会响应h-allen的任务的,allen(数字分身)会响应h-allen的任务。17

HiClaw 场景实践

1.顶级豪车设计前借助AI模拟调研

  1. Manager下发任务:请帮我创建4worker分别代表4位用户,分别为:第1位是科技领域上市公司高管,身价10亿以上对高科技产品有浓厚兴趣;第2位为欧洲传统行业公司创始人,公司早已上市身价数十亿;第3位为美国顶级富二代,对于车有浓厚兴趣并已经购置多辆豪车;第4位为欧洲新贵足球明星,手握顶级代言合同和天价球员合同,已豪掷千金购买顶级豪宅和私人飞机。18

  2. Manager下发任务:请将4位用户拉到一个房间内,接下来我们要在这个房间内进行讨论。1920

  3. Manager下发任务:我是一个新能源汽车生产商,目前计划生产一辆预计售价在3000万左右的顶级豪车,我需要做一些市场调研深入了解用户的需求,目标是了解客户的真实需求,为产品设计提供帮忙。请组织这四位客户进行100轮相关讨论,最后请将结果汇总发给我。21初始化设定完成后,讨论开始。22

  4. 房间内观摩AI们的自行讨论的过程。

    模块1:动力与性能体验(第1-15轮)开始。23每位“用户”轮流发言,并且有互相之间的讨论。24

    客户观摩整个讨论,遇到卡点时可以及时通过Manager介入。25

  5. 最终获得结果。262728

一键释放资源

1.实践环境保留转生产

如果实践后想长期保留使用,则无需释放云资源

  1. HiClaw登录地址在实践时采用直接使用AI网关的公网域名的方式,存在1000次/天的访问限制,如果作为生产使用推荐在云解析DNS的公网权威解析中进行配置CNAME至访问域名:创建域名 41

  2. SAE推荐购买资源包费用会更节省:产品计费

  3. 建议将AI网关转为包年包月模式费用会更节省:计费说明

2.实践环境释放

重要

实践完成后如果实践环境不想保留,则推荐按照如下步骤完成云资源的释放,否则云资源会持续收费。

  1. OSSBucket中存在数据会造成CADT无法删除(产品侧限制),所以需手动访问阿里云OSS控制台(https://oss.console.aliyun.com/bucket),手动删除存储桶中的数据(请再次确认数据已不需要)。424344

  2. SAE中的WorkerManager自动创建,不是通过CADT部署,所以需要手动删除Worker对应的应用,应用名称前缀为hiClaw-worker-***。454647

  3. 云速搭控制台,应用->我的应用,找到部署应用,一键释放其余资源。4829

警告

实践完成后要及时通过CADT一键释放云产品,否则云资源会持续收费。

FAQ 常见问题

1.Manager创建的Matrix登录用户提示密码不对

  1. 通过Manager下发任务创建Matrix登录用户,在实际登录过程中出现提示账号密码不对报错。

    30

  2. 通过让Manager自行检查核对账号是否真实创建并重置密码。31

2.Manager卡死无法响应任务

  1. 如果在实践过程中遇到Manager尝试多次仍旧无法感知任务,说明因为某些原因Manager处于卡死状态,需要重启对应SAE的应用。32

  2. 登录阿里云SAE控制台(https://saenext.console.aliyun.com/overview),切换命名空间(第2章步骤6中记录的SAE命名空间信息)。33点击hiClaw-manager,点击重启应用。

    重要

    提示:重启应用会导致运行中未及时存储记忆中的任务丢失。

    34重启应用预计需要2~3分钟,待重启完成后继续与Manager交互即可35

3.如何销毁某个Worker和房间

  1. 如果在实践过程中需要销毁某个Worker,可以通过Manager进行销毁Worker,但是房间无法自动销毁。36

  2. 需要手动离开房间。37

4.与Worker交互无反应

如果在实践过程中发现在房间内艾特Worker下发任务无反应:

  1. 如果是刚初始化创建的Wroker则需要等待2~3分钟(SAE应用启动)后,再尝试即可。

  2. 尝试艾特Manager发送消息让Manager检查Worker并尝试自动修复。

  3. 上述办法仍旧未修复,则登录SAE控制台查看对应应用,必要时可进行重启应用。

说明

方案最佳实践可以参考《HiClaw数字员工云上部署最佳实践》