2026 年阿里雲計算巢部署 OpenClaw 及配置百煉 API Key 教學
2026年阿里云计算巢 OpenClaw 部署、百炼 API Key 配置保姆级教程(最新整理)
文章提供在阿里雲計算巢部署 OpenClaw、配置百煉 API Key 的模板部署及手動部署流程。內容説明 API Key 地域須與服務一致,並提醒按量計費與 Token Plan 專用密鑰的接入地址不同;另整理網關管理及常見故障排查。
2026-10-31 9
版权
版权声明:
本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写 侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
简介: 整体来说,在阿里云计算巢部署OpenClaw,兼顾了易用性和可扩展性,一键模板适合快速验证能力,手动部署适合深度定制开发。搭配百炼Token Plan套餐,能够稳定调用Qwen系列大模型,用来搭建自动化任务助手、代码调试Agent、文档处理机器人,是当下很实用的开源智能体落地方案。按照这套流程完成部署和密钥配置之后,再根据自身业务开启对应的技能,就能充分发挥OpenClaw的自动执行能力。
OpenClaw是一款轻量化开源AI智能体框架,支持自主调用工具、读写文件、执行脚本、完成自动化任务,能够对接百炼大模型服务,搭配Token Plan套餐使用,非常适合开发者搭建个人智能助手、自动化工作流、项目调试Agent。依托阿里云计算巢进行部署,不用从零搭建服务器环境,内置网络、安全组、域名转发能力,支持模板一键部署,也支持手动在计算巢实例上安装,灵活性很强。本文把前置准备、计算巢模板部署、手动脚本部署、API Key配置、网关启停、常见报错排查全部整理清楚,附带可直接复制的命令,零基础也能跟着完成整套部署流程。
部署之前,先准备好两项核心资源。第一是百炼平台的API Key,登录百炼控制台,进入API密钥管理页面创建密钥,密钥只会展示一次,务必复制保存。这里有一个重点规则:密钥和服务所在地域必须保持一致,跨地域调用会直接鉴权失败;同时区分按量计费密钥和Token Plan专属密钥,两种密钥的接入地址不一样,不要混用。第二是计算巢账号权限,账号需要完成实名认证,并且拥有计算巢服务创建权限,测试场景推荐按量付费模式,避免闲置资源持续扣费。硬件最低配置建议1核2G,只做简单对话测试足够;如果需要频繁调用工具、长上下文任务,建议选择2核4G及以上规格。阿里云部署AI Agent:OpenClaw/Hermes Agent全网最简单,只需两步,详情👉访问阿里云OpenClaw/Hermes一键部署专题页面了解。








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




