在阿里云ECS云服务器上搭建 OpenClaw 并集成百炼Token Plan教程与问题排查

简介: OpenClaw是一款开源可自托管的AI智能体执行框架,能让大模型从单纯对话升级为可执行文件处理、代码编写、流程自动化的数字助手。在阿里云ECS上部署OpenClaw并集成百炼Token Plan,可获得稳定、高性价比的大模型调用能力,满足个人与企业的AI应用需求。以下从准备、部署、配置、验证、运维全流程,详细拆解每一步操作,并梳理高频问题与解决方案,确保零基础用户也能顺利完成搭建。

OpenClaw是一款开源可自托管的AI智能体执行框架,能让大模型从单纯对话升级为可执行文件处理、代码编写、流程自动化的数字助手。在阿里云ECS上部署OpenClaw并集成百炼Token Plan,可获得稳定、高性价比的大模型调用能力,满足个人与企业的AI应用需求。以下从准备、部署、配置、验证、运维全流程,详细拆解每一步操作,并梳理高频问题与解决方案,确保零基础用户也能顺利完成搭建。阿里云部署AI Agent:OpenClaw/Hermes Agent全网最简单,只需两步,详情👉访问阿里云OpenClaw/Hermes一键部署专题页面 了解。
OpenClaw1.png
OpenClaw2.png
OpenClaw02.png
openClaw3.png
OpenClaw031.png
OpenClaw03.png
OpenClaw04.png
OpenClaw5.png
Openclaw6.png
Token Plan Token最便宜/支持多模型切换:👉访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换,用于多模态模型灵活调用,实现多模型、多工具、多场景下的额度共享与统一管理,兼顾灵活性、稳定性与安全性,大幅降低企业使用大模型的门槛与成本。
tokenplan1.png
tokenplan1.png
tokenplan2.png
tokenplan3.png
tokenplan4.png

一、部署前核心准备

部署前需完成账号、服务器、工具与凭证准备,避免后续流程受阻。

  1. 阿里云账号与实名认证:注册阿里云账号并完成个人/企业实名认证,未实名无法使用云服务与获取百炼API Key。确保账号无欠费、无风控限制,可正常购买ECS与开通百炼服务。
  2. ECS实例选型与配置
    • 系统选择:优先Ubuntu 22.04 LTS,兼容性与稳定性最佳,也可选择CentOS 7+、Windows Server 2019+。
    • 配置要求:内存≥2GB(推荐4GB+),存储≥20GB(ESSD云盘优先,提升读写速度),带宽≥1Mbps,满足OpenClaw运行与模型调用需求。
    • 地域选择:国内地域需ICP备案,海外地域(如中国香港、美国弗吉尼亚)无需备案,且联网搜索功能不受限,可根据业务需求选择。
    • 安全组配置:开放8080(OpenClaw Web UI端口)、22(SSH远程连接)端口,确保外部可访问服务。
  3. 必备工具准备:准备远程连接工具(如FinalShell、Xshell)用于SSH登录ECS;准备文本编辑器保存API Key、访问Token等敏感信息;安装Git、Node.js 22.x+(一键部署脚本可自动安装)。
  4. 百炼Token Plan开通与API Key获取
    • 登录阿里云百炼大模型控制台,进入Token Plan团队版订阅页面,选择标准版、高级版或尊享版套餐,完成支付订阅,新用户可享免费额度。
    • 进入“密钥管理”,点击“创建API Key”,选择“Token Plan专属API Key”(格式为sk-sp-xxxxxx),仅生成时可完整查看,务必立即复制保存,丢失需重新创建。
    • 记录Token Plan专属Base URL:https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1,用于后续配置。

二、阿里云ECS部署OpenClaw

ECS部署OpenClaw有一键脚本安装与源码安装两种方式,新手优先选择一键脚本,快速完成部署。

零基础部署AI Agent:OpenClaw/Hermes Agent喂饭级步骤流程

第一步:👉点击打开访问阿里云OpenClaw/Hermes Agent一键部署专题页面
OpenClaw1.png
OpenClaw2.png
OpenClaw02.png
openClaw3.png
OpenClaw031.png
OpenClaw03.png
OpenClaw04.png
OpenClaw5.png
Openclaw6.png

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

第二步:👉打开选择阿里云轻量应用服务器,配置参考如下:

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

轻量应用服务器OpenClaw镜像.png
bailian1.png
bailian2.png

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

阿里云百炼密钥管理图.png

前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
阿里云百炼密钥管理图2.png

  • 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
  • 配置百炼API-Key,单击一键配置,输入百炼的API-Key。单击执行命令,写入API-Key。
  • 配置OpenClaw/Hermes:单击执行命令,生成访问OpenClaw/Hermes的Token。
  • 访问控制页面:单击打开网站页面可进入OpenClaw/Hermes对话页面。

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程:

