阿里云ECS云服务器搭建OpenClaw集成百炼Token Plan教程与问题排查_AI热点日报

OpenClaw 是一个开源、可自托管的 AI 智能体执行框架，它能将大模型从单纯对话升级为能处理文件、编写代码、完成流程自动化的数字助手。在阿里云 ECS 上部署 OpenClaw，再集成百炼 Token Plan，就能获得稳定且性价比很高的大模型调用能力。下面从准备到部署、配置、验证、运维，一步

OpenClaw 是一个开源、可自托管的 AI 智能体执行框架，它能将大模型从单纯对话升级为能处理文件、编写代码、完成流程自动化的数字助手。在阿里云 ECS 上部署 OpenClaw，再集成百炼 Token Plan，就能获得稳定且性价比很高的大模型调用能力。下面从准备到部署、配置、验证、运维，一步步拆解每个操作，同时梳理高频问题与解决方案，确保零基础的朋友也能顺利完成搭建。

一、部署前核心准备

部署前需要完成账号、服务器、工具与凭证的准备，避免后面流程卡壳。

阿里云账号与实名认证：注册阿里云账号并完成个人或企业实名认证。未实名无法使用云服务，也无法获取百炼 API Key。确保账号没有欠费、没有风控限制，能正常购买 ECS 以及开通百炼服务。
ECS 实例选型与配置：
- 系统选择：优先 Ubuntu 22.04 LTS，兼容性与稳定性最好。CentOS 7+ 或 Windows Server 2019+ 也可以。
- 配置要求：内存 ≥2GB（推荐 4GB+），存储 ≥20GB（ESSD 云盘优先，能提升读写速度），带宽 ≥1Mbps，满足 OpenClaw 运行和模型调用的需求。
- 地域选择：国内地域需要 ICP 备案，海外地域（如中国香港、美国弗吉尼亚）则不需要备案，而且联网搜索功能不受限，可以根据业务需求来选。
- 安全组配置：开放 8080（OpenClaw Web UI 端口）和 22（SSH 远程连接）端口，确保外部可以访问服务。
必备工具准备：准备好远程连接工具（如 FinalShell、Xshell）用于 SSH 登录 ECS；准备好文本编辑器保存 API Key、访问 Token 等敏感信息；安装 Git、Node.js 22.x+（一键部署脚本会自动安装）。
百炼 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 一键部署专题页面。

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

镜像：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 的套餐。它把按 tokens 计费升级为按次收费，能进一步节省费用。

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

方式一：一键脚本安装（推荐）

远程登录 ECS：使用 SSH 工具连接 ECS 公网 IP，输入账号密码登录，默认账号为 root。
执行一键安装脚本：在终端输入以下命令，脚本会自动检测系统、安装 Node.js、Git 等依赖，并完成 OpenClaw 安装与初始化。
```
 curl -fsSL https://openclaw.ai/install.sh | bash
```
完成初始化配置：安装完成后，脚本自动启动引导程序，按提示完成基础配置，包括设置管理员密码、选择模型提供商（先选自定义，后面再配置百炼）、安装核心技能等。引导程序会自动启动 Gateway 后台服务，并在浏览器打开 OpenClaw 控制页面（http://ECS公网IP:8080）。
验证安装：在终端执行 openclaw --version 查看版本，执行 openclaw doctor 检查环境，执行 openclaw gateway status 查看服务状态，确保服务正常运行。

方式二：源码安装（适合自定义配置）

安装依赖：在 ECS 终端执行以下命令，安装 Node.js、pnpm、Git。

 sudo apt update && sudo apt install -y nodejs npm git
 sudo npm install -g pnpm

克隆源码：执行命令克隆 OpenClaw 源码仓库。

 git clone https://github.com/openclaw/openclaw.git
 cd openclaw

安装依赖并构建：执行以下命令安装项目依赖并构建项目。
```
 pnpm install && pnpm build && pnpm ui:build
```
启动服务：执行命令启动 OpenClaw 服务。
```
 pnpm start
```
设置开机自启：为了避免服务器重启后服务中断，需要配置开机自启。创建自启文件，写入启动命令，添加执行权限。
```
 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 两种配置方式。

方式一：命令行配置（高效快捷）

编辑配置文件：执行命令打开 OpenClaw 配置文件。
```
 nano ~/.openclaw/openclaw.json
```

写入百炼配置：在配置文件中添加以下内容，将 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 }
 }

重启服务：保存配置文件后，执行命令重启 OpenClaw 服务，使配置生效。
```
 openclaw gateway restart
```

方式二：Web UI 配置（可视化操作）

访问 Web UI：在浏览器输入 http://ECS公网IP:8080，使用初始化时设置的管理员密码登录。
进入模型配置：点击页面右上角“Settings”，选择“Models”选项卡。
添加百炼提供商：点击“Add Provider”，选择“Custom”，填写以下信息：
- Provider Name：bailian-token-plan
- Base URL：https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
- API Key：Token Plan 专属 API Key
- Default Model：qwen3.7-max（或其他支持模型）
启用 Token Plan：切换至“Token Plan”选项卡，开启“Enable Token Plan”开关，保存配置。
验证配置：返回主页，发送测试指令（比如“生成一个 Python Hello World 程序”），检查是否正常返回结果，并且百炼 Token Plan 额度正常消耗。

四、功能验证与基础使用

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

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

五、高频问题与避坑指南

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

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

六、运维与优化建议

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

七、总结

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