OpenClaw是面向开发、运维场景的开源AI智能体工具,具备本地文件操作、多平台消息推送、联网检索、代码自动生成、多工具调度等能力,单独部署后无法独立完成大模型推理,必须对接大模型服务接口才能正常使用。阿里云百炼Token Plan是包月预付费模型订阅方案,提供固定额度Credits、多模型共享、团队权限管控、高峰不限速等企业级能力,非常适合云服务器长期稳定运行OpenClaw。本文面向零基础新手,完整梳理阿里云ECS服务器环境准备、OpenClaw两种部署方式、Token Plan订阅开通、密钥配置、服务验证、日常运维与新手高频报错解决方案,全程步骤可直接复制执行,降低新手部署门槛。
一、前期准备工作
1. 阿里云ECS服务器选型与基础环境配置
新手推荐入门级服务器配置,兼顾成本与运行稳定性:2核4GB内存,40GB高效云盘,分配公网IP,操作系统优先选择Ubuntu 22.04 LTS或Alibaba Cloud Linux 3,两种系统兼容性最优。
安全组是新手最容易遗漏的环节,需要提前放行端口:22端口用于SSH远程连接,18789端口是OpenClaw默认Web控制台访问端口,若后续自定义端口,需要同步修改安全组放行规则。
远程连接服务器后,先执行系统更新与基础依赖安装,补齐运行所需运行库:
sudo apt update && sudo apt upgrade -y
sudo apt install git curl docker.io docker-compose python3 python3-pip -y
sudo systemctl start docker
sudo systemctl enable docker
零基础部署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 的地址。


