购买并部署ZeroClaw镜像

更新时间:
复制为 MD 格式

ZeroClaw是一款开源的本地优先AI代理与自动化平台。可通过ZeroClaw将多渠道通信能力与大语言模型深度集成,创建拥有持久记忆与主动执行能力的定制化AI助理。

重要

ZeroClaw 为开源 AI 助手,请在使用前充分评估其安全性与稳定性并严格遵循许可协议,以切实保障系统环境与数据安全。

计费说明

在轻量应用服务器上部署并使用ZeroClaw服务将产生以下费用:

  • 轻量应用服务器费用:参见轻量应用服务器计费概述

  • 模型调用费用:ZeroClaw执行过程中默认调用百炼模型。模型调用的主要计费方式有两种:

    • Coding Plan AI 编码套餐(推荐):采用固定月费模式,提供月度请求额度,超出时段限额的调用会报错且不计费用,可避免产生超出预期的费用。

      Coding Plan 目前支持 qwen3.5-pluskimi-k2.5MiniMax-M2.5glm-5等模型。
    • Token用量计费:默认使用qwen3.5-plus 模型作为文本和图像处理模型。

      重要

      配置免费额度用完即停:首次开通阿里云百炼时,会自动发放各模型的免费额度。免费额度消耗完后,默认将按量计费,建议开启用完即停功能,避免产生额外费用。

步骤一、购买ZeroClaw套餐

重要

如果已购买轻量应用服务器,可以跳过此步骤,以重置系统的方式部署ZeroClaw(重置系统时选择应用镜像下的ZeroClaw镜像),但重置系统会清除轻量应用服务器上的系统盘数据,请根据需要做好数据备份。具体操作,请参见重置系统

  1. 购买预装ZeroClaw应用的轻量应用服务器

  2. 轻量应用服务器页面,预置了资源配置,如要更改配置项,请参考下面内容。

    • 实例:内存必须2GiB及以上,可以根据需求切换套餐。

    • 地域:默认北京

    • 购买配置:默认12个月,可以根据自己的需求切换时长。

步骤二、配置ZeroClaw

  1. 轻量应用服务器-控制台,单击服务器卡片中的实例ID,在服务器概览页面单击应用详情页签。

  2. ZeroClaw使用步骤区域中,单击端口放通下的一键放通,可开放ZeroClaw服务运行端口的防火墙。

    重要

    为了防止恶意扫描与定向攻击,ZeroClaw 在初始化时不使用固定的默认端口,而是自动生成一个随机端口,可在控制台查看ZeroClaw的端口号

  3. 单击配置ZeroClaw下的初始化配置百炼API key。

    目前支持配置两种类型的百炼API Key:

    • Coding Plan 套餐专属 API Key(推荐):采用固定月费模式,提供月度请求额度,超出时段限额的调用会报错且不计费用,可避免产生超出预期的费用。

      Coding Plan 目前支持 qwen3.5-pluskimi-k2.5MiniMax-M2.5glm-5等模型。
    • Token用量计费的百炼API Key。

    API Key配置方式包括系统推荐手动输入。系统推荐会列出百炼Coding PlanAPI Key(成本可控),及离服务器最近的百炼模型服务的API Key(时延较低)。若需使用其他地域或者其他账号的API Key可选择手动输入。

    • 系统推荐(下拉选择)

      选择完成后单击下一步

      轻量应用服务器所在地域

      系统推荐的百炼API Key对应地域

      Coding PlanAPI key对应地域

      中国内地地域

      华北2(北京)

      华北2(北京)

      美国及欧洲地域

      美国(弗吉尼亚)

      中国香港及其他亚洲地域

      新加坡

    • 手动输入

      单击按钮切换至手动输入,输入百炼API Key并选择该API Key对应地域,单击下一步

      image

      重要

      手动配置需确保选择的API Key对应地域正确,否则会导致模型无法正常调用。

  4. 访问WebUI面板。

    配对码为一次性有效,并与当前浏览器会话绑定。如果在新的浏览器标签页或窗口中打开访问地址,将需要重新生成并使用新的配对码进行配对。
    1. 访问WebUI面板区域下的生成Pairing Code区域单击执行命令,获取并复制ZeroClaw WebUI的配对码。

    2. 访问Web UI面板区域下的获取WebUI面板地址单击执行命令,获取并访问网站地址并输入配对码,即可与 ZeroClaw 的 Agent 对话。

  5. (可选)集成消息渠道。可以为ZeroClaw配置钉钉、飞书和QQ等消息渠道。

常见问题

如何查看配对码?

应用详情 > 基础配置 > 生成Pairing Code中单击执行命令,查看并保存配对码。

警告

请勿泄露配对码,配对码是 ZeroClaw Gateway 的唯一身份认证凭证入口,任何持有配对码的人都可以完成配对,获取 Gateway 的完整控制权限。

如何更改ZeroClaw调用的模型?

  1. 进入WebUI,在左侧导航栏单击Configuration

  2. General区域,更新以下信息:

    • API Key:模型密钥。

    • API URL:模型的Base URL。

    • Default Provider:custom: 模型的Base URL

    • Default Model:切换的模型。

  3. 单击右上角的Save,保存设置。

2026-03-17_15-26-56

如何重启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 PlanAPI key对应地域

中国内地地域

华北2(北京)

华北2(北京)

美国及欧洲地域

美国(弗吉尼亚)

中国香港及其他亚洲地域

新加坡