OpenClaw部署实战：阿里云ECS与本地Windows/macOS/Linux百炼Token配置教程

时间：2026-06-17 15:05

一、部署前核心准备（2026年最新） OpenClaw作为一个开源、可自托管的AI智能体执行框架，本质上在让大模型从单纯的对话能力跃升为一个能干实事的数字助理——文件处理、代码编写、流程自动化，这些都成了家常便饭。搭配阿里云百炼Token Plan，又能实现稳定且性价比极高的大模型调用。这次部署方

一、部署前核心准备（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，用于拉取源码和依赖包。网络方面，确保服务器或本地设备能够正常访问阿里云百炼API和OpenClaw官方源，国内用户最好提前配置npm镜像加速，省得安装时等得心焦。

Token Plan的优势在于成本最低，且支持多模型切换。这使得多模态模型可以灵活调用，在多个模型、工具和场景下实现额度共享与统一管理，兼顾了灵活性、稳定性和安全性。对于企业来说，使用大模型的门槛和成本也因此大幅降低。

二、阿里云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 https://localhost:18789/api/health # 输出{"status":"ok"}即为成功

生成访问Token：

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

最后，在浏览器输入https://ECS公网IP:18789，再输入生成的Token即可登录OpenClaw控制台。

三、本地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 --version

初始化OpenClaw并配置百炼Token Plan：

openclaw onboard

向导步骤中：选择「YES」开始配置 → 引导方式选「手动」。设置为本地网关，工作区目录保持默认即可。模型厂商选择「阿里云百炼」→ 认证方式选「Token Plan」。粘贴Token Plan API Key与Base URL → 选择默认模型（qwen3.7-max）。跳过聊天通道与技能配置（选「NO」）→ 完成初始化。

启动网关服务：

openclaw gateway start

生成访问Token：

openclaw token generate

然后打开浏览器，访问https://127.0.0.1:18789，输入Token登录即可。

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

4.1 环境准备与依赖安装

打开终端（Command 空格 → 输入「Terminal」→ 回车）。如果还没有安装Homebrew，先执行这个命令：

/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
# 访问https://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
# 浏览器访问https://127.0.0.1:18789，输入Token登录

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

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

OpenClaw配置文件路径在~/.openclaw/config.json（Linux/macOS）或C:Users用户名.openclawconfig.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 https://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转换、邮件发送等更高级的能力。

来源：https://developer.aliyun.com/article/1741722

OpenClaw

上一篇阿里云百炼TokenPlan计费规则解析1000积分对应Token数量与使用场景 下一篇本地消息表+消息队列实现跨境电商独立站数据同步最终一致性

本站内容用于信息整理与展示，如有侵权或内容问题请及时联系处理。