ZeroClaw是什么?新手ZeroClaw安装教程,基于阿里云轻量应用服务器3分钟创建成功,ZeroClaw是一款开源的本地优先AI代理与自动化平台。可通过ZeroClaw将多渠道通信能力与大语言模型深度集成,创建拥有持久记忆与主动执行能力的定制化AI助理。ZeroClaw 为开源 AI 助手,请在使用前充分评估其安全性与稳定性并严格遵循许可协议,以切实保障系统环境与数据安全。本文是使用轻量应用服务器的ZeroClaw镜像部署安装的,轻量官方页面:https://www.aliyun.com/product/swas 如下图:
计费说明
在轻量应用服务器上部署并使用ZeroClaw服务将产生以下费用:
- 轻量应用服务器费用参考::https://www.aliyun.com/product/swas
- 模型调用费用:ZeroClaw执行过程中默认调用百炼模型。模型调用的主要计费方式有两种:
- Coding Plan AI 编码套餐(推荐):采用固定月费模式,提供月度请求额度,超出时段限额的调用会报错且不计费用,可避免产生超出预期的费用。
Coding Plan 目前支持qwen3.5-plus、kimi-k2.5、MiniMax-M2.5、glm-5等模型。
- 按Token用量计费:默认使用
qwen3.5-plus模型作为文本和图像处理模型。
重要
配置免费额度用完即停:首次开通阿里云百炼时,会自动发放各模型的免费额度。免费额度消耗完后,默认将按量计费,建议开启用完即停功能,避免产生额外费用。
步骤一、购买ZeroClaw套餐
重要
如果已购买轻量应用服务器,可以跳过此步骤,以重置系统的方式部署ZeroClaw(重置系统时选择应用镜像下的ZeroClaw镜像),但重置系统会清除轻量应用服务器上的系统盘数据,请根据需要做好数据备份。具体操作,请参见重置系统。
- 购买预装ZeroClaw应用的轻量应用服务器。
- 在轻量应用服务器页面,预置了资源配置,如要更改配置项,请参考下面内容。
- 实例:内存必须2GiB及以上,可以根据需求切换套餐。
- 地域:默认北京。
- 购买配置:默认12个月,可以根据自己的需求切换时长。
步骤二、配置ZeroClaw
- 在轻量应用服务器-控制台,单击服务器卡片中的实例ID,在服务器概览页面单击应用详情页签。
- 在ZeroClaw使用步骤区域中,单击端口放通下的一键放通,可开放ZeroClaw服务运行端口的防火墙。
重要
为了防止恶意扫描与定向攻击,ZeroClaw 在初始化时不使用固定的默认端口,而是自动生成一个随机端口,可在控制台查看ZeroClaw的端口号。 - 单击配置ZeroClaw下的初始化配置百炼API key。目前支持配置两种类型的百炼API Key:
- Coding Plan 套餐专属 API Key(推荐):采用固定月费模式,提供月度请求额度,超出时段限额的调用会报错且不计费用,可避免产生超出预期的费用。
Coding Plan 目前支持qwen3.5-plus、kimi-k2.5、MiniMax-M2.5、glm-5等模型。
- 按Token用量计费的百炼API Key。
- API Key配置方式包括系统推荐及手动输入。系统推荐会列出百炼Coding Plan的API Key(成本可控),及离服务器最近的百炼模型服务的API Key(时延较低)。若需使用其他地域或者其他账号的API Key可选择手动输入。
- 系统推荐(下拉选择)
选择完成后单击下一步。
轻量应用服务器所在地域 |
系统推荐的百炼API Key对应地域 |
Coding Plan的API key对应地域 |
中国内地地域 |
华北2(北京) |
华北2(北京) |
美国及欧洲地域 |
美国(弗吉尼亚) |
|
中国香港及其他亚洲地域 |
新加坡 |
- 手动输入
单击按钮切换至手动输入,输入百炼API Key并选择该API Key对应地域,单击下一步。
重要
手动配置需确保选择的API Key对应地域正确,否则会导致模型无法正常调用。
- 访问WebUI面板。
配对码为一次性有效,并与当前浏览器会话绑定。如果在新的浏览器标签页或窗口中打开访问地址,将需要重新生成并使用新的配对码进行配对。
- 在访问WebUI面板区域下的生成Pairing Code区域单击执行命令,获取并复制ZeroClaw WebUI的配对码。
- 在访问Web UI面板区域下的获取WebUI面板地址单击执行命令,获取并访问网站地址并输入配对码,即可与 ZeroClaw 的 Agent 对话。
- (可选)集成消息渠道。可以为ZeroClaw配置钉钉、飞书和QQ等消息渠道。
常见问题
如何查看配对码?
在应用详情 > 基础配置 > 生成Pairing Code中单击执行命令,查看并保存配对码。
警告
请勿泄露配对码,配对码是 ZeroClaw Gateway 的唯一身份认证凭证入口,任何持有配对码的人都可以完成配对,获取 Gateway 的完整控制权限。
如何更改ZeroClaw调用的模型?
- 进入WebUI,在左侧导航栏单击Configuration。
- 在General区域,更新以下信息:
- API Key:模型密钥。
- API URL:模型的Base URL。
- Default Provider:
custom: 模型的Base URL。 - Default Model:切换的模型。
- 单击右上角的Save,保存设置。
如何重启ZeroClaw网关?
当遇到链接中断或服务不可用等场景时,可在控制台页面重启ZeroClaw网关。在应用详情 > 基础配置 > 重启ZeroClaw网关中单击执行命令。
如何查看ZeroClaw的端口号?
为了防止恶意扫描与定向攻击,ZeroClaw 在初始化时不再使用固定的默认端口,而是自动生成一个随机端口。在应用详情 > 基础配置 > 查看端口中单击执行命令查看ZeroClaw的端口号。
为什么填写API Key时系统不识别我已有的百炼API Key?
系统会自动检测离当前服务器所在地域最近的百炼模型接入点,并展示其对应的API Key(如果订阅了百炼Coding Plan,会同时展示其API Key)。如果不存在就近接入点对应的API Key,可按界面操作在对应的地域创建API Key或订阅Coding Plan。
轻量应用服务器所在地域 |
系统推荐的百炼API Key对应地域 |
Coding Plan的API key对应地域 |
中国内地地域 |
华北2(北京) |
华北2(北京) |
美国及欧洲地域 |
美国(弗吉尼亚) |
|
中国香港及其他亚洲地域 |
新加坡 |
目前阿里云轻量应用服务器200M带宽优惠价格9.9元1个月、38元一年,在阿里云活动中心:https://www.aliyun.com/activity 如下图: