从安装到验证：阿里云 ECS 云服务器部署 OpenClaw 并接入百炼Coding Plan/ Token Plan 教程-阿里云开发者社区

在AI开发与自动化运维场景中，OpenClaw作为开源个人AI助手平台，凭借多渠道交互、任务自动化与模型灵活接入能力，成为开发者构建专属AI助理的优选方案。将OpenClaw部署在阿里云ECS弹性云服务器上，并对接阿里云百炼的Coding Plan与Token Plan，可实现高可用、低成本的AI服务调用，满足代码开发、文档处理、智能对话等多元需求。本文将从ECS实例准备、OpenClaw部署、百炼订阅计划开通与配置、服务验证与优化等环节，提供完整实操指南，帮助开发者快速搭建稳定高效的AI助手环境。

一、前期准备：ECS实例选型与环境配置

1.1 ECS实例选型与创建

OpenClaw基于Node.js运行，对服务器资源有基础要求，为保证运行流畅与多任务处理能力，建议选择2核4G及以上配置的ECS实例，操作系统优先选择Alibaba Cloud Linux 3、CentOS 7/8或Ubuntu 20.04+，这些系统对Node.js、Docker等工具的兼容性更佳，且适配阿里云云助手服务，简化部署流程。

创建ECS实例的核心步骤：

登录阿里云ECS控制台，点击创建实例，选择自定义购买模式。
地域选择：优先选择华北2（北京），该地域为百炼服务核心地域，API调用延迟更低，稳定性更强。
实例规格：选择ecs.g7.large（2核4G） 及以上，付费类型可选择按量付费，便于根据使用量灵活调整资源，降低初期成本。
镜像：选择Alibaba Cloud Linux 3.2104 LTS 64位，该镜像预装云助手、基础依赖工具，且支持一键安装OpenClaw扩展程序。
网络与安全组：选择专有网络VPC，安全组需开放22端口（SSH）、1878端口（Web控制台）、18789端口（服务通信），确保公网可访问OpenClaw管理界面与服务。
登录凭证：设置实例密码或绑定SSH密钥，建议使用密钥对登录，提升服务器安全性。
确认配置并提交订单，等待实例创建完成（约1-3分钟），记录实例公网IP，用于后续远程连接与访问。
零基础部署AI Agent：OpenClaw/Hermes Agent喂饭级步骤流程
第一步：👉点击打开访问阿里云OpenClaw/Hermes Agent一键部署专题页面。

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

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

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

轻量应用服务器OpenClaw镜像.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计费升级为按次收费，可以进一步节省费用！

购买后，在控制台生成API Key。注：这里复制并保存好你的API Key，后面要用。
回到轻量应用服务器-控制台，单击服务器卡片中的实例 ID，进入服务器概览页。
在服务器概览页面单击应用详情页签，进入服务器详情页面。
端口放通在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw 服务运行端口的防火墙。
这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key，直接选择就可以。
获取访问地址单击访问 Web UI 面板下的执行命令，获取 OpenClaw WebUI 的地址。

1.2 ECS实例基础环境配置
实例创建完成后，通过Workbench远程连接或本地SSH工具登录服务器，执行以下命令完成基础环境配置，安装OpenClaw运行所需依赖：

# 1. 更新系统软件包，确保依赖最新
sudo yum update -y  # Alibaba Cloud Linux/CentOS
# sudo apt update && sudo apt upgrade -y  # Ubuntu

# 2. 安装基础依赖工具（wget、curl、git、vim等）
sudo yum install -y wget curl git vim unzip  # Alibaba Cloud Linux/CentOS
# sudo apt install -y wget curl git vim unzip  # Ubuntu

# 3. 安装Node.js（OpenClaw核心运行环境，要求22.0+版本）
# 安装nvm（Node版本管理工具，便于切换版本）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 加载nvm环境变量
source ~/.bashrc
# 安装Node.js 24 LTS（推荐稳定版本）
nvm install 24
nvm use 24
# 验证Node.js与npm安装
node -v  # 输出v24.x.x
npm -v   # 输出对应版本

