ZeroClaw是一款开源的本地优先AI代理与自动化平台。可通过ZeroClaw将多渠道通信能力与大语言模型深度集成,创建拥有持久记忆与主动执行能力的定制化AI助理。
ZeroClaw 为开源 AI 助手,请在使用前充分评估其安全性与稳定性并严格遵循许可协议,以切实保障系统环境与数据安全。
计费说明
在轻量应用服务器上部署并使用ZeroClaw服务将产生以下费用:
轻量应用服务器费用:参见轻量应用服务器计费概述。
模型调用费用:ZeroClaw执行过程中默认调用百炼模型。模型调用的主要计费方式有两种:
Coding Plan AI 编码套餐(推荐):采用固定月费模式,提供月度请求额度,超出时段限额的调用会报错且不计费用,可避免产生超出预期的费用。
Coding Plan 目前支持
qwen3.5-plus、kimi-k2.5、MiniMax-M2.5、glm-5等模型。按Token用量计费:默认使用
qwen3.5-plus模型作为文本和图像处理模型。重要配置免费额度用完即停:首次开通阿里云百炼时,会自动发放各模型的免费额度。免费额度消耗完后,默认将按量计费,建议开启用完即停功能,避免产生额外费用。
步骤一、购买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等消息渠道。
常见问题
如何查看配对码?
在中单击执行命令,查看并保存配对码。
请勿泄露配对码,配对码是 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的端口号。
为什么填写API Key时系统不识别我已有的百炼API Key?
系统会自动检测离当前服务器所在地域最近的百炼模型接入点,并展示其对应的API Key(如果订阅了百炼Coding Plan,会同时展示其API Key)。如果不存在就近接入点对应的API Key,可按界面操作在对应的地域创建API Key或订阅Coding Plan。
轻量应用服务器所在地域 | 系统推荐的百炼API Key对应地域 | Coding Plan的API key对应地域 |
中国内地地域 | 华北2(北京) | 华北2(北京) |
美国及欧洲地域 | 美国(弗吉尼亚) | |
中国香港及其他亚洲地域 | 新加坡 |