OpenClaw作为开源AI智能体框架,依靠灵活可扩展的技能体系、多平台消息对接、自主任务执行能力,成为个人开发者、小型团队搭建专属AI助手的主流选择。它可以自主读取本地文件、执行脚本、访问网页、拆解复杂多步骤任务,实现办公自动化、代码辅助、信息搜集等场景。计算巢服务可以把实例创建、环境依赖、应用安装全部自动化处理,不用手动处理繁琐的编译、环境配置;百炼平台的Coding Plan、Token Plan两套订阅方案,分别面向代码开发、通用多模态推理场景,为OpenClaw提供稳定的大模型算力底座。本文完整覆盖部署前准备、轻量应用服务器部署、计算巢模板一键部署、订阅开通、API密钥获取、OpenClaw配置对接、功能验证、运维扩展、问题排查全链路,附带大量可直接复制运行的命令,帮助使用者快速完成从资源开通到智能体正常可用的完整流程。
一、部署前期准备:账号、权限与前置条件
正式部署应用之前,需要完成账号、服务开通、权限配置,避免后续部署、调用出现权限报错。
账号注册与实名认证
登录阿里云控制台完成账号注册,必须完成实名认证,未做实名认证的账号无法使用计算巢、百炼大模型相关服务。推荐支付宝授权扫脸完成认证,流程简便。使用按量付费模式时,账户余额建议预留不低于100元,防止部署阶段余额不足导致资源创建失败。开通百炼大模型服务
控制台搜索百炼进入大模型服务平台,点击立即开通,开通本身不收取费用。开通之后就可以访问模型体验、密钥管理、订阅管理页面,后续生成API密钥、购买Coding Plan与Token Plan都依赖该服务。详情👉访问阿里云百炼大模型服务平台页面 了解。


RAM子账号权限配置(可选)
如果日常使用RAM子账号操作,主账号需要在RAM控制台授予一组权限策略,分别为AliyunBSSFullAccess、AliyunComputeNestUserFullAccess、AliyunDashScopeFullAccess、AliyunTokenPlanFullAccess。缺少其中任意权限,子账号会出现部署失败、无法读取订阅密钥、调用模型鉴权失败等问题。
选型小提示:OpenClaw有两套主流部署路径。第一种是轻量应用服务器预装镜像,适合零基础,可视化点击操作居多;第二种是计算巢模板部署,适合需要自定义实例规格、后续做二次开发的使用者。内存最低要求2GiB,推荐2核4G起步,高并发场景选择4核8G。
二、方案一:轻量应用服务器预装镜像快速部署
阿里云部署AI Agent:OpenClaw/Hermes Agent全网最简单,只需两步,详情👉访问阿里云OpenClaw/Hermes一键部署专题页面了解。








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