方案一:计算巢模板一键部署,适合新手快速体验。进入计算巢控制台,在服务市场搜索OpenClaw社区版模板,选定部署地域,填写服务实例名称,选择计费方式,设置实例登录密码。在服务配置参数栏,直接填入百炼DASHSCOPE_API_KEY,自定义网关访问令牌GATEWAY_TOKEN,这个令牌用来保护Web后台,防止外人随意访问。确认参数、勾选协议,提交订单,等待大约2-4分钟,计算巢会自动完成实例创建、环境初始化、OpenClaw安装、网关拉起。部署完成之后,在实例详情页找到访问地址,地址格式自带鉴权token,直接浏览器打开就能进入控制面板,左侧包含对话、控制、Agent、设置等模块,打开对话面板即可发起任务。
方案二:手动部署,适合想要自定义参数、二次开发的用户。先在计算巢创建一台空ECS实例,拿到公网IP,使用SSH连接服务器:
ssh root@实例公网IP
登录之后先更新系统包,安装基础依赖,OpenClaw对运行环境有要求,推荐Node.js 22版本,低版本容易出现依赖报错。
# 安装基础依赖
yum install -y curl git wget
# 一键安装OpenClaw
curl -fsSL [https://openclaw.ai/install.sh](https://openclaw.ai/install.sh) | bash
等待脚本自动下载程序、配置环境。安装完成之后,执行新手初始化向导,向导会引导选择模型服务商、录入API Key、配置网关:
openclaw onboard --install-daemon
如果你不想交互式向导,直接使用非交互式命令,提前传入密钥,适合自动化部署,需要加上风险确认参数:
openclaw onboard --non-interactive --accept-risk --skip-health --auth-choice apiKey --dashscope-api-key "你的百炼APIKEY"
密钥也可以通过环境变量的方式临时注入,安全性更高,不会直接写进命令历史:
export DASHSCOPE_API_KEY="你的百炼APIKEY"
openclaw configure
配置文件默认存放在~/.openclaw/openclaw.json,可以直接编辑这个文件修改模型参数、服务商地址,编辑命令:
vim ~/.openclaw/openclaw.json
在providers节点下找到dashscope配置项,填入apiKey、baseUrl,保存退出。配置修改完成后,需要重启网关服务,让配置生效。
网关是OpenClaw的核心服务,默认监听18789端口,掌握几条网关管理命令是运维的基础。查看网关运行状态:
openclaw gateway status
启动网关服务:
openclaw gateway start
停止网关:
openclaw gateway stop
重启网关:
openclaw gateway restart
网关正常运行之后,打开本地浏览器访问http://服务器IP:18789,输入之前设置的网关令牌,进入控制面板。也可以直接调用命令拉起本地仪表盘:
openclaw dashboard
进入WebUI之后,在设置页面选择需要调用的大模型,Qwen系列模型都可以通过百炼密钥正常调用,同时可以开启内置技能,比如文件读写、shell执行、Git操作、网页浏览等能力。
在使用工具执行shell命令的时候,权限风险需要重点留意,OpenClaw拥有服务器执行权限,不要给Agent开放系统根目录,建议单独创建工作目录,限制Agent操作范围:
mkdir -p /opt/openclaw-workspace
在WebUI里把工作目录指定到这个路径,避免AI误删系统文件。
部署过程中高频问题很多,这里整理常见故障排查思路。第一,API Key鉴权失败,优先核对密钥是否复制完整、有没有多余空格,检查地域是否匹配,再登录百炼控制台查看密钥是否启用、Token Plan额度是否耗尽。第二,Web页面打不开,检查18789端口是否在安全组放行,计算巢模板部署一般自动处理端口,手动部署需要手动放行端口。第三,网关启动失败,先执行openclaw doctor诊断命令,自动修复环境异常:
openclaw doctor --fix
第四,安装脚本超时,多是网络问题,可以切换镜像源,或者分开下载依赖包。
如果你后续不再使用OpenClaw服务,为了避免服务器持续产生费用,优先停止网关进程,再根据需求释放计算巢实例:
openclaw gateway stop
也可以使用阿里云CLI,直接释放实例资源:
aliyun ecs DeleteInstance --InstanceId i-xxxxxx --Force true
释放实例前务必备份配置文件、任务数据,实例释放之后所有数据都会清除。
另外,OpenClaw支持扩展技能和消息渠道,可以对接消息机器人,让智能体接收外部消息、定时执行任务。在配置面板中添加渠道插件,按照指引填入对应的应用凭证,即可实现消息联动。同时它支持多模型切换,在配置文件中新增多个服务商节点,随时切换不同模型完成不同类型任务。
整体来说,在阿里云计算巢部署OpenClaw,兼顾了易用性和可扩展性,一键模板适合快速验证能力,手动部署适合深度定制开发。搭配百炼Token Plan套餐,能够稳定调用Qwen系列大模型,用来搭建自动化任务助手、代码调试Agent、文档处理机器人,是当下很实用的开源智能体落地方案。按照这套流程完成部署和密钥配置之后,再根据自身业务开启对应的技能,就能充分发挥OpenClaw的自动执行能力。
來源:阿里雲開發者社區 AI · developer.aliyun.com