创建API-Key,推荐访问订阅阿里云百炼Coding Plan,阿里云百炼Coding Plan每天两场抢购活动,从按tokens计费升级为按次收费,可以进一步节省费用!
CodingPlan.png

  • 购买后,在控制台生成API Key。注:这里复制并保存好你的API Key,后面要用。
    image.png
  • 回到轻量应用服务器-控制台,单击服务器卡片中的实例 ID,进入服务器概览页。
    image.png
  • 在服务器概览页面单击应用详情页签,进入服务器详情页面。
    image.png
  • 端口放通在OpenClaw使用步骤区域中,单击端口放通下的执行命令,可开放获取OpenClaw 服务运行端口的防火墙。
    image.png
  • 这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key,直接选择就可以。
    image.png
  • 获取访问地址单击访问 Web UI 面板下的执行命令,获取 OpenClaw WebUI 的地址。
    image.png
    image.png
方式一:一键脚本安装(推荐)
  1. 远程登录ECS:使用SSH工具连接ECS公网IP,输入账号密码登录,默认账号为root。
  2. 执行一键安装脚本:在终端输入以下命令,脚本自动检测系统、安装Node.js、Git等依赖,并完成OpenClaw安装与初始化。
     curl -fsSL https://openclaw.ai/install.sh | bash
    
  3. 完成初始化配置:安装完成后,脚本自动启动引导程序,按提示完成基础配置,包括设置管理员密码、选择模型提供商(暂选自定义,后续配置百炼)、安装核心技能等。引导程序会自动启动Gateway后台服务,并在浏览器打开OpenClaw控制页面(http://ECS公网IP:8080)。
  4. 验证安装:在终端执行openclaw --version查看版本,执行openclaw doctor检查环境,执行openclaw gateway status查看服务状态,确保服务正常运行。
方式二:源码安装(适合自定义配置)
  1. 安装依赖:在ECS终端执行以下命令,安装Node.js、pnpm、Git。
     sudo apt update && sudo apt install -y nodejs npm git
     sudo npm install -g pnpm
    
  2. 克隆源码:执行命令克隆OpenClaw源码仓库。
     git clone https://github.com/openclaw/openclaw.git
     cd openclaw
    
  3. 安装依赖并构建:执行以下命令安装项目依赖并构建项目。
     pnpm install && pnpm build && pnpm ui:build
    
  4. 启动服务:执行命令启动OpenClaw服务。
     pnpm start
    
  5. 设置开机自启:为避免服务器重启后服务中断,配置开机自启。创建自启文件,写入启动命令,添加执行权限。
     sudo nano /etc/rc.local
     # 在文件中添加
     cd /root/openclaw && nohup pnpm start > openclaw.log 2>&1 &
     sudo chmod +x /etc/rc.local
    

三、配置百炼Token Plan集成

部署完成后,需将OpenClaw与百炼Token Plan集成,实现大模型调用能力,支持命令行与Web UI两种配置方式。

方式一:命令行配置(高效快捷)
  1. 编辑配置文件:执行命令打开OpenClaw配置文件。
     nano ~/.openclaw/openclaw.json
    
  2. 写入百炼配置:在配置文件中添加以下内容,将YOUR_API_KEY替换为Token Plan专属API Key,确保baseUrl正确。
     {
         
       "meta": {
         
         "lastTouchedVersion": "2026.2.1"
       },
       "models": {
         
         "mode": "merge",
         "providers": {
         
           "bailian-token-plan": {
         
             "baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
             "apiKey": "YOUR_API_KEY",
             "enabled": true,
             "defaultModel": "qwen3.7-max"
           }
         }
       },
       "tokenPlan": {
         
         "enable": true
       }
     }
    
  3. 重启服务:保存配置文件后,执行命令重启OpenClaw服务,使配置生效。
     openclaw gateway restart
    
方式二:Web UI配置(可视化操作)
  1. 访问Web UI:在浏览器输入http://ECS公网IP:8080,使用初始化时设置的管理员密码登录。
  2. 进入模型配置:点击页面右上角“Settings”,选择“Models”选项卡。
  3. 添加百炼提供商:点击“Add Provider”,选择“Custom”,填写以下信息:
  4. 启用Token Plan:切换至“Token Plan”选项卡,开启“Enable Token Plan”开关,保存配置。
  5. 验证配置:返回主页,发送测试指令(如“生成一个Python Hello World程序”),检查是否正常返回结果,且百炼Token Plan额度正常消耗。

四、功能验证与基础使用

配置完成后,验证OpenClaw核心功能,确保集成正常。

  1. 模型调用验证:在Web UI或终端发送指令,测试大模型响应,如“解释什么是AI智能体”,检查返回内容是否准确,无报错。
  2. 技能使用验证:安装常用技能(如文件处理、代码编写、流程自动化),测试技能执行效果,如“创建一个名为test.txt的文件并写入内容”,检查文件是否生成。
  3. 额度消耗验证:登录阿里云百炼控制台,查看Token Plan额度消耗情况,确保调用优先抵扣套餐额度,无额外按量计费。

五、高频问题与避坑指南

部署与使用过程中,常见问题及解决方案如下:

  1. 服务启动失败,内存不足
    • 现象:启动OpenClaw时提示内存不足,服务崩溃。
    • 原因:ECS内存低于2GB,无法满足运行需求。
    • 解决方案:升级ECS内存至4GB及以上,或关闭其他占用内存的进程。
  2. 无法访问Web UI,端口未开放
    • 现象:浏览器输入http://ECS公网IP:8080无法访问。
    • 原因:ECS安全组未开放8080端口,或服务器防火墙拦截。
    • 解决方案:在阿里云ECS控制台安全组中添加8080端口入方向规则;在服务器中执行命令关闭防火墙或开放端口。
  3. 百炼Token Plan配置不生效,额度不抵扣
    • 现象:模型调用正常,但Token Plan额度无消耗,产生按量计费费用。
    • 原因:配置文件中tokenPlan.enable未设为true,或使用普通百炼API Key而非Token Plan专属密钥。
    • 解决方案:检查配置文件,确保tokenPlan.enable: true,替换为sk-sp-开头的Token Plan专属API Key,重启服务。
  4. 服务器重启后服务未自动启动
    • 现象:ECS重启后,OpenClaw服务未运行。
    • 原因:未配置开机自启,或自启文件路径错误、无执行权限。
    • 解决方案:重新配置开机自启,确保启动命令路径与实际目录一致,添加执行权限。
  5. 技能调用无法共享Token Plan额度
    • 现象:基础对话正常抵扣额度,技能模块调用单独计费。
    • 原因:技能配置未关联Token Plan,或模型提供商设置错误。
    • 解决方案:在技能配置中选择bailian-token-plan作为模型提供商,确保全局Token Plan开关开启。
  6. API Key泄露风险
    • 现象:API Key被他人获取,导致额度被盗用。
    • 原因:配置文件权限过低,或未妥善保存密钥。
    • 解决方案:设置配置文件权限为600(仅所有者可读写),使用加密工具存储密钥,避免明文泄露。

六、运维与优化建议

  1. 日志管理:定期查看OpenClaw日志(openclaw.log),排查运行异常,及时处理报错。
  2. 安全加固:修改默认管理员密码,启用Gateway Token鉴权(执行openclaw doctor --fix),避免未授权访问。
  3. 性能优化:大型项目或高并发场景,升级ECS配置(CPU、内存、带宽),使用负载均衡提升服务稳定性。
  4. 版本更新:定期执行openclaw update更新OpenClaw版本,获取新功能与安全修复。
  5. 额度监控:在百炼控制台设置额度预警,避免额度耗尽影响服务使用。

七、总结

在阿里云ECS上搭建OpenClaw并集成百炼Token Plan,是构建自主可控AI智能体的高效方案。从ECS选型、OpenClaw部署,到百炼Token Plan配置与功能验证,每一步都有明确操作指引,配合避坑指南可快速解决常见问题。完成部署后,可通过OpenClaw实现文件处理、代码编写、流程自动化等多种AI能力,结合百炼Token Plan的高性价比模型调用,满足个人学习、企业应用等多种场景需求。后续可进一步探索OpenClaw的技能扩展、多模型集成等高级功能,打造更强大的AI智能体。

目录
相关文章
人工智能 BI API
158 2
|
1月前
|
缓存 Rust 安全
Nolang 硬核技术白皮书:全方位内核级超越 Rust(纯语言机制对比)
Nolang 是新一代无GC内存安全语言,首创“延迟所有权”模型:赋值直觉、零生命周期负担、函数末尾批量内存回收,性能与安全全面超越Rust。当前生态尚小,但内核、架构与开发体验已实现碾压式领先。(239字)
268 3
自然语言处理 安全 API
5266 1
|
25天前
|
人工智能 自然语言处理 API
从入门到精通阿里云千问:模型矩阵、免费额度、API代码调用与企业落地指南
AI产业落地的浪潮下,自研通用大模型已经成为数字化转型的核心基础设施。阿里云千问,官方名称通义千问,代号Qwen,是阿里云完全自主研发的全栈式大模型家族,并非单一文本模型,而是覆盖纯文本、代码、图像、音频、视频、行业垂直场景的完整产品矩阵,统一依托阿里云百炼大模型服务平台对外提供模型调用、微调、智能体开发、私有知识库构建、应用一键部署等全链路MaaS服务。当前主力迭代版本为Qwen3.7系列,形成旗舰、均衡、轻量、多模态、代码专用五大分支模型,在中文理解、超长上下文推理、自主智能体执行、多模态统一解析四大维度具备国产头部水准,同时搭配免费试用、按量计费、Token Plan订阅、长期节省计划四
854 4
剪映一秒批量打关键帧
剪映打关键帧, 一百张图片, 只需要一秒钟
2198 0
缓存 人工智能 JSON
132 1
运维 数据可视化 Serverless
135 2
存储 人工智能 数据可视化
109 1
运维 安全 数据建模
106 1
弹性计算 安全 Linux
319 1