OpenClaw部署实战：阿里云ECS与Windows/macOS/Linux本地环境百炼Token Plan配置详细步骤教程-阿里云开发者社区

OpenClaw部署实战：阿里云ECS与Windows/macOS/Linux本地环境百炼Token Plan配置详细步骤教程

2026-06-16 274

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： OpenClaw作为开源可自托管的AI智能体执行框架，能让大模型从单纯对话升级为可执行文件处理、代码编写、流程自动化的数字助手，搭配阿里云百炼Token Plan可实现稳定、高性价比的大模型调用。本次部署覆盖阿里云ECS（Linux/Windows）与本地Windows、macOS、Linux全平台，核心依赖Node.js 22.x+、Git，且必须完成阿里云账号实名认证并获取百炼Token Plan专属API Key。

一、部署前核心准备（2026年最新）

OpenClaw作为开源可自托管的AI智能体执行框架，能让大模型从单纯对话升级为可执行文件处理、代码编写、流程自动化的数字助手，搭配阿里云百炼Token Plan可实现稳定、高性价比的大模型调用。本次部署覆盖阿里云ECS（Linux/Windows）与本地Windows、macOS、Linux全平台，核心依赖Node.js 22.x+、Git，且必须完成阿里云账号实名认证并获取百炼Token Plan专属API Key。

1.1 阿里云账号与百炼Token Plan开通

注册并登录阿里云账号，完成个人/企业实名认证（未实名无法获取API Key）。
进入阿里云百炼大模型控制台，找到Token Plan团队版订阅入口，选择适配坐席（个人/团队）完成订阅，新用户可享90天内各模型100万Token免费额度。
订阅后在百炼控制台「密钥管理」创建API Key，系统生成Access Key ID（API Key）与Access Key Secret，仅生成时可完整查看，务必立即复制保存到本地，切勿泄露。
记录Token Plan专属Base URL：https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1，该地址为OpenClaw对接百炼Token Plan的核心接口。

1.2 环境依赖检查

Node.js：必须安装22.0.0及以上版本，OpenClaw核心运行依赖该环境。
Git：用于拉取OpenClaw源码及依赖包，本地部署需提前安装。
网络：确保服务器/本地设备可正常访问阿里云百炼API与OpenClaw官方源，国内用户建议配置npm镜像加速。
阿里云部署AI Agent：OpenClaw/Hermes Agent全网最简单，只需两步，详情👉访问阿里云OpenClaw/Hermes一键部署专题页面 了解。

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

二、阿里云ECS部署OpenClaw（2026年官方流程）

阿里云ECS提供两种部署方式：一键应用镜像部署（新手首选）与手动命令行部署（进阶用户），两种方式均需提前创建ECS实例并配置安全组。

2.1 ECS实例创建与基础配置

登录阿里云ECS控制台，点击「创建实例」，基础配置如下：
- 镜像：选择应用镜像 → OpenClaw（Clawdbot）2026官方稳定版（Alibaba Cloud Linux 3），预装Node.js 22、Git、防火墙规则。
- 实例规格：2核4GiB内存 + 40GB ESSD云盘（禁止选择1核1GiB/2GiB，内存不足会导致部署失败）。
- 地域：中国香港（免备案，大模型API访问延迟低，稳定性最优）。
- 带宽：5Mbps固定带宽（满足日常访问、模型调用需求）。
网络与安全组配置：
- 自动分配公网IP：勾选「是」（必须，否则无法外部访问）。
- 安全组：勾选开放22端口（SSH）、开放18789端口（OpenClaw默认端口），系统自动配置入方向规则。
登录设置：选择密码登录，设置高强度密码（大小写+数字+符号，≥12位），牢记备用。
确认订单并完成支付，等待实例创建完成（约3-5分钟）。

2.2 一键应用镜像部署OpenClaw（新手推荐）

实例创建完成后，进入ECS实例详情页，找到「应用详情」模块。
点击「配置OpenClaw」区域的「一键配置」按钮：
- 模型厂商：选择「阿里云百炼」。
- 认证方式：选择「Token Plan」。
- API Key：粘贴Token Plan专属API Key（以sk-sp-开头）。
- Base URL：粘贴https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1。
点击「确定」，系统自动执行配置命令，写入OpenClaw配置文件。
点击「生成访问Token」，系统生成OpenClaw Web UI访问凭证，复制保存该Token（后续登录控制台必备）。
点击「打开网站页面」，输入生成的Token，即可进入OpenClaw控制台，完成部署。

2.3 手动命令行部署OpenClaw（进阶用户）

使用SSH工具连接ECS实例（用户名为root，密码为实例创建时设置的密码）：
```
ssh root@你的ECS公网IP
```

更新系统包并安装基础依赖：

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl wget lsof

安装Node.js 22.x（推荐使用nvm管理）：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
node --version # 验证版本，应显示v22.x.x

配置npm国内镜像（加速安装）：

npm config set registry https://registry.npmmirror.com

安装OpenClaw（官方一键脚本）：

curl -fsSL https://openclaw.ai/install.sh | bash