轻量应用服务器提供预制OpenClaw的应用镜像,开箱预置运行环境,大部分操作在控制台可视化完成,适合新手。
实例购买参数设置
进入轻量应用服务器购买页面,应用镜像选择OpenClaw;内存至少2GiB;地域需要注意,如果需要完整联网搜索能力,优先选择海外地域;购买时长按需选择。已经拥有服务器实例的,可以通过重置系统磁盘,重新选择该预制镜像。百炼控制台生成API‑Key
进入百炼控制台,打开密钥管理,点击创建API‑Key,复制保存密钥字符串。如果要使用订阅套餐,需要先完成Coding Plan或者Token Plan订阅,再生成套餐专属API‑Key。注意:Coding Plan、Token Plan、普通按量付费的API‑Key互相独立,不可混用。实例控制台完成初始化配置
进入轻量实例详情,切换应用详情标签页。
- 执行端口放通命令:开放18789端口,该端口是OpenClaw WebUI服务端口;
- 执行配置API‑Key命令,粘贴百炼订阅生成的密钥;
- 执行初始化命令生成Web访问Token凭证;
- 执行获取访问地址命令,拿到WebUI访问链接。
完成之后浏览器打开该地址,输入访问Token,就可以进入OpenClaw交互界面。
三、方案二:计算巢模板一键部署OpenClaw
计算巢将ECS实例创建、操作系统初始化、依赖包安装、OpenClaw部署全部封装成模板,5‑10分钟完成整套环境,适合需要更高弹性、自定义实例配置的场景。
搜索部署模板
进入计算巢服务控制台,搜索OpenClaw官方社区部署模板。模板内置操作系统、全套依赖、基础配置,不需要手动编译源码。填写部署参数
- 服务名称:自定义,例如
OpenClaw‑Agent‑Demo - 地域:优先选择网络延迟低的地域,如华东、华北;
- 实例规格:入门2核4G,高并发业务4核8G;
- 设置管理员登录密码,妥善保管,用于SSH远程登录;
- 安全组端口:模板会自动放行18789端口;
其余参数保持默认即可。
确认订单,勾选协议,点击立即创建。系统自动创建云服务器、初始化环境、部署应用,等待几分钟,实例状态变为部署完成。
- 远程登录实例验证安装结果
在实例详情页,使用Workbench远程连接,输入管理员密码进入终端,执行下面命令:
输出#切换root用户 sudo su root #查看OpenClaw版本,确认安装成功 openclaw --version #启动网关核心服务 openclaw gateway start #查看网关运行状态 systemctl status openclaw‑gatewayactive (running),代表网关服务正常运行。
四、百炼两套订阅计划开通与API密钥获取
Coding Plan与Token Plan定位完全不同,需要根据业务场景选择。
- Coding Plan:按请求次数计费,适合高频代码生成、脚本调试场景;
- Token Plan:按Credits折算Token消耗,适合通用问答、长文档、图像视频多模态业务。
4.1 Coding Plan订阅与密钥获取
- 在百炼控制台,计费管理进入Coding Plan订阅页面,选择档位完成支付;
- 进入API密钥管理页面,创建套餐专属API‑Key,格式一般为
sk‑sp‑xxxx; - 记录Coding Plan兼容OpenAI接口的BaseURL:
https://coding.dashscope.aliyuncs.com/v1。
4.2 Token Plan订阅与密钥获取
- 计费管理进入Token Plan页面,选择个人或者团队版,选择档位完成订阅;
- 团队版需要先分配席位,再生成专属API‑Key;
- 记录Token Plan兼容接口BaseURL:
https://token‑plan.cn‑beijing.maas.aliyuncs.com/compatible‑mode/v1。
重要提醒:两套订阅生成的密钥不能混用,Coding Plan密钥只能访问Coding Plan接口,Token Plan密钥只能访问Token Plan接口。
五、OpenClaw配置对接Coding Plan、Token Plan
部署完成之后,修改OpenClaw配置文件,接入两套订阅的模型服务,两套方案可以共存,按需切换模型。
远程登录服务器,进入配置目录
sudo su root cd ~/.openclaw ls可以看到核心配置文件
openclaw.json。配置Coding Plan(代码开发场景)
编辑openclaw.json,新增provider配置:{ "models": { "providers": { "bailian_coding": { "baseUrl": "https://coding.dashscope.aliyuncs.com/v1", "apiKey": "sk‑sp‑xxxxxxxxxxxxxxxxxxxxxxxx", "models": [ { "id": "qwen‑coder‑turbo", "name": "Qwen Coder Turbo" }, { "id": "qwen‑turbo", "name": "Qwen Turbo" } ], "timeout": 30 } } } }配置Token Plan(通用AI、多模态场景)
继续在providers节点下增加Token Plan配置,与coding配置同级:"bailian_token": { "baseUrl": "https://token‑plan.cn‑beijing.maas.aliyuncs.com/compatible‑mode/v1", "apiKey": "sk‑sp‑xxxxxxxxxxxxxxxxxxxxxxxx", "models": [ { "id": "qwen‑max", "name": "Qwen Max" }, { "id": "qwen‑long", "name": "Qwen Long" } ], "timeout": 30 }设置模型优先级与默认模型
"agents": { "defaults": { "model": { "primary": "bailian_coding/qwen‑coder‑turbo" } } }, "models": { "priority": ["bailian_coding","bailian_token"] }重载配置让修改生效
openclaw config reload
安全优化建议:不要把密钥明文写进配置文件,可以使用环境变量保存密钥。示例:
#会话临时生效 export DASHSCOPE_API_KEY_CODING="sk‑sp‑xxxxxx" export DASHSCOPE_API_KEY_TOKEN="sk‑sp‑xxxxxx" #写入bashrc永久生效 echo "export DASHSCOPE_API_KEY_CODING=sk‑sp‑xxxxxx" >> ~/.bashrc echo "export DASHSCOPE_API_KEY_TOKEN=sk‑sp‑xxxxxx" >> ~/.bashrc source ~/.bashrc配置文件内apiKey字段改为
{"source":"env","id":"DASHSCOPE_API_KEY_CODING"}读取环境变量密钥。
六、功能验证、WebUI启动、开机自启配置
配置完成,需要验证模型调用是否正常,同时配置服务开机自动启动。
设置网关开机自启
systemctl enable openclaw‑gateway #查看是否开启成功,输出enabled代表成功 systemctl is‑enabled openclaw‑gateway进入OpenClaw交互终端测试模型调用
openclaw #测试代码模型 请写一个Python快速排序函数 #测试通用大模型 简单介绍OpenClaw智能体框架模型正常返回结果,说明对接订阅套餐成功。
启动WebUI可视化管理界面
openclaw webui start --port 18789浏览器访问
http://服务器公网IP:18789,输入访问Token,即可进入可视化界面,可以管理技能、会话、模型切换。
七、扩展能力:ClawHub技能市场、多消息网关配置
OpenClaw的能力依靠技能扩展,ClawHub是官方技能市场,可以一键安装社区开发的工具技能。
安装ClawHub CLI工具
pip install clawhub #搜索可用技能 clawhub search 文件处理 #安装文件处理技能 clawhub install file‑processor #重启网关加载新技能 openclaw gateway restart多消息平台网关,对接飞书、钉钉等IM平台
#开启飞书消息网关 openclaw gateway start --provider feishu #开启钉钉消息网关 openclaw gateway start --provider dingtalk
八、高频故障排查避坑指南
部署失败,提示资源不足
更换资源充足地域,实例规格不低于2核4G;检查账户余额是否充足。模型调用返回鉴权报错
确认API‑Key是对应订阅套餐生成,Coding Plan、Token Plan密钥不可混用;核对BaseURL地址;RAM账号确认已经授予全套权限。WebUI浏览器访问打不开页面
检查安全组/防火墙是否放行18789端口;执行systemctl status openclaw‑gateway确认网关服务处于running状态。网关服务启动失败,依赖缺失
pip install openclaw dashscope openai订阅额度耗尽,调用失败
进入百炼订阅管理页面查看剩余额度,升级套餐档位,或者切换按量付费模式临时过渡。重载配置不生效
修改完json配置文件,确认JSON格式没有语法逗号、括号错误,再执行openclaw config reload。
九、选型总结
OpenClaw可以通过轻量预装镜像快速上手,适合零基础个人使用者;计算巢模板部署适合需要自定义实例、二次开发的团队。Coding Plan更加适配代码脚本、编程助手高频短请求;Token Plan适配长文档、多模态图像视频等通用AI任务。两套订阅可以同时配置在OpenClaw中,业务场景不同随时切换模型。
整套流程关键点:密钥区分、权限完整授予、端口放行、配置文件JSON语法校验、定期监控订阅额度。完成全部配置后,就拥有一套可以自主执行任务、支持技能扩展、对接多消息平台的私有化AI智能体。在实际生产使用中,建议限制服务器访问白名单,保管好API‑Key与WebUI访问Token,避免密钥泄露带来额度异常消耗风险。