一、前言
OpenClaw是一款功能完善的开源AI智能体,支持多轮对话、插件拓展、自动化任务执行与上下文记忆,在个人办公、日常交互、轻量自动化场景中应用广泛。该应用基于Node.js开发,运行稳定且拓展性强,多数使用者会选择阿里云ECS云服务器作为运行载体,依托云服务器持续在线、网络稳定、资源可控的特性,实现7×24小时不间断服务。
在对接大模型服务时,除常规按量计费模式外,Token Plan是面向高频调用、长期运行AI应用的定向资源方案,能够实现调用额度统一抵扣、接口优先级优化,有效控制长期使用成本,尤其适配OpenClaw这类全天候运行的智能体。将OpenClaw部署在阿里云ECS,并正确配置Token Plan相关参数,是保障应用稳定调用、合理使用资源的关键。
本文结合2026年阿里云ECS标准运行环境,完整讲解从服务器前期准备、系统环境搭建、项目源码拉取、依赖安装、应用参数配置,到Token Plan凭证写入、端口放行、服务启停、后台常驻、日常运维、故障排查的全流程。全文仅围绕技术实操展开,无营销内容,附带完整可执行命令与配置代码,不包含外部链接、表格与图片。无论有无服务器操作经验,按照步骤依次执行,均可完成OpenClaw部署与Token Plan正常生效。阿里云部署AI Agent:OpenClaw/Hermes Agent全网最简单,只需两步,详情👉访问阿里云OpenClaw/Hermes一键部署专题页面 了解。








👉访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换,用于多模态模型灵活调用,实现多模型、多工具、多场景下的额度共享与统一管理,兼顾灵活性、稳定性与安全性,大幅降低企业使用大模型的门槛与成本。




二、部署前期准备工作
正式部署前需要完成服务器资源确认、运行环境规划、两类核心凭证申领,提前补齐所需信息,避免中途中断操作。
2.1 ECS服务器环境确认
本次部署基于阿里云ECS云服务器开展,操作系统统一选用Ubuntu 22.04,该系统对Node.js、Git等组件兼容性良好,是Node类开源项目的首选运行系统。
硬件资源方面,仅个人使用、基础对话与少量插件启用,1核2G配置即可满足需求;多人同时访问、批量启用插件、高频调用大模型,建议使用2核2G及以上配置,防止内存不足导致应用闪退、响应缓慢。同时确认服务器公网IP、远程登录账号与密码,用于远程连接和外网访问应用。
2.2 运行依赖说明
OpenClaw运行依赖Node.js运行环境、Git代码管理工具,要求Node.js版本不低于18.x。Token Plan属于大模型定向抵扣方案,无需额外安装组件,仅需在应用配置文件中补充对应凭证即可生效。
2.3 核心凭证申领
需要提前准备两组关键凭证,两类凭证作用不同,需分开保管:
第一类是大模型基础调用密钥,用于建立智能体与大模型服务的基础通信;
第二类是Token Plan专属凭证,用于触发额度自动抵扣,实现定向资源消耗。
两类字符均区分大小写,禁止添加多余空格与符号,同时禁止对外公开、明文上传至公共目录。
零基础部署AI Agent:OpenClaw/Hermes Agent喂饭级步骤流程
第一步:👉点击打开访问阿里云OpenClaw/Hermes Agent一键部署专题页面。








👉访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换,用于多模态模型灵活调用,实现多模型、多工具、多场景下的额度共享与统一管理,兼顾灵活性、稳定性与安全性,大幅降低企业使用大模型的门槛与成本。




第二步:👉打开选择阿里云轻量应用服务器,配置参考如下:
- 镜像:OpenClaw(或Hermes Agent)镜像(已经购买服务器的用户可以重置系统重新选择镜像)
- 实例:内存必须2GiB及以上。
- 地域:默认美国(弗吉尼亚),目前中国内地域(除香港)的轻量应用服务器,联网搜索功能受限。
- 时长:根据自己的需求及预算选择。



第三步:打开访问阿里云百炼大模型控制台,找到密钥管理,单击创建API-Key。