2. 百炼Token Plan开通与密钥获取流程
第一步完成阿里云账号实名认证,未实名账号无法订阅Token Plan套餐与生成调用密钥。进入百炼大模型服务平台,找到Token Plan团队订阅页面,套餐分为三档:标准版每月198元包含25000 Credits、高级版每月698元包含100000 Credits、尊享版每月1398元包含250000 Credits,个人开发者可选标准版,研发团队高频调用推荐高级版。
订阅完成后进入API密钥管理页面,选择创建Token Plan专属密钥,密钥以sk-sp开头,仅展示一次,需要立刻复制保存,同时记录对应地域兼容接口地址,北京地域标准地址为固定兼容模式路径,后续配置OpenClaw时必须完整填写。
订阅完成后确认套餐内包含可用模型,主流适配OpenClaw的模型包含Qwen3.7-Max、Qwen3.7-Plus,避免出现模型权限不足无法调用的问题。
二、阿里云ECS服务器两种OpenClaw部署方式
方式一:Docker一键部署(新手首选,环境无冲突)
Docker容器部署隔离运行环境,不会出现系统依赖缺失、版本冲突问题,操作简单,适合零基础新手。
- 拉取OpenClaw官方稳定镜像
docker pull openclaw/openclaw:latest - 创建本地持久化配置目录,防止容器删除后配置丢失
mkdir -p /opt/openclaw/config mkdir -p /opt/openclaw/files - 后台启动容器,映射端口并挂载本地目录
docker run -d \ --name openclaw-agent \ --restart always \ -p 18789:18789 \ -v /opt/openclaw/config:/root/.openclaw \ -v /opt/openclaw/files:/workspace/files \ openclaw/openclaw:latest - 校验容器运行状态,出现openclaw-agent代表启动正常
docker ps
方式二:原生脚本手动部署(适合需要自定义开发的用户)
- 执行官方一键安装脚本自动完成环境配置
curl -fsSL 官方安装脚本地址 | bash - 刷新系统环境变量,让openclaw全局命令生效
source ~/.bashrc - 验证安装是否成功,输出版本号即代表安装完成
openclaw --version - 设置后台常驻运行,避免关闭终端后服务中断
nohup openclaw start &
三、OpenClaw对接百炼Token Plan三种配置方案
方案1:Web可视化控制台配置(新手最友好)
- 浏览器访问服务器公网IP加18789端口,进入OpenClaw后台登录页面,初始账号密码可在容器日志或安装日志中查看。
- 左侧菜单栏找到模型配置板块,点击新增模型服务商,选择自定义兼容接口类型。
- 依次填写配置内容:服务商名称自定义填写阿里云百炼Token Plan,BaseURL粘贴订阅配套的兼容接口地址,API Key填入保存的sk-sp专属密钥,默认推理模型选择Qwen3.7-Plus或Qwen3.7-Max。
- 点击保存配置,重启OpenClaw服务使参数生效。
方案2:交互式命令行配置
SSH登录服务器终端,执行模型配置交互指令:
openclaw model config
按照页面提示依次输入参数:服务商类型选择custom、粘贴接口地址、填入专属密钥、选定默认使用模型,全部填写完成后自动写入本地配置文件,无需手动编辑文件。
方案3:手动修改配置文件(进阶用户精准调整)
- 进入本地配置目录,打开核心配置文件
nano /opt/openclaw/config/config.yaml - 在模型配置区块写入完整Token Plan对接参数
llm: provider: custom base_url: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 api_key: sk-sp-xxxxxxxxxxxxxxxxxxx default_model: qwen3.7-plus timeout: 60 temperature: 0.6 - 保存文件后重启服务,Docker部署执行docker restart openclaw-agent,原生部署执行openclaw restart。
四、配置完成功能验证步骤
1. 命令行测试模型调用
执行对话测试指令,验证Token Plan接口连通性:
openclaw chat "简单介绍OpenClaw智能体的核心能力"
正常返回完整文字回复,无报错信息,代表模型对接成功。
2. Web控制台功能测试
刷新浏览器页面,新建对话窗口,测试文件读取、代码生成、联网检索三类核心能力,确认模型正常响应,无调用失败提示。
3. 用量校验
登录百炼Token Plan控制台,查看Credits消耗明细,测试对话产生对应消耗记录,说明配置链路完整可用。
五、新手必备运维优化配置
1. 服务器开机自启
Docker部署用户可设置容器开机自动重启,原生部署用户创建systemd服务单元,服务器重启后自动拉起OpenClaw,无需手动启动。
2. 额度提醒设置
在百炼控制台配置额度预警,设置剩余20%额度触发短信提醒,避免Credits耗尽导致智能体无法使用。
3. 成本优化技巧
日常简单文件处理、文本摘要选用Qwen3.7-Plus降低消耗;复杂代码重构、长文档分析使用Qwen3.7-Max;重复固定对话场景开启上下文缓存,减少重复Token消耗。
4. 数据持久化备份
定期备份/opt/openclaw/config目录,保存模型配置、技能插件、对话记录,更换服务器时可直接迁移全部配置,无需重复配置Token Plan密钥。
六、新手高频报错与解决办法
- 网页无法访问18789端口
排查方向:检查ECS安全组是否放行18789端口;服务器本地防火墙关闭拦截规则;确认OpenClaw容器或服务正常运行。 - 模型调用返回鉴权失败
排查方向:核对API Key是否为Token Plan专属sk-sp密钥,普通百炼密钥无法适配;检查BaseURL地址完整无缺失后缀;确认套餐未过期、账号无欠费。 - 调用返回无可用模型权限
排查方向:登录百炼Token Plan后台,确认套餐已开通对应模型使用权限,重新保存配置并重启OpenClaw。 - Credits消耗速度过快
排查方向:调整对话上下文长度,精简冗余提问;更换轻量化模型;关闭不必要的长文本自动总结功能。 - Docker容器启动失败
排查方向:检查服务器磁盘空间是否充足;端口被占用时修改容器端口映射;重新拉取官方镜像修复镜像损坏问题。
七、完整部署总结
对于零基础新手,在阿里云ECS服务器部署OpenClaw并对接百炼Token Plan,优先选择Docker容器部署搭配Web可视化配置,操作门槛最低,不易出现环境故障。整套流程分为服务器环境准备、OpenClaw安装、Token Plan订阅与密钥配置、功能验证、日常运维五大环节,Token Plan包月订阅模式相比按量计费,能够有效控制长期使用成本,适配OpenClaw全天候自动化任务调度场景。
整套方案兼顾隐私可控、运行稳定、成本可控三大优势,个人开发者、小型研发团队均可快速落地,搭建专属本地AI智能体,完成代码开发、文件处理、自动化运维、文档分析等各类工作任务。新手按照分步教程依次执行,规避端口放行、密钥类型、接口地址三类高频踩坑点,即可一次性完成完整部署,快速投入日常开发使用。