OpenClaw阿里云轻量服务器部署与百炼Token接入指南
OpenClaw 作为一款开源的 AI 智能体框架,在自主任务执行、多工具调用和长上下文推理这些核心能力上,确实很有两把刷子。对于个人开发者和中小企业来说,用它来搭一套私有化的 AI 服务,性价比相当高。而把 OpenClaw 部署在阿里云轻量应用服务器上,正好兼顾了低成本、易操作和高稳定这几个关键点。再配上百炼 Token Plan,大模型能力的调用既稳定又便宜,不需要折腾复杂的环境配置,就能快速跑起来。下面会从部署前的准备、一键部署、百炼 Token Plan 配置、功能验证到常见坑的避让,一步步带大家完整走一遍流程。
一、部署前置准备
1. 账号与资质准备
部署 OpenClaw 的第一步,是搞定阿里云账号的实名认证。个人用户通过人脸核验就能快速完成,企业用户则需要提交企业资质认证。千万别小看这一步——如果账号没实名,轻量服务器买不了,百炼 Token Plan 也开通不了,API 密钥更无从谈起。要是团队使用,还可以创建子账号,分配轻量服务器和百炼服务的操作权限,方便多人协同。
2. 轻量服务器选型与配置
OpenClaw 对服务器硬件有硬性要求:内存至少 2GB,低于这个数服务直接启动失败。日常对话、简单检索这类基础场景,2 核 2G 的配置就够用了。但要是跑多并发任务、全网抓取、长文本分析之类的工作,建议上 2 核 4G 及以上,不然很容易出现内存溢出、服务闪退的尴尬。
服务器配置的具体步骤:
- 登录阿里云控制台,进入轻量应用服务器页面,点击“创建实例”。
- 镜像选择:应用镜像 → OpenClaw(Clawdbot) 2026 稳定版。这是官方专属镜像,Node.js 22、Docker 等全套环境都预装好了,不用手动去配依赖。
- 实例规格:推荐 2 核 4G 内存 + 40GB ESSD 云盘 + 5Mbps 带宽,性能和成本都比较均衡,能应对大多数场景。
- 地域选择:国内用户优先选华东 1(杭州)或华北 2(北京),延迟低,百炼 API 访问也稳定。如果需要全网搜索、网页抓取功能,那就选中国香港地域,避免一些访问限制。
- 设置 root 密码(按复杂度要求来),完成购买,等 3-5 分钟实例状态变成“运行中”,记下公网 IP。
要是手上已经有轻量服务器了,不用重新买,直接“重置系统”选 OpenClaw 专属镜像就行。不过要特别留意:重置会清空服务器上所有数据,重要文件一定记得提前备份。
3. 百炼 Token Plan 开通与 API 密钥获取
百炼 Token Plan 是 OpenClaw 调用大模型的核心支撑。它提供固定额度、低成本的模型调用服务,能有效避免按量计费带来的成本失控风险。
- 登录阿里云百炼控制台,进入 Token Plan 服务页面,根据使用需求选择基础版、专业版或企业版,支持单月订阅或连续包月,完成支付即可。
- 订阅生效后,进入“密钥管理”界面,点击“创建 API-Key”,会生成一个以 sk 开头的专属密钥。注意:只有生成瞬间会完整显示,一定要立即复制保存到本地,丢了就得重新创建。
- 关键提醒:API 密钥所属地域需要和轻量服务器地域保持一致,这样能降低网络延迟,避免调用失败。
二、OpenClaw 一键部署流程
1. 服务器初始化与端口放行
轻量服务器创建完成后,进入实例详情页,先完成基础初始化和端口配置:
- 远程连接:点击“远程连接”,用 Workbench 一键登录服务器,省去了配 SSH 密钥的麻烦。
- 端口放行:OpenClaw 默认使用 18789 端口提供 Web 服务,得在服务器防火墙里放行这个端口。在应用详情页点击“端口放通”,执行一键放行命令,开放 TCP 18789 端口。测试阶段可以允许 0.0.0.0/0 访问,稳定后建议限制来源 IP,提升安全性。
- 环境预检:执行
openclaw doctor命令,检查 Node.js 版本(需要 ≥22.0.0)、Docker 服务、端口占用等环境状态,确保一切正常。
2. OpenClaw 一键部署与初始化
OpenClaw 专属镜像已经预装了部署脚本,不需要手动安装依赖。直接执行以下命令就能完成一键部署:
# 进入OpenClaw工作目录
cd ~/.openclaw
# 执行一键部署脚本
bash deploy.sh
# 初始化配置向导
openclaw onboard
初始化配置向导的步骤:
- 选择工作区目录:默认是
~/.openclaw/workspace,直接回车确认就好。 - 模型厂商选择:选“阿里云百炼”,认证方式选“Token Plan”。
- 输入 API 密钥:粘贴提前保存好的百炼 Token Plan API-Key,回车确认。
- 选择默认模型:推荐
qwen3.5-plus,它能适配大多数任务场景,直接回车确认。 - 聊天通道与技能配置:新手可以先选“暂不配置”,后面按需添加,直接回车完成初始化。
3. 服务启动与访问 Token 生成
初始化完成后,启动 OpenClaw 网关服务并生成访问令牌:
# 启动OpenClaw网关服务
systemctl start openclaw-gateway
# 设置开机自启
systemctl enable openclaw-gateway
# 生成Web访问Token
openclaw doctor --generate-gateway-token
执行命令后,终端会显示访问地址与 Token,格式类似 http://<公网IP>:18789/?token=<生成的Token>。复制这个地址,后续用来访问 Web 控制台。
三、百炼 Token Plan 深度配置
1. 配置文件修改(进阶配置)
一键部署完成后,如果想自定义模型参数、调用额度、多模型切换等,可以修改配置文件 ~/.openclaw/openclaw.json:
{
"models": {
"providers": [{
"name": "aliyun-bailian",
"type": "bailian",
"apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
"baseUrl": "https://bailian.aliyuncs.com",
"models": [
{ "name": "qwen3.5-plus", "maxTokens": 8192, "temperature": 0.7 },
{ "name": "kimi-k2.5", "maxTokens": 16384, "temperature": 0.5 }
]
}],
"defaultModel": "qwen3.5-plus"
}
}
配置说明:
apiKey:替换为百炼 Token Plan 的 API 密钥。models:可以添加多个百炼支持的模型,比如 kimi-k2.5、glm-5 等,按需配置最大 Token 数和温度参数。defaultModel:设置默认调用模型,这样每次不用手动指定。
2. 额度监控与成本控制
百炼 Token Plan 是固定额度计费,需要定期盯一下调用情况,别让额度悄悄用光:
- 登录百炼控制台,进入 Token Plan 页面,可以查看月度调用额度、剩余额度以及调用明细。
- 在 OpenClaw 配置文件中设置
maxTokens参数,限制单轮对话的最大 Token 数,防止超额调用。 - 开启额度预警,当剩余额度低于 20% 时,控制台会自动提醒。这样就能及时续费或调整使用策略。
四、功能验证与使用
1. Web 控制台访问
复制之前生成的访问地址,在浏览器中打开,输入 Token 完成验证,就能进入 OpenClaw Web 控制台。控制台里包含对话界面、任务管理、模型配置、技能市场等模块,支持可视化操作。
2. 核心功能测试
部署完成后,用下面几个测试指令验证服务和模型调用是否正常:
- 基础交互测试:输入“你好,介绍一下 OpenClaw 的核心功能”。如果能正常回复,说明自然语言解析和模型调用没问题。
- 任务执行测试:输入“创建一个名为‘OpenClaw 测试’的 TXT 文件,内容为‘部署成功’”。如果返回文件创建成功,说明自动化任务执行正常。
- 多模型切换测试:输入“切换模型为 kimi-k2.5,帮我总结一篇技术文章”。验证多模型切换功能是否正常工作。
3. 技能扩展
OpenClaw 支持自定义技能扩展,可以通过技能市场安装文件处理、代码生成、数据查询等插件:
# 安装代码生成技能
openclaw skill install code-generator
# 安装文件处理技能
openclaw skill install file-manager
# 查看已安装技能
openclaw skill list
安装完成后,在对话中直接调用技能就行了,比如“帮我生成一个 Python 爬虫脚本”,就能实现对应功能。
五、避坑指南(高频问题与解决方案)
1. 端口不通,Web 页面无法访问
现象:输入访问地址后,浏览器提示“无法连接”或长时间加载。
原因:防火墙没放行 18789 端口,或者端口被其他服务占了。
解决方案:
# 检查防火墙规则
firewall-cmd --list-ports
# 放行18789端口
firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --reload
# 检查端口占用
netstat -tuln | grep 18789
# 如果被占用,修改配置文件端口
vim ~/.openclaw/config.yaml
# 修改port为其他未占用端口,重启服务
systemctl restart openclaw-gateway
2. 模型调用失败,无响应或报错
现象:页面能打开,但发送指令后 AI 没反应,提示“调用模型失败”“API 密钥无效”。
原因:API 密钥填错了、密钥过期、账户额度不足、地域不匹配。
解决方案:
- 重新核对 API 密钥,确保没有拼写错误,注意大小写。
- 登录百炼控制台,检查 Token Plan 是否在有效期内,剩余额度够不够。
- 确认轻量服务器地域与 API 密钥所属地域一致。如果不一致,重新生成密钥并配置。
3. 服务启动失败,提示内存不足
现象:执行 systemctl start openclaw-gateway 报错,提示“内存不足”“启动失败”。
原因:服务器内存低于 2GB,没法满足 OpenClaw 的运行需求。
解决方案:升级轻量服务器配置到 2 核 4G 及以上,或者关闭其他占用内存的服务。
4. WebSocket 连接失败,提示“disconnected (1006)”
现象:控制台频繁断开连接,提示 WebSocket 错误。
原因:Token 过期、服务没正常运行、Origin 没授权。
解决方案:
# 重新生成Token
openclaw doctor --generate-gateway-token
# 重启网关服务
systemctl restart openclaw-gateway
# 修改配置文件,添加允许的Origin
vim ~/.openclaw/openclaw.json
# 在allowedOrigins中添加访问域名或IP
"allowedOrigins": ["http://<公网IP>:18789"]
5. 技能安装失败,提示网络超时
现象:执行 openclaw skill install 命令,提示“下载超时”“网络连接失败”。
原因:服务器网络不稳定,或者没法访问海外技能源。
解决方案:
# 切换国内镜像源
npm config set registry https://registry.npmmirror.com
# 重新安装技能
openclaw skill install <技能名称>
六、总结
总的来说,用阿里云轻量服务器部署 OpenClaw,借助官方专属镜像可以实现一键部署,再搭配百炼 Token Plan 稳定接入大模型能力,整个过程不需要复杂的环境配置,即使是零基础的用户也能快速上手。部署时重点注意内存配置、端口放行、API 密钥的正确性以及地域匹配这些关键环节。遇到问题的话,参考上面的避坑指南逐一排查就行。部署完成后,OpenClaw 能够实现自动化任务执行、多模型切换、技能扩展等功能,无论是个人开发、企业办公还是数据处理场景,都能很好地满足需求——可以说是私有化 AI 服务的一个高效解决方案。


























