通过阿里云轻量应用服务器安装部署ZeroClaw图文教程

搞AI Agent的站长最近估计都听过ZeroClaw这个东西。简单说它就是个本地优先的AI自动化框架，最诱人的地方在于能挂持久记忆，还能把它直接塞进钉钉、飞书或者QQ群里当个全天候跑腿的机器人。前两天我看阿里云轻量应用服务器直接出了个ZeroClaw的预装镜像，立马整了一台来玩，顺便给想折腾的同行踩踩坑。

一、安装部署阿里云轻量应用服务器

要搞这个AI框架，服务器配置其实要求不高，但内存必须得2GiB起步，低于这个规格连镜像都选不了。

阿里云轻量应用服务器活动地址：https://www.aliyun.com/product/swas

让搭建agent更便宜更简单，2核2G服务器+2亿Token只需262.5元

如果你手里刚好有闲置的阿里云轻量服务器，不用重新买，直接去控制台点重置系统，在应用镜像里找ZeroClaw镜像盖过去就行。不过提醒一句，重置系统是直接擦除系统盘，里面有重要数据记得先做好快照或者本地备份，别到时候数据丢了来骂街。全新购买的话，地域默认北京或者离你近的都行，操作系统底层跑的是Alibaba Cloud Linux 4 LTS，性能稳定性没啥大问题。

系统推荐（下拉选择）

选择完成后单击下一步。

买好或者重置完服务器，第一步千万别急着去开网页，得先去解决网络和API Key。阿里云这套镜像做得挺有意思，为了防那群天天打扫端口的黑客，ZeroClaw初始化时根本不给固定端口，而是后台随机生成一个。

你得先进入轻量服务器的概览页面，切到应用详情页签。找到ZeroClaw使用步骤里的端口放通，点一下一键放通。这步其实就是后台自动帮你把那个随机生成的防火墙端口给开了。

端口通了之后，核心就是配置百炼API Key。说实话，大模型调用最怕跑着跑着账单爆表。这里极其推荐选Coding Plan套餐专属API Key。这玩意是固定月费制，哪怕你调用超额了它也只是报错不扣钱，对于咱们这种穷折腾的站长来说安全感拉满。这个包年包月套餐目前支持qwen3.5-plus、kimi-k2.5还有glm-5这几个主力模型。如果你非要用按Token用量扣费的方式，强烈建议去阿里云百炼后台把免费额度用完即停的开关给勾上，不然免费额度一干完直接从你余额里扣钱，到时候哭都来不及。

配Key的时候，控制台挺智能的，会根据你服务器的地域自动拉取最近的接入点。比如你服务器在中国内地，它就推荐北京地域的Key；如果是香港或者新加坡，它就会推对应的海外接入点。直接下拉选择推荐的Key然后点下一步就行。如果是手动填Key，一定要核对好Key对应的地域，地域搞错了大模型肯定调用失败。

搞定Key之后就是登录WebUI面板。这时候你需要拿到配对码（Pairing Code），这玩意类似于最高权限的令牌。在访问Web UI面板区域找到生成Pairing Code，点一下执行命令，后台就会把一串代码吐给你。

拿到代码后，再去获取WebUI面板地址点执行命令，把出来的那个网址复制到浏览器打开。把刚才的配对码填进去完成绑定。注意啊，这个配对码跟当前浏览器会话是绑定的，而且是一次性的，如果你换个浏览器或者开了无痕模式，就得重新去控制台点生成配对码。另外配对码千万别泄露给别人，谁拿到这串码谁就能直接控制你的网关。

进了WebUI，其实基础的AI对话就已经能跑了。但单在网页上聊天没啥意思，这玩意真正的精髓是挂到社群软件里当工具人。

二、集成钉钉、飞书、QQ消息通道

拿把ZeroClaw部署在服务器上单独用网页聊，说实话真没啥意思，也就是个高级版的ChatGPT界面。这玩意真正好玩的，是把它打造成一个全天候挂在社群里的智能管家。想象一下，不论你在钉钉工作群、飞书团队交流群，还是在QQ里，发个消息就能直接调动后台的大模型帮做自动化处理，这体验才叫拉满。

不过很多站长卡就卡在对接这几个平台的API和事件回调上。阿里云现在的轻量服务器控制台把这块流程简化了不少，大部分繁琐的后端交互都给封装成了面板操作。

1、集成钉钉方式

打通钉钉算是成本最低、流程最顺的一个。

前提是你得有个钉钉开发者权限的组织。没有的话用钉钉App随便扫码现场建一个团队就行，版本注意要在6.5.45以上。

准备好组织后，直接进钉钉开放平台。

在开发者后台里能看到一个一键自动创建OpenClaw机器人的按钮，直接点击立即创建。