# 4. 安装Docker（可选，用于容器化部署OpenClaw，提升隔离性）
# 卸载旧版Docker（如有）
sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine -y
# 安装Docker依赖
sudo yum install -y yum-utils device-mapper-persistent-data lvm2
# 添加Docker官方仓库
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
# 安装Docker CE与相关组件
sudo yum install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
# 启动Docker并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker
# 验证Docker安装
sudo docker run hello-world  # 出现Hello from Docker!提示即成功

执行完成后，Node.js、npm与Docker均正常运行，为OpenClaw部署奠定基础。

二、OpenClaw部署：两种方案任选

OpenClaw提供云助手一键部署与手动脚本部署两种方式，前者适合快速上手、无需复杂配置，后者适合自定义参数、灵活调整，开发者可根据需求选择。

2.1 方案一：云助手一键部署（推荐）

阿里云ECS云助手提供OpenClaw官方公共命令，无需手动配置环境，3-5分钟即可完成安装，适合新手快速部署。

操作步骤：

登录阿里云ECS控制台，在左侧导航栏选择运维与监控 > 云助手。
在公共命令页签中，搜索ACS-ECS-InstallOpenClaw-for-linux.sh（Linux实例专属命令），点击命令卡片中的执行。
在弹出的执行面板中，配置参数：
- 执行用户：选择root（确保安装权限）。
- 超时时间：设置为300秒（避免安装超时）。
- 命令参数：无需额外配置，保持默认。
- 目标实例：选择上一步创建的ECS实例。
点击执行，系统将自动通过云助手下发安装任务，等待执行完成（约3分钟），可在执行历史中查看进度与结果。

安装完成后，通过SSH登录ECS实例，执行以下命令验证OpenClaw安装：

# 查看OpenClaw版本
openclaw --version
# 若返回版本号（如openclaw 1.5.0），说明安装成功
# 查看OpenClaw帮助信息
openclaw help

2.2 方案二：手动脚本部署（自定义配置）

若需自定义OpenClaw安装路径、版本或配置参数，可通过官方脚本手动部署，步骤如下：

# 1. 下载并执行OpenClaw官方安装脚本（自动检测系统，安装Node.js与OpenClaw）
curl -fsSL https://openclaw.ai/install.sh | bash

# 2. 安装完成后，加载OpenClaw环境变量（避免命令无法识别）
source ~/.bashrc

# 3. 验证OpenClaw安装
openclaw --version  # 输出版本号即成功

# 4. 初始化OpenClaw（生成配置文件与工作目录）
openclaw onboard --install-daemon
# 执行后，按提示选择：Continue? → Yes；Onboarding mode → Quick Start

执行完成后，OpenClaw将自动创建~/.openclaw/目录，包含配置文件、工作区与日志，后续可通过修改配置文件对接百炼订阅计划。

三、阿里云百炼订阅计划开通与API Key获取

OpenClaw需通过专属API Key对接百炼的Coding Plan或Token Plan，需先完成订阅计划开通与API Key创建，两种计划的API Key格式、Base URL与支持模型不同，需严格区分。

3.1 开通百炼订阅计划

登录阿里云百炼控制台，在首页选择订阅计划，可选择Coding Plan或Token Plan：
- Coding Plan：固定月费订阅，按模型调用次数计量，支持Qwen3.7-Plus、Kimi、GLM等8种模型，适合高频代码开发、编程辅助场景。
- Token Plan：按Token消耗抵扣Credits，分为个人版与团队版，支持Qwen3.7-Max、Qwen3.8-Max-Preview、DeepSeek-V4-Pro等多模型灵活切换，适合通用AI开发、智能对话场景。
选择对应计划的套餐（如Coding Plan Pro、Token Plan个人版基础套餐），完成支付开通，确保账户有足够余额或已完成订阅。

3.2 获取专属API Key

