OpenClaw是一款轻量化AI智能体框架，支持任务自动化、工具调度与记忆持久化，可深度集成阿里云百炼大模型服务。阿里云计算巢提供零代码、一键式部署能力，无需手动配置复杂环境，新手也能快速完成OpenClaw部署。本教程从部署前准备、计算巢实例创建、百炼API Key配置、端口放行、服务启动、功能验证到常见问题排查，提供保姆级全流程指导，确保顺利搭建稳定的私有化AI服务。
一、部署前核心准备
1.1 账号与权限要求
- 阿里云账号：需完成个人/企业实名认证，未实名无法创建计算巢实例与获取API Key。
- RAM权限：主账号需为子账号授予计算巢、ECS、VPC相关权限，确保可创建与管理资源。
- 百炼服务开通：提前开通阿里云百炼服务，获取模型调用权限。
1.2 资源规格与地域选择
- 实例规格：推荐2核4GiB内存、40GB ESSD系统盘，最低配置2核2GiB内存（仅测试场景）。
- 地域选择：优先选择中国香港、新加坡、美国弗吉尼亚，内地地域联网搜索功能受限。
- 网络配置：自动分配公网IP，使用计算巢默认安全组（已放行22、18789端口）。
零基础部署AI Agent：OpenClaw/Hermes Agent喂饭级步骤流程
第一步：👉点击打开访问阿里云OpenClaw/Hermes Agent一键部署专题页面。
👉访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换，用于多模态模型灵活调用，实现多模型、多工具、多场景下的额度共享与统一管理，兼顾灵活性、稳定性与安全性，大幅降低企业使用大模型的门槛与成本。
第二步：👉打开选择阿里云轻量应用服务器，配置参考如下：
- 镜像：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，阿里云百炼Coding Plan每天两场抢购活动，从按tokens计费升级为按次收费，可以进一步节省费用！
- 购买后，在控制台生成API Key。注：这里复制并保存好你的API Key，后面要用。
- 回到轻量应用服务器-控制台，单击服务器卡片中的实例 ID，进入服务器概览页。
- 在服务器概览页面单击应用详情页签，进入服务器详情页面。
- 端口放通在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw 服务运行端口的防火墙。
- 这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key，直接选择就可以。
- 获取访问地址单击访问 Web UI 面板下的执行命令，获取 OpenClaw WebUI 的地址。
1.3 获取百炼API Key（核心凭证）
- 登录阿里云百炼控制台，进入“API密钥管理”页面。
- 点击“创建API密钥”，选择默认工作区，生成专属API Key（格式：sk-xxx）。
- 复制并妥善保存API Key，避免泄露；确保API Key地域与计算巢实例地域一致。
- 检查百炼Token Plan/Coding Plan是否生效，确保有足够调用额度。
二、计算巢一键部署OpenClaw（推荐新手）
2.1 进入部署页面
- 登录阿里云控制台，进入计算巢服务目录。
- 搜索“OpenClaw”或“Clawdbot”，找到官方认证的OpenClaw社区版模板。
- 点击“立即部署”，进入“创建服务实例”页面。
2.2 填写部署参数（必填项）
- 服务实例名称：以英文字母开头，长度≤64字符，支持数字、字母、短划线、下划线。
- 地域：选择中国香港/新加坡/美国弗吉尼亚。
- 实例类型：选择2核4GiB内存规格（ecs.e-c1m2.large及以上）。
- 付费类型：按量付费（按时长计费）或包年包月，按需选择。
- 实例密码：设置符合安全规范的root密码（大小写+数字+特殊符号）。
- 百炼API-Key：粘贴提前获取的API Key。
- 主模型：默认选择qwen3.7-max或qwen3.5-plus。
- 网络配置：勾选自动分配公网IP，使用默认VPC与交换机。
2.3 确认订单并创建实例
- 参数填写完成后，查看询价明细，确认无误点击“下一步：确认订单”。
- 勾选“我已阅读并同意服务协议”，点击“立即创建”。
- 等待部署完成（约2-3分钟），计算巢自动完成ECS创建、依赖安装、服务配置。
三、手动部署OpenClaw（适合自定义配置）
3.1 登录计算巢ECS实例
- 部署完成后，在计算巢服务实例详情页获取ECS公网IP与登录密码。
- 通过Workbench或SSH工具远程连接：
ssh root@ECS公网IP
3.2 安装系统依赖
# 更新系统
sudo yum update -y
# 安装基础依赖
sudo yum install -y git python3 python3-pip nodejs npm
# 配置软链接
sudo ln -s /usr/bin/python3 /usr/bin/python
sudo ln -s /usr/bin/pip3 /usr/bin/pip
3.3 安装OpenClaw
# 官方一键安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash
# 国内镜像加速（可选）
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
安装完成后，执行版本验证：
openclaw --version
正常输出版本号（如v2026.3.12），代表安装成功。
3.4 初始化配置
执行交互式配置向导：
openclaw onboard
按照提示配置：
- 运行模式：选择QuickStart（快速启动）。
- 模型提供商：选择bailian（阿里云百炼）。
- 输入百炼API Key：粘贴复制的密钥。
- 选择默认模型：qwen3.7-max。
- 服务端口：默认18789，可自定义。
- 开启记忆持久化：选择yes。
四、端口放行与网络配置
4.1 计算巢安全组配置
- 进入计算巢服务实例详情页，找到关联的ECS安全组。
- 编辑入方向规则，确保已放行：
- TCP 22端口（SSH远程连接）
- TCP 18789端口（OpenClaw Web控制台）。
- 保存规则，等待生效（约1分钟）。
4.2 本地防火墙放行
# Alibaba Cloud Linux/CentOS
sudo firewall-cmd --add-port=18789/tcp --permanent
sudo firewall-cmd --reload
# Ubuntu
sudo ufw allow 18789/tcp
sudo ufw reload
五、服务启动与后台运行
5.1 前台启动（测试用）
openclaw gateway
正常日志显示“Server listening on 0.0.0.0:18789”“Model loaded successfully”。
5.2 后台常驻（生产用）
# nohup方式
nohup openclaw gateway > ~/.openclaw/logs/gateway.log 2>&1 &
# systemd方式（推荐）
sudo tee /etc/systemd/system/openclaw-gateway.service <<EOF
[Unit]
Description=OpenClaw Gateway Service
After=network.target
[Service]
User=root
WorkingDirectory=/root
ExecStart=/usr/local/bin/openclaw gateway
Restart=always
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl start openclaw-gateway
sudo systemctl enable openclaw-gateway
sudo systemctl status openclaw-gateway
服务状态显示“active (running)”，代表后台运行成功。
六、功能验证与使用
6.1 Web控制台访问
浏览器输入：http://ECS公网IP:18789，访问OpenClaw Web控制台，查看服务状态、日志、配置信息。
6.2 命令行交互测试
# 基础任务测试
openclaw run "创建test.txt文件，写入'OpenClaw部署成功'，返回文件路径"
# 模型调用测试
openclaw run "总结：OpenClaw是轻量化AI智能体框架，支持任务自动化与模型调用"
验证结果：
- 任务执行成功，文件生成正确。
- 模型返回准确总结，无调用失败。
6.3 API接口验证
curl -X POST http://ECS公网IP:18789/api/chat/completions \
-H "Content-Type: application/json" \
-d '{
"model": "bailian/qwen3.7-max",
"messages": [{"role": "user", "content": "你好"}]
}'
正常返回模型响应，无401/503错误。
七、常见问题排查
7.1 部署失败（卡81%）
- 原因：镜像拉取失败、网络异常、资源不足。
- 解决：更换地域、检查网络、升级实例规格。
7.2 模型调用失败（401/503）
- 原因：API Key错误、地域不匹配、百炼额度耗尽。
- 解决：核对API Key、确保地域一致、检查百炼额度。
7.3 Web控制台无法访问
- 原因：安全组未放行端口、服务未启动、公网IP异常。
- 解决：检查安全组、重启服务、确认公网IP正常。
7.4 服务重启后记忆丢失
- 原因：未开启记忆持久化、配置文件错误。
- 解决：执行
openclaw onboard重新开启记忆功能。
八、总结
阿里云计算巢部署OpenClaw有一键部署与手动部署两种方案，新手推荐使用官方模板一键部署，零代码快速完成；进阶用户可选择手动部署，自定义配置。核心步骤包括账号准备、API Key获取、实例创建、端口放行、服务启动与功能验证。部署完成后，可通过Web控制台、命令行、API接口三种方式使用OpenClaw，实现AI任务自动化、工具调度与记忆持久化。日常使用中，建议定期检查服务状态、更新配置，遇到问题可通过日志快速排查，确保智能体稳定运行。