前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
- 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
- 配置百炼API-Key,单击一键配置,输入百炼的API-Key。单击执行命令,写入API-Key。
- 配置OpenClaw/Hermes:单击执行命令,生成访问OpenClaw/Hermes的Token。
- 访问控制页面:单击打开网站页面可进入OpenClaw/Hermes对话页面。
阿里云百炼Coding Plan API-Key 获取、配置保姆级教程:
创建API-Key,推荐访问订阅阿里云百炼Coding Plan,阿里云百炼Coding Plan每天两场抢购活动,从按tokens计费升级为按次收费,可以进一步节省费用!
- 购买后,在控制台生成API Key。注:这里复制并保存好你的API Key,后面要用。

- 回到轻量应用服务器-控制台,单击服务器卡片中的实例 ID,进入服务器概览页。

- 在服务器概览页面单击应用详情页签,进入服务器详情页面。

- 端口放通在OpenClaw使用步骤区域中,单击端口放通下的执行命令,可开放获取OpenClaw 服务运行端口的防火墙。

- 这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key,直接选择就可以。

- 获取访问地址单击访问 Web UI 面板下的执行命令,获取 OpenClaw WebUI 的地址。


三、ECS系统环境初始化
远程登录阿里云ECS服务器终端后,首先完成系统更新、基础工具安装、Node.js环境部署,搭建统一的运行环境。
3.1 系统更新与基础工具安装
初次登录服务器,先更新系统软件源与内置组件,修复潜在版本冲突,再安装Git、curl等必备工具:
sudo apt update && sudo apt upgrade -y
sudo apt install git curl -y
命令执行过程中等待自动完成即可,无需手动干预。
3.2 安装Node.js与包管理工具
执行命令安装Node.js和npm,完成基础运行环境部署:
sudo apt install nodejs npm -y
3.3 版本校验与升级
安装完成后查看版本,判断是否满足项目运行要求:
node -v
npm -v
若Node.js版本低于18.x,使用版本管理工具完成升级:
sudo npm install -g n
sudo n lts
升级后再次执行版本查看命令,确认版本达标。
3.4 项目目录规划
创建独立目录存放OpenClaw相关文件,规范文件管理,便于后期运维:
mkdir -p /usr/local/openclaw
cd /usr/local/openclaw
四、OpenClaw源码拉取与项目依赖安装
环境搭建完成后,拉取项目源码并安装项目专属依赖包,这是应用正常启动的基础。
4.1 克隆项目源码
在当前目录下使用Git拉取完整项目源码:
git clone 项目源码路径
源码下载完成后,进入项目根目录:
cd OpenClaw
4.2 安装项目依赖
OpenClaw包含插件模块、接口请求、日志记录、会话管理等多个组件,通过npm批量安装依赖:
npm install
若出现依赖加载失败、模块缺失等问题,清理缓存后重新执行安装命令:
npm cache clean -f
npm install
五、配置文件编写与Token Plan参数配置
OpenClaw所有运行参数、大模型接口、调用密钥、Token Plan凭证均通过环境配置文件.env统一管理。本节完成配置文件生成、完整参数填写,重点讲解Token Plan相关配置项。
5.1 生成正式配置文件
基于项目自带示例文件复制生成可用配置文件,不直接修改原示例文件:
cp .env.example .env
vim .env
5.2 完整配置内容填写
进入编辑模式后,写入全部运行参数,依次填写大模型接口地址、基础调用密钥、服务端口、功能开关,以及Token Plan专属凭证:
# 大模型统一接口地址
MODEL_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
# 大模型基础调用密钥
API_KEY=基础调用密钥内容
# Token Plan专属抵扣凭证
TOKEN_PLAN_KEY=Token Plan对应凭证内容
# 应用对外监听端口
SERVER_PORT=8080
# 接口请求超时时间
REQUEST_TIMEOUT=200
# 开启会话缓存,保留多轮对话上下文
SESSION_CACHE=true
# 启用插件功能
SKILL_ENABLE=true
# 开启运行日志
LOG_ENABLE=true
# 日志输出级别
LOG_LEVEL=info
# 单IP最大连接数
MAX_CONNECT=25
填写完成后保存并退出编辑器。
5.3 参数详细说明
- MODEL_BASE_URL:大模型标准接口地址,固定内容无需修改,修改会导致通信失败;
- API_KEY:基础调用凭证,保证智能体能够正常请求大模型服务;
- TOKEN_PLAN_KEY:Token Plan核心配置项,填写正确后,应用产生的调用量会优先使用Token Plan额度进行抵扣,这是本节配置的核心;
- SERVER_PORT:应用访问端口,本文统一使用8080,修改端口后防火墙与安全组需同步调整;
- REQUEST_TIMEOUT:接口超时时间,服务器网络延迟较高时可适当增大数值;
- 其余功能开关、连接限制参数,可根据使用场景自主调整。
5.4 Token Plan配置注意事项
两类密钥需严格区分,不可互相替换;凭证字符必须完整复制,不能缺失字符、增减空格;配置完成后必须重启应用,新的抵扣规则才会生效。当Token Plan额度耗尽后,系统会自动切换为常规按量计费模式。
六、服务器防火墙与安全组端口放行
配置文件编写完成后,需要同时配置ECS本地防火墙与阿里云控制台安全组,放行应用监听端口,外网设备才能正常访问OpenClaw。
6.1 本地防火墙放行端口
Ubuntu系统默认搭载ufw防火墙,执行命令放行8080端口:
sudo ufw allow 8080/tcp
sudo ufw reload
sudo ufw status
执行后查看状态,确认端口处于允许访问状态。
6.2 阿里云安全组配置
登录阿里云控制台,进入当前ECS实例的安全组配置页面,新增入方向规则,协议选择TCP,端口填写8080,授权范围设置为全部IP,保存规则。两处端口配置缺一不可,否则会出现内网正常、外网无法访问的问题。
七、应用启动、功能测试与后台常驻运行
端口配置完成后,分两步启动应用,先前台启动完成功能与抵扣规则测试,确认无误后设置后台常驻运行。
7.1 前台启动应用
在项目根目录执行前台启动命令,查看启动日志:
npm start
终端输出日志,若提示端口监听成功、配置加载完成,代表应用启动正常。
使用浏览器访问ECS公网IP加端口,进入交互页面,发送多条对话指令进行测试。一方面验证对话、插件等基础功能是否正常,另一方面登录大模型资源控制台,查看调用消耗记录,确认调用量优先从Token Plan额度中扣除。测试完成后终止前台进程。
7.2 后台常驻运行
前台测试全部正常后,使用nohup命令将应用转入后台运行,同时输出日志文件:
nohup npm start > openclaw_log.log 2>&1 &
关闭远程终端,应用也会持续在服务器后台运行。
7.3 实时查看运行日志
日常监控运行状态、排查异常时,使用日志查看命令:
tail -f openclaw_log.log
八、进阶配置:ECS开机自启设置
ECS服务器重启、断电恢复后,后台应用会自动停止,配置开机自启可实现无人值守自动启动服务。
8.1 编辑开机自启文件
sudo vim /etc/rc.local
在文件内exit 0上方添加启动命令,填写完整项目路径:
cd /usr/local/openclaw/OpenClaw && nohup npm start > openclaw_log.log 2>&1 &
8.2 赋予执行权限
sudo chmod +x /etc/rc.local
8.3 验证自启效果
执行服务器重启命令进行测试:
sudo reboot
重启完成后重新连接服务器,查看进程与日志,确认应用自动启动。
九、日常运维常用命令汇总
整理运维过程中高频使用的命令,涵盖进程查看、服务启停、端口排查、日志清理、版本更新等操作。
9.1 查看应用运行进程
ps aux | grep node
9.2 停止运行中的应用
修改配置、更新版本前,先终止进程:
pkill -f "npm start"
9.3 重启应用服务
cd /usr/local/openclaw/OpenClaw
nohup npm start > openclaw_log.log 2>&1 &
9.4 排查端口占用
sudo lsof -i :8080
9.5 清空日志文件
> /usr/local/openclaw/OpenClaw/openclaw_log.log
9.6 项目版本更新
cd /usr/local/openclaw/OpenClaw
pkill -f "npm start"
git pull
npm install
nohup npm start > openclaw_log.log 2>&1 &
十、常见故障排查方案
结合ECS环境与Token Plan配置场景,梳理高频故障、原因及解决办法。
10.1 依赖安装失败,应用启动提示模块缺失
问题现象:执行npm install报错,启动应用提示模块加载失败。
解决办法:检查Node.js版本,确保为18.x及以上;清理缓存后重新安装:
npm cache clean -f
npm install
10.2 应用启动正常,外网无法访问页面
问题现象:日志显示端口监听成功,外网无法打开页面。
解决办法:依次检查ECS本地防火墙、阿里云安全组,确认8080端口已正常放行,端口号与配置文件保持一致。
10.3 页面可访问,对话无AI回复
问题现象:界面正常,发送指令无模型响应。
解决办法:打开.env文件,核对MODEL_BASE_URL与API_KEY,确认凭证有效、额度未耗尽;适当调大REQUEST_TIMEOUT数值。
10.4 Token Plan额度不生效,依旧扣除按量计费额度
问题现象:已配置TOKEN_PLAN_KEY,调用量未抵扣定向额度。
解决办法:核对TOKEN_PLAN_KEY填写是否完整、有无多余字符;确认配置完成后已重启应用;检查Token Plan状态是否正常、额度是否充足。
10.5 修改配置文件后参数不生效
问题现象:修改密钥、端口、抵扣凭证后,运行状态无变化。
解决办法:配置修改后必须彻底停止后台进程,再重新启动应用,新参数方可加载。
10.6 应用启动后自动闪退
问题现象:应用启动短时间内进程终止。
解决办法:查看运行日志定位报错;检查ECS内存资源,内存不足可关闭多余插件、限制连接数,或升级服务器配置。
十一、运行规范与资源管理建议
11.1 凭证安全管理
基础调用密钥与Token Plan专属凭证均为敏感信息,严禁明文分享、上传至公共代码目录。定期查看资源消耗记录,发现异常调用及时重置密钥,防止资源被盗用。
11.2 Token Plan资源管控
定期查看Token Plan剩余额度,提前做好额度补充规划。区分测试环境与生产环境,测试操作尽量避开定向额度,优先使用临时按量计费,减少定向资源无效消耗。
11.3 服务器资源优化
根据在线人数调整MAX_CONNECT参数,避免并发过高造成负载异常;定期清理日志文件,释放磁盘空间;阶段性重启应用,释放内存碎片,提升长期运行稳定性。
11.4 配置文件备份
定期备份.env配置文件,保存各类密钥与自定义参数,防止服务器故障、项目更新导致配置丢失。
十二、总结
本文完整梳理了2026年阿里云ECS云服务器部署OpenClaw,并配置Token Plan的全流程操作,从服务器环境准备、系统组件安装、源码拉取、依赖部署,到核心配置文件编写、Token Plan凭证录入、端口放行、应用启停、后台常驻、开机自启,再到日常运维、故障排查与资源管理,形成一套完整的技术实操体系。
Token Plan作为定向资源抵扣方案,是长期运行OpenClaw这类AI智能体的优选模式,正确填写专属凭证、规范配置流程,能够保障额度正常抵扣,实现资源精细化管理。整个部署流程中,环境版本校验、双密钥区分填写、端口规则配置、配置修改后重启应用,是四个核心关键点,也是最容易出现问题的环节。
文中所有命令、配置代码均适配阿里云ECS标准Ubuntu环境,可直接复制使用。依托ECS服务器的稳定运行能力,搭配Token Plan资源方案,OpenClaw可以长期稳定提供对话、插件、自动化任务等服务,满足个人与小型团队的使用需求。
在长期使用过程中,坚持规范运维、做好密钥防护、定期监控资源与服务状态,既能保障应用不间断运行,也能合理管控大模型调用成本。同时,本次实操也能够帮助使用者熟悉ECS基础运维、Node.js项目部署、大模型资源配置等相关技能,为后续部署同类应用积累实践经验。