初始化OpenClaw配置：
```
openclaw onboard
```
按照向导提示：选择「手动配置」→ 模型厂商选「阿里云百炼」→ 认证方式选「Token Plan」→ 粘贴API Key与Base URL → 选择默认模型（推荐qwen3.7-max）→ 完成初始化。
启动OpenClaw网关服务：
```
openclaw gateway start
```

验证服务状态：

curl http://localhost:18789/api/health # 输出{"status":"ok"}即为成功

生成访问Token：

openclaw token generate # 复制输出的token，用于登录Web UI

访问OpenClaw控制台：浏览器输入http://ECS公网IP:18789，输入生成的Token即可登录。

三、本地Windows系统部署OpenClaw（2026年详细步骤）

3.1 环境准备与依赖安装

以管理员身份打开PowerShell（Win+X → 选择「Windows PowerShell(管理员)」）。
解除PowerShell执行策略限制（允许运行脚本）：
```
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```

安装Node.js 22.x（使用winget）：

winget install OpenJS.NodeJS --version 22.0.0

验证Node.js与npm安装：
```
node -v
npm -v
```

配置npm国内镜像：

npm config set registry https://registry.npmmirror.com

3.2 OpenClaw安装与配置

安装OpenClaw（官方PowerShell脚本）：

iwr -useb https://openclaw.ai/install.ps1 | iex

验证OpenClaw安装：
```
openclaw --version
```
初始化OpenClaw并配置百炼Token Plan：
```
openclaw onboard
```
向导步骤：
- 选择「YES」开始配置 → 引导方式选「手动」。
- 设置为本地网关，工作区目录默认回车。
- 模型厂商选择「阿里云百炼」→ 认证方式选「Token Plan」。
- 粘贴Token Plan API Key与Base URL → 选择默认模型（qwen3.7-max）。
- 跳过聊天通道与技能配置（选择「NO」）→ 完成初始化。
启动OpenClaw网关服务：
```
openclaw gateway start
```
生成访问Token：
```
openclaw token generate
```
访问本地控制台：浏览器输入http://127.0.0.1:18789，输入Token登录。

四、本地macOS系统部署OpenClaw（2026年详细步骤）

4.1 环境准备与依赖安装

打开终端（Command + 空格 → 输入「Terminal」→ 回车）。

安装Homebrew（macOS包管理器，已安装可跳过）：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装Node.js 22.x：
```
brew install node@22
```
验证Node.js安装：
```
node -v
npm -v
```

配置npm国内镜像：

npm config set registry https://registry.npmmirror.com

4.2 OpenClaw安装与配置

安装OpenClaw（官方一键脚本，推荐）：

curl -fsSL https://openclaw.ai/install.sh | bash

国内用户可使用加速脚本：

curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

验证安装：
```
openclaw --version
```
初始化并配置百炼Token Plan：
```
openclaw onboard
```
按照向导完成配置：选择阿里云百炼 → Token Plan → 粘贴API Key与Base URL → 选择模型 → 完成初始化。
启动网关服务：
```
openclaw gateway start
```

生成访问Token并登录控制台：

openclaw token generate
# 访问http://127.0.0.1:18789，输入Token登录

五、本地Linux系统（Ubuntu/Debian）部署OpenClaw（2026年详细步骤）

5.1 环境准备与依赖安装

打开终端（Ctrl+Alt+T）。

更新系统包并安装基础工具：

sudo apt update
sudo apt install -y curl git nodejs npm

安装nvm并配置Node.js 22.x：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

验证Node.js版本：
```
node --version
```

配置npm镜像：

npm config set registry https://registry.npmmirror.com

5.2 OpenClaw安装与配置

安装OpenClaw（官方脚本）：

curl -fsSL https://openclaw.ai/install.sh | bash

验证安装：
```
openclaw --version
```
初始化配置百炼Token Plan：
```
openclaw onboard
```
配置步骤同macOS：选择阿里云百炼 → Token Plan → 输入API Key与Base URL → 选择模型 → 完成。
启动服务：
```
openclaw gateway start
```

生成Token并访问控制台：

openclaw token generate
# 浏览器访问http://127.0.0.1:18789，输入Token登录

六、OpenClaw配置百炼Token Plan进阶命令（全平台通用）

6.1 手动修改配置文件（推荐进阶用户）

找到OpenClaw配置文件路径：~/.openclaw/config.json（Linux/macOS）或C:\Users\用户名\.openclaw\config.json（Windows）。

编辑配置文件，添加/修改百炼Token Plan配置：

{
     
  "models": {
     
    "providers": {
     
      "bailian": {
     
        "apiKey": "你的Token Plan API Key",
        "baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
        "enabled": true
      }
    }
  },
  "agents": {
     
    "defaults": {
     
      "model": {
     
        "primary": "bailian/qwen3.7-max"
      }
    }
  }
}

重启OpenClaw服务使配置生效：
```
openclaw gateway restart
```

6.2 命令行快速配置（全平台通用）

设置百炼API Key：