钉钉官方在这里预设好了机器人参数，名称和图标你自己随便改改，不改也行，直接确认创建。

创建成功后，页面会吐出两个核心凭证：Client ID和Client Secret，先把这两个密钥复制保存好。

要是窗口不小心关了也别急，进凭证与基础信息里还能查到。

拿到了凭证，回到阿里云轻量服务器控制台。点进你那台部署了ZeroClaw的实例详情，找到应用详情页签下的通道配置，把页面切到钉钉。把刚刚复制的Client ID和Client Secret填进去，点击应用，等系统后台自动把命令跑完就行。

这时候机器人就已经挂载成功了。你想在群里用，就进钉钉群设置，在机器人管理里搜索你刚才创建的机器人名称，把它拉进群。

在群里直接@它就能对话。

要是想私聊，直接在钉钉顶部的搜索框搜机器人的名字，点击头像进入私聊界面就能直接打字交互。

2、集成飞手方式

飞书的接入稍微有点绕，主要是权限和事件回调机制比钉钉严谨得多。

第一步还是去飞书开放平台创建企业自建应用。填完基础信息创建好后，先在左侧的凭证与基础信息页面把App ID（格式类似cli_xxx这种）和App Secret拷下来。

重点来了，飞书需要手主动给机器人开权限。在左侧导航栏点权限管理，找到那个批量导入/导出权限的按钮，把官方给的那串权限JSON配置粘贴进去，点下一步确认并申请开通。开完权限后，再去添加应用能力页面，找到机器人卡片，点击配置把它激活。

接着处理事件订阅。先回到阿里云控制台的通道配置里选择飞书，把刚才拿到的App ID和App Secret填进去点应用。填完之后再切回飞书开放平台，找到事件与回调页面。把订阅方式改成使用长连接接收事件并保存。然后在事件配置里点添加事件，搜索im.message.receive_v1这个接收消息的核心事件，勾选并确认添加。

最后一步也是最容易忘的：去版本管理与发布页面新建一个版本，随便填个版本号和更新说明，提交审核并发布。如果不发布版本，飞书后台是不会把消息推给你的机器人的。

发布完成后，在群设置里把机器人加进来@它，或者直接点机器人头像发消息，都能顺畅响应。

3、集成QQ方式

腾讯现在的QQ机器人开放平台搞了个龙虾专用入口，对接起来比以前简陋的协议挂载方便太多了。

直接前往腾讯QQ开放平台官网，找到那个龙虾专用入口点去使用。

拿出手机QQ扫码登录你的账号，点击创建机器人。

创建完成后，系统会实时生成AppID和AppSecret。这里务必注意，QQ机器人的AppSecret是不提供明文二次查看的，你一关页面就看不到明文了，忘记了就只能重新生成。所以拿到密钥的第一时间赶紧复制好。

拿到这两个参数后，依然是回到阿里云轻量服务器的应用详情，找到通道配置里的QQ项。把App ID和App Secret填进去，点击应用。

等控制台显示应用成功后，直接打开你的手机或者电脑QQ，搜索你的机器人，发起单聊就能直接通过自然语言让ZeroClaw帮做各种自动化操作了。

说白了，这三个渠道配置下来，核心逻辑都是去平台拿接口凭证，然后填回阿里云的后台面板，让控制台帮我们完成底层的进程挂载。真正在跑的时候，只要服务器网关没挂，这几个机器人就能一直在线。

三、常见问题

折腾过程中估计大家会遇到几个骚操作和坑点。

阿里云轻量应用服务器活动地址：https://www.aliyun.com/product/swas

让搭建agent更便宜更简单，2核2G服务器+2亿Token只需262.5元

镜像更新与重置问题

已购买的轻量应用服务器，如何部署ZeroClaw镜像？

1. 登录轻量应用控制台，选择对应实例单击重置系统。
2. 选择重置为其他镜像，在应用镜像列表中选择ZeroClaw镜像。
3. 重新配置ZeroClaw。重置后之前配置的API Key和Token都会失效，需要到应用详情里重新配置API Key。

警告

重置系统操作相当于重装系统，会清空系统盘内的所有数据（包括已保存的配置、日志和数据库）及停止轻量服务器中正在运行的业务程序。在执行操作前，请务必备份重要数据（建议创建快照或将数据导出到本地）。

功能相关问题

如何查看配对码？

在应用详情 > 基础配置 > 生成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的端口号。

购买与费用问题

如何配置ZeroClaw仅使用百炼免费额度，不产生额外费用？

默认状态下，百炼大模型在免费额度消耗完后，继续使用会扣费，若您希望不产生超出免费额度外的模型调用费用，可前往百炼平台开启免费额度用完即停。配置完成后，模型免费额度消耗完毕将无法使用，模型免费额度用完后可更换拥有免费额度的模型继续使用。