不同订阅计划的API Key获取路径与格式不同，需按以下步骤操作：

3.2.1 获取Coding Plan API Key

在百炼控制台进入Coding Plan > 我的订阅，点击创建API Key。
配置API Key权限（建议选择全部权限，确保OpenClaw可调用所有模型），点击确定。
复制生成的API Key（以sk-coding-开头），妥善保存，仅生成时完整显示一次，后续无法查看完整密钥。
记录Coding Plan专属Base URL（兼容Anthropic协议）：https://coding.dashscope.aliyuncs.com/apps/anthropic。

3.2.2 获取Token Plan API Key

在百炼控制台进入Token Plan > 我的订阅，点击创建API Key。
选择个人版或团队版，配置权限后点击确定。
复制生成的API Key（以sk-sp-开头），妥善保存。
记录Token Plan专属Base URL（兼容OpenAI协议）：https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1。

注意：Coding Plan、Token Plan与百炼通用API Key（sk-开头）不可混用，需使用对应计划的专属API Key，否则会出现鉴权失败。

四、OpenClaw对接百炼订阅计划：配置与验证

4.1 配置OpenClaw接入凭证

OpenClaw通过~/.openclaw/openclaw.json配置文件管理模型供应商，需手动修改该文件，添加百炼订阅计划的接入信息。

4.1.1 编辑配置文件

通过SSH登录ECS实例，执行以下命令编辑OpenClaw配置文件：

# 编辑OpenClaw核心配置文件
sudo vim ~/.openclaw/openclaw.json

4.1.2 写入百炼订阅计划配置

根据选择的订阅计划，在models.providers字段中添加对应配置，替换YOUR_API_KEY为上一步获取的专属API Key。

Coding Plan配置示例：

{
   
  "models": {
   
    "mode": "merge",
    "providers": {
   
      "bailian-coding-plan": {
   
        "baseUrl": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
        "apiKey": "sk-coding-xxxxxxxxxxxxxxxxxxxxxxxx",
        "models": [
          "qwen3.7-plus",
          "kimi-chat",
          "glm-4",
          "claude-3-sonnet",
          "claude-3-haiku",
          "deepseek-coder",
          "qwen3.6-flash",
          "llama3-70b"
        ],
        "defaultModel": "qwen3.7-plus"
      }
    }
  },
  "gateway": {
   
    "port": 18789,
    "webPort": 1878,
    "host": "0.0.0.0"
  },
  "workspace": "~/.openclaw/workspace"
}

Token Plan配置示例：

{
   
  "models": {
   
    "mode": "merge",
    "providers": {
   
      "bailian-token-plan": {
   
        "baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
        "apiKey": "sk-sp-xxxxxxxxxxxxxxxxxxxxxxxx",
        "models": [
          "qwen3.7-max",
          "qwen3.8-max-preview",
          "qwen3.7-plus",
          "deepseek-v4-pro",
          "glm-5.2",
          "qwen3.6-flash"
        ],
        "defaultModel": "qwen3.7-max"
      }
    }
  },
  "gateway": {
   
    "port": 18789,
    "webPort": 1878,
    "host": "0.0.0.0"
  },
  "workspace": "~/.openclaw/workspace"
}

4.1.3 重启OpenClaw服务

配置文件修改完成后，需重启OpenClaw服务使配置生效：

# 停止OpenClaw服务
openclaw stop
# 启动OpenClaw服务
openclaw start
# 查看服务状态
openclaw status
# 输出running即表示服务正常运行

4.2 验证对接是否成功

配置完成后，通过命令行与Web控制台两种方式验证OpenClaw是否能正常调用百炼模型。

4.2.1 命令行验证

执行以下命令发送测试请求，验证模型调用：

# 测试基础对话（使用默认模型）
openclaw chat -q "请解释什么是云原生应用"
# 切换模型测试（Token Plan支持多模型切换）
openclaw chat -m qwen3.8-max-preview -q "帮我写一个Python异步爬虫代码"
# 查看支持的模型列表
openclaw models list
# 查看OpenClaw运行日志
openclaw logs

