ZeroClaw新手安装教程——快速部署你的私有的AI助手

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镜像），但重置系统会清除轻量应用服务器上的系统盘数据，请根据需要做好数据备份。具体操作，请参见重置系统。

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-plus、 kimi-k2.5、 MiniMax-M2.5、 glm-5等模型。

• 按Token用量计费的百炼API Key。
  

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

• 系统推荐（下拉选择）
  选择完成后单击下一步。

• 
  
• 手动输入
  单击按钮切换至手动输入，输入百炼API Key并选择该API Key对应地域，单击下一步。
  
  重要
  手动配置需确保选择的API Key对应地域正确，否则会导致模型无法正常调用。
  

1. 访问WebUI面板。

配对码为一次性有效，并与当前浏览器会话绑定。如果在新的浏览器标签页或窗口中打开访问地址，将需要重新生成并使用新的配对码进行配对。

1. 在访问WebUI面板区域下的生成Pairing Code区域单击执行命令，获取并复制ZeroClaw WebUI的配对码。
   
2. 在访问Web UI面板区域下的获取WebUI面板地址单击执行命令，获取并访问网站地址并输入配对码，即可与 ZeroClaw 的 Agent 对话。
   

1. （可选）集成消息渠道。可以为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，保存设置。
   

如何重启ZeroClaw网关？

当遇到链接中断或服务不可用等场景时，可在控制台页面重启ZeroClaw网关。在应用详情 > 基础配置 > 重启ZeroClaw网关中单击执行命令。

如何查看ZeroClaw的端口号？

为了防止恶意扫描与定向攻击，ZeroClaw 在初始化时不再使用固定的默认端口，而是自动生成一个随机端口。在应用详情 > 基础配置 > 查看端口中单击执行命令查看ZeroClaw的端口号。

为什么填写API Key时系统不识别我已有的百炼API Key？                        

系统会自动检测离当前服务器所在地域最近的百炼模型接入点，并展示其对应的API Key（如果订阅了百炼Coding Plan，会同时展示其API Key）。如果不存在就近接入点对应的API Key，可按界面操作在对应的地域创建API Key或订阅Coding Plan。

目前阿里云轻量应用服务器200M带宽优惠价格9.9元1个月、38元一年，在阿里云活动中心：https://www.aliyun.com/activity 如下图：