openclaw config set models.providers.bailian.apiKey "sk-sp-xxxxxx"

设置百炼Base URL：

openclaw config set models.providers.bailian.baseUrl "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1"

设置默认模型：

openclaw config set agents.defaults.model.primary "bailian/qwen3.7-max"

重启服务并验证：

openclaw gateway restart
curl http://localhost:18789/api/health # 验证服务状态

七、常见问题与避坑指南（2026年最新）

部署失败：Node.js版本过低
- 原因：OpenClaw要求Node.js 22.x+，低版本会导致依赖安装失败。
- 解决：使用nvm安装22.x版本，命令：nvm install 22 && nvm use 22。
无法访问OpenClaw控制台
- 原因：ECS安全组未开放18789端口，或本地防火墙拦截端口。
- 解决：ECS安全组添加入方向规则，开放18789端口；本地关闭防火墙或添加端口例外。
百炼Token Plan调用失败
- 原因：API Key错误、Base URL填写错误、Token Plan未生效或额度耗尽。
- 解决：核对API Key与Base URL；检查百炼控制台Token Plan状态与剩余额度；确保使用Token Plan专属密钥（非按量计费密钥）。
OpenClaw服务启动失败
- 原因：内存不足、端口被占用、配置文件错误。
- 解决：升级ECS实例规格至2核4GiB+；检查18789端口是否被占用（lsof -i:18789）；核对config.json配置格式是否正确。
国内网络安装缓慢
- 原因：官方源在境外，国内访问速度慢。
- 解决：使用国内加速脚本安装OpenClaw，配置npm国内镜像（https://registry.npmmirror.com）。

八、总结与后续使用

本次教程完整覆盖阿里云ECS（Linux/Windows）与本地Windows、macOS、Linux全平台部署OpenClaw的详细步骤，以及百炼Token Plan的两种配置方式（一键配置与手动命令配置）。部署完成后，可通过OpenClaw控制台创建AI智能体，调用阿里云百炼Qwen系列模型（如qwen3.7-max、qwen3.7-plus）实现文件处理、代码编写、流程自动化等功能。

后续使用中，可通过openclaw gateway start/stop/restart管理服务状态，通过openclaw token generate生成新的访问凭证，通过百炼控制台实时查看Token消耗与剩余额度。如需扩展功能，可安装OpenClaw技能插件，实现网页抓取、PDF转换、邮件发送等高级能力。

OpenClaw部署实战：阿里云ECS与Windows/macOS/Linux本地环境百炼Token Plan配置详细步骤教程

一、部署前核心准备（2026年最新）

1.1 阿里云账号与百炼Token Plan开通

1.2 环境依赖检查

二、阿里云ECS部署OpenClaw（2026年官方流程）

2.1 ECS实例创建与基础配置

2.2 一键应用镜像部署OpenClaw（新手推荐）

2.3 手动命令行部署OpenClaw（进阶用户）

三、本地Windows系统部署OpenClaw（2026年详细步骤）

3.1 环境准备与依赖安装

3.2 OpenClaw安装与配置

四、本地macOS系统部署OpenClaw（2026年详细步骤）

4.1 环境准备与依赖安装

4.2 OpenClaw安装与配置

五、本地Linux系统（Ubuntu/Debian）部署OpenClaw（2026年详细步骤）

5.1 环境准备与依赖安装

5.2 OpenClaw安装与配置

六、OpenClaw配置百炼Token Plan进阶命令（全平台通用）

6.1 手动修改配置文件（推荐进阶用户）

6.2 命令行快速配置（全平台通用）

七、常见问题与避坑指南（2026年最新）

八、总结与后续使用

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

OpenClaw部署实战：阿里云ECS与Windows/macOS/Linux本地环境 百炼Token Plan配置详细步骤教程

一、部署前核心准备（2026年最新）

1.1 阿里云账号与百炼Token Plan开通

1.2 环境依赖检查

二、阿里云ECS部署OpenClaw（2026年官方流程）

2.1 ECS实例创建与基础配置

2.2 一键应用镜像部署OpenClaw（新手推荐）

2.3 手动命令行部署OpenClaw（进阶用户）

三、本地Windows系统部署OpenClaw（2026年详细步骤）

3.1 环境准备与依赖安装

3.2 OpenClaw安装与配置

四、本地macOS系统部署OpenClaw（2026年详细步骤）

4.1 环境准备与依赖安装

4.2 OpenClaw安装与配置

五、本地Linux系统（Ubuntu/Debian）部署OpenClaw（2026年详细步骤）

5.1 环境准备与依赖安装

5.2 OpenClaw安装与配置

六、OpenClaw配置百炼Token Plan进阶命令（全平台通用）

6.1 手动修改配置文件（推荐进阶用户）

6.2 命令行快速配置（全平台通用）

七、常见问题与避坑指南（2026年最新）

八、总结与后续使用

热门文章

最新文章

相关电子书

OpenClaw部署实战：阿里云ECS与Windows/macOS/Linux本地环境百炼Token Plan配置详细步骤教程