若返回正常的模型回复，且models list命令显示百炼订阅计划的所有模型，说明对接成功。

4.2.2 Web控制台验证

在浏览器中访问：http://ECS公网IP:1878，进入OpenClaw Web管理控制台。
在控制台输入测试问题（如“帮我生成一份ECS部署OpenClaw的文档大纲”），点击发送。
若控制台正常返回模型回复，且无报错信息，说明Web端对接成功。

五、OpenClaw高级配置与优化

5.1 模型调用参数优化

修改openclaw.json配置文件中的模型参数，提升生成效果与效率：

{
   
  "models": {
   
    "providers": {
   
      "bailian-token-plan": {
   
        "baseUrl": "xxx",
        "apiKey": "xxx",
        "models": ["xxx"],
        "defaultModel": "xxx",
        "temperature": 0.7,  # 控制生成随机性，0-1之间，值越大越随机
        "maxTokens": 8192,   # 最大生成Token数，根据模型上限调整
        "topP": 0.9,         # 核采样参数，控制生成多样性
        "frequencyPenalty": 0.1,  # 频率惩罚，减少重复内容
        "presencePenalty": 0.1   # 存在惩罚，鼓励新内容生成
      }
    }
  }
}

5.2 开启开机自启

为避免ECS重启后OpenClaw服务中断，配置开机自启：

# 创建OpenClaw系统服务文件
sudo vim /etc/systemd/system/openclaw.service

写入以下内容：

[Unit]
Description=OpenClaw AI Assistant Service
After=network.target

[Service]
Type=simple
User=root
ExecStart=/root/.nvm/versions/node/v24.x.x/bin/openclaw start
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

保存退出后，执行以下命令启用服务：

# 重新加载系统服务配置
sudo systemctl daemon-reload
# 启用开机自启
sudo systemctl enable openclaw
# 启动服务
sudo systemctl start openclaw
# 验证自启状态
sudo systemctl is-enabled openclaw  # 输出enabled即成功

5.3 安全配置优化

限制端口访问：在ECS安全组中，将1878、18789端口的授权对象修改为个人本地IP（如192.168.1.1/32），仅允许个人设备访问，避免公网滥用。
定期更新API Key：在百炼控制台定期重置API Key，提升安全性。
开启日志审计：配置OpenClaw日志存储至阿里云SLS日志服务，监控模型调用与服务运行状态。

六、常见问题与排查

6.1 API Key鉴权失败

问题：执行openclaw chat时返回Authentication failed或Invalid API Key。
排查：
1. 确认API Key为对应计划的专属Key（Coding Plan以sk-coding-开头，Token Plan以sk-sp-开头），未使用通用API Key。
2. 确认Base URL正确，且地域与API Key一致（均为华北2北京）。
3. 检查API Key权限是否为全部权限，避免权限不足无法调用模型。
4. 重新复制API Key，确保无空格、字符错误。

6.2 OpenClaw服务无法启动

问题：执行openclaw start时返回Failed to start service。
排查：
1. 检查Node.js版本是否为22.0+，执行node -v验证，低版本需升级。
2. 检查1878、18789端口是否被其他服务占用，执行sudo netstat -tuln | grep 1878查看。
3. 查看OpenClaw日志，执行openclaw logs，定位具体错误原因。
4. 重新安装OpenClaw，执行curl -fsSL https://openclaw.ai/install.sh | bash。

6.3 模型调用超时

问题：发送请求后长时间无响应，返回Request timeout。
排查：
1. 检查ECS实例网络是否正常，执行ping token-plan.cn-beijing.maas.aliyuncs.com验证连通性。
2. 确认安全组未限制出站请求，允许访问百炼API域名。
3. 调整maxTokens参数，降低单次请求Token数量，避免超时。
4. 更换ECS实例地域，选择离百炼服务更近的地域（如华北2北京）。

6.4 Web控制台无法访问

问题：浏览器访问http://ECS公网IP:1878时显示无法连接。
排查：
1. 检查ECS安全组是否开放1878端口，协议为TCP。
2. 确认OpenClaw服务正常运行，执行openclaw status查看状态。
3. 检查防火墙是否拦截端口，执行sudo systemctl stop firewalld临时关闭防火墙测试。
4. 更换浏览器或清除缓存，重新访问。

七、总结与后续拓展

通过本文的实操指南，开发者可快速完成阿里云ECS上OpenClaw的部署，并成功对接百炼Coding Plan或Token Plan，搭建起专属的AI助手环境。OpenClaw的多渠道交互、任务自动化能力，结合百炼的高性价比模型服务，可大幅提升代码开发、文档处理、智能对话等场景的效率，同时依托ECS的弹性扩展能力，满足不同规模的使用需求。

后续可进一步拓展功能：

多渠道集成：将OpenClaw对接钉钉、企业微信、飞书等即时通讯工具，实现AI助手多端交互。
技能扩展：安装OpenClaw第三方技能插件，如文件处理、数据查询、代码调试等，丰富功能场景。
成本优化：结合阿里云节省计划，降低ECS与百炼订阅计划的使用成本。
集群部署：通过阿里云容器服务Kubernetes版（ACK）部署OpenClaw集群，提升服务高可用性与并发处理能力。

从安装到验证：阿里云 ECS 云服务器部署 OpenClaw 并接入百炼Coding Plan/ Token Plan 教程

一、前期准备：ECS实例选型与环境配置

1.1 ECS实例选型与创建

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

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

1.2 ECS实例基础环境配置

二、OpenClaw部署：两种方案任选

2.1 方案一：云助手一键部署（推荐）

2.2 方案二：手动脚本部署（自定义配置）

三、阿里云百炼订阅计划开通与API Key获取

3.1 开通百炼订阅计划

3.2 获取专属API Key

3.2.1 获取Coding Plan API Key

3.2.2 获取Token Plan API Key

四、OpenClaw对接百炼订阅计划：配置与验证

4.1 配置OpenClaw接入凭证

4.1.1 编辑配置文件

4.1.2 写入百炼订阅计划配置

4.1.3 重启OpenClaw服务

4.2 验证对接是否成功

4.2.1 命令行验证

4.2.2 Web控制台验证

五、OpenClaw高级配置与优化

5.1 模型调用参数优化

5.2 开启开机自启

5.3 安全配置优化

六、常见问题与排查

6.1 API Key鉴权失败

6.2 OpenClaw服务无法启动

6.3 模型调用超时

6.4 Web控制台无法访问

七、总结与后续拓展

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

从安装到验证：阿里云 ECS 云服务器部署 OpenClaw 并接入百炼Coding Plan/ Token Plan 教程

一、前期准备：ECS实例选型与环境配置

1.1 ECS实例选型与创建

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

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

1.2 ECS实例基础环境配置

二、OpenClaw部署：两种方案任选

2.1 方案一：云助手一键部署（推荐）

2.2 方案二：手动脚本部署（自定义配置）

三、阿里云百炼订阅计划开通与API Key获取

3.1 开通百炼订阅计划

3.2 获取专属API Key

3.2.1 获取Coding Plan API Key

3.2.2 获取Token Plan API Key

四、OpenClaw对接百炼订阅计划：配置与验证

4.1 配置OpenClaw接入凭证

4.1.1 编辑配置文件

4.1.2 写入百炼订阅计划配置

4.1.3 重启OpenClaw服务

4.2 验证对接是否成功

4.2.1 命令行验证

4.2.2 Web控制台验证

五、OpenClaw高级配置与优化

5.1 模型调用参数优化

5.2 开启开机自启

5.3 安全配置优化

六、常见问题与排查

6.1 API Key鉴权失败

6.2 OpenClaw服务无法启动

6.3 模型调用超时

6.4 Web控制台无法访问

七、总结与后续拓展

热门文章

最新文章

相关电子书