在AI自动化办公全面普及的2026年,OpenClaw(前身为Clawdbot、Moltbot)凭借自然语言指令操控、多任务自动化执行、多平台适配的核心优势,成为个人与中小企业搭建专属AI助手的首选开源轻量级工具。它不仅能高效完成文档生成、文件解析、服务器运维、日程管理、代码生成等基础办公任务,更可通过阿里云一键部署实现7×24小时稳定运行,搭配2026年最新汉化版全中文界面,彻底解决了原版英文操作门槛高的痛点,让零基础用户也能快速上手,真正实现解放双手、提升协作效率的核心需求。
OpenClaw的核心价值的在于“无需手动编写代码,自然语言即可驱动自动化”,无论是零基础小白用于个人办公提效,还是中小企业用于团队协同、轻量运维,都能快速适配场景需求。而阿里云作为国内领先的云计算服务提供商,针对OpenClaw推出了专属部署方案、预置应用镜像及完善的配套服务(阿里云百炼、AppFlow等),通过预配置环境与简化流程设计,大幅降低了部署门槛,无需复杂的技术储备,全程可视化操作+复制粘贴代码,即可完成部署,成功率高达99%以上,详情 访问阿里云OpenClaw一键部署专题页面 了解。
本文结合2026年阿里云最新操作界面、OpenClaw(Clawdbot)最新稳定版本(stable-2026.02,默认集成汉化包)、阿里云百炼大模型最新配置规范,整合全网最细致的实操资料与官方指引,以“零基础小白视角”,全程拆解阿里云部署OpenClaw的完整流程,包含前置准备、两种部署方案(小白首选一键部署+备选手动部署)、环境配置、功能验证、常见问题排查及日常运维,文中所有代码均可直接复制粘贴,不包含任何复杂操作,全程3000字以上,严格规避无关云服务提及,确保每一位零基础用户都能跟着步骤操作,一次部署成功,同时补充阿里云OpenClaw部署简单步骤速查表,方便快速查阅、高效落地。
一、前置准备(零基础必看,缺一不可,全程免费/低成本)
部署OpenClaw的核心前提是完成基础准备工作,所有准备工作均为小白友好型,无需任何技术基础,全程耗时约15-20分钟,主要包括阿里云账号准备、核心服务开通、必备工具安装、核心凭证获取,每一步都有详细指引,提前做好准备,可避免后续部署中途卡壳,同时减少错误率,结合阿里云官方文档与开源社区指引,重点说明零基础用户易忽略的细节与注意事项。
(一)阿里云账号与核心服务开通(部署核心前提)
OpenClaw的部署依赖阿里云服务器(轻量应用服务器/ECS均可,小白首选轻量应用服务器,操作更简洁),同时需要开通阿里云百炼大模型服务(为OpenClaw提供AI能力支持,新用户可领取90天免费调用额度,足够个人初期使用1-3个月),具体操作步骤如下,全程贴合2026年阿里云最新界面与权限要求:
阿里云账号注册与实名认证
- 注册并登录阿里云账号,点击右上角“注册”按钮,选择“个人账号注册”,通过手机号或邮箱完成注册(推荐手机号,更便捷),设置登录密码后,即可完成账号注册。若为企业用户,可选择“企业账号注册”,后续完成企业实名认证即可。
- 实名认证操作:注册完成后,自动跳转至阿里云控制台首页,右上角会提示“未实名认证”,点击提示进入实名认证页面。小白优先选择“个人实名认证”(企业用户可选择企业认证),认证方式支持“身份证认证”“人脸识别认证”,推荐人脸识别认证,全程5分钟内可完成,无需上传纸质材料,审核即时生效。
- 操作细节:上传身份证正反面照片(确保清晰、无遮挡、无反光),然后进行人脸识别,跟随系统提示完成点头、眨眼、张嘴等动作,验证通过后,等待1-2分钟,实名认证即可生效。未完成实名认证,将无法购买服务器、开通百炼服务,后续部署无法推进,同时无法获取API-Key用于OpenClaw的AI能力激活。
核心服务权限开通(均免费开通,无需提前缴费)
- 实名认证完成后,返回阿里云控制台,在顶部搜索框依次搜索“轻量应用服务器”“阿里云百炼”“AppFlow”(用于后续OpenClaw功能扩展、多平台集成,可选但推荐开通,可实现无代码集成Web页面等场景),点击进入对应服务页面,点击“立即开通”,三项服务均为免费开通,无需提前缴费(后续仅需支付轻量服务器的租赁费用,测试阶段可选择按需付费,成本极低,每小时仅几毛钱)。
- 补充说明:阿里云百炼服务开通后,需确认已开通“通义千问系列模型”调用权限(默认开通),重点确保qwen3-max-2026-01-23版本可正常调用,该版本适配OpenClaw最新版本,推理速度快、兼容性好,适合办公自动化、指令响应等场景,小白无需额外配置,默认即可使用;同时可开启“免费额度用完即停”功能,避免产生超出预期的费用。
账号欠费检查与资源准备
- 进入阿里云“费用中心”,查看账号余额,确保无欠费记录(若欠费,可充值少量金额用于测试,后续可按需续费或退订),避免因欠费导致服务器创建失败、服务中断,影响部署流程。
- 提前了解阿里云百炼API-Key的两种计费模式:按Token用量计费、Coding Plan套餐专属API Key(固定月费,提供月度请求额度,可避免超出预期费用),小白可根据自身需求选择,测试阶段推荐按Token用量计费,成本更可控,无需提前购买套餐,按需付费更灵活;Coding Plan仅支持抵扣qwen3-max-2026-01-23和qwen3-coder-plus模型调用费用,不支持多模态模型,需根据使用需求选择。
(二)必备工具安装(本地设备操作,全部免费,下一步即可完成)
部署过程中,我们需要使用3款核心工具,分别用于远程连接服务器、执行代码命令、编辑配置文件、抓取凭证信息,小白可根据自己的本地设备(Windows、Mac、Linux)选择对应版本安装,全程下一步即可完成,无需复杂配置,同时结合2026年最新工具版本,确保兼容性,避免因工具版本过低导致操作异常:
远程连接工具:FinalShell(跨平台,Windows/Mac/Linux通用,最新版本)
- 推荐小白使用FinalShell,跨平台适配,操作更简洁,无需额外配置密钥,支持一键连接、命令复制粘贴,根据自己的本地设备系统选择对应版本(如Windows 64位、MacOS),下载完成后双击安装,全程默认下一步即可,安装完成后无需启动,后续部署时再使用。若使用Xshell等其他SSH工具,操作流程一致,可自行选择,但FinalShell更适配小白操作。
- 补充:Windows用户若使用PowerShell远程连接,无需安装额外工具,后续可直接通过PowerShell执行连接命令,具体命令会在部署步骤中详细说明。
文本编辑工具:Notepad++(Windows)、TextEdit(Mac默认自带)
- 用于保存核心凭证(如阿里云百炼API-Key、服务器密码、OpenClaw访问Token)、编辑配置文件,避免因系统自带记事本格式错乱导致配置失败。Windows用户可在官网(
https://notepad-plus-plus.org/downloads/)下载Notepad++最新版本,安装后默认即可使用;Mac用户直接使用自带的TextEdit,打开后选择“纯文本模式”即可,避免格式错乱导致配置文件解析失败。
- 用于保存核心凭证(如阿里云百炼API-Key、服务器密码、OpenClaw访问Token)、编辑配置文件,避免因系统自带记事本格式错乱导致配置失败。Windows用户可在官网(
浏览器:推荐Chrome、Edge浏览器(最新版本)
- 用于访问阿里云控制台、阿里云百炼控制台、OpenClaw官方文档、下载相关依赖,避免因浏览器兼容问题导致操作异常(如旧版浏览器可能无法正常显示阿里云控制台的应用详情页面、百炼控制台的密钥管理页面),同时确保浏览器可正常访问GitHub、阿里云镜像源,避免后续插件安装、源码下载失败。
(三)核心凭证获取(关键!部署必用,妥善保存,丢失需重新获取)
核心凭证主要是阿里云百炼API-Key(用于激活OpenClaw的AI能力),这是OpenClaw实现自然语言理解、自动化任务执行的核心,OpenClaw本身不具备独立的大语言模型推理能力,需对接阿里云百炼大模型平台,通过API-Key获取授权,调用通义千问系列模型,才能实现核心功能,具体获取步骤如下(结合2026年阿里云百炼最新获取流程,参考阿里云帮助中心指引):
- 登录 访问阿里云百炼大模型服务平台,使用刚刚完成实名认证的阿里云账号登录;
- 登录后,点击左侧导航栏“密钥管理”,进入密钥管理页面,点击右上角“创建API-Key”;
- 在弹出的窗口中,输入API-Key名称(自定义,如“OpenClaw-API”),选择计费模式(按Token用量/ Coding Plan),无需修改其他配置,点击“确定”;
- 系统会自动生成一组API-Key(包含Access Key ID和Access Key Secret),点击“复制”按钮,将两组密钥粘贴到Notepad++/TextEdit中保存,该密钥仅显示一次,丢失需重新创建,切勿泄露给他人(否则可能导致AI能力被滥用、产生不必要的费用),后续部署时会频繁使用;
- 补充说明:若选择Coding Plan套餐专属API Key,需确保该API Key仅支持抵扣指定模型调用费用;若之前已创建过API-Key,可直接使用现有密钥,无需重复创建,避免密钥过多导致混淆;同时可在密钥管理页面设置密钥有效期,定期更换密钥,提升安全性;若不慎泄露,需立即在百炼平台点击“重置”密钥。
(四)前置准备检查清单(小白自查,避免遗漏)
- 阿里云账号已完成实名认证,且开通“轻量应用服务器”“阿里云百炼”两项核心服务,账号无欠费;
- 已获取阿里云百炼API-Key(Access Key ID和Access Key Secret),并保存至文本编辑工具中,无遗漏、无错误;
- 本地设备已安装FinalShell(或Xshell)、Notepad++(或TextEdit),浏览器已更新至最新版本,可正常访问阿里云相关控制台;
- 确保本地设备网络通畅,可正常访问阿里云官网、GitHub(用于下载OpenClaw相关插件,国内用户可通过阿里云镜像源规避访问限制),可正常调用阿里云百炼API;
- 了解轻量服务器的基础配置要求(内存≥2GiB、存储≥40GB),明确自己的部署需求(测试/长期使用),确定付费类型。
(五)阿里云一键部署OpenClaw步骤流程
第一步:访问阿里云OpenClaw一键部署专题页面,找到并点击【一键购买并部署】。
阿里云OpenClaw一键部署专题页面:https://www.aliyun.com/activity/ecs/clawdbot


第二步:选购阿里云轻量应用服务器,配置参考如下:
- 镜像:OpenClaw(Moltbot)镜像(已经购买服务器的用户可以重置系统重新选择镜像)
- 实例:内存必须2GiB及以上。
- 地域:默认美国(弗吉尼亚),目前中国内地域(除香港)的轻量应用服务器,联网搜索功能受限。
- 时长:根据自己的需求及预算选择。



第三步:访问阿里云百炼大模型控制台,找到密钥管理,单击创建API-Key。
前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
- 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
- 配置百炼API-Key,单击一键配置,输入百炼的API-Key。单击执行命令,写入API-Key。
- 配置OpenClaw:单击执行命令,生成访问OpenClaw的Token。
- 访问控制页面:单击打开网站页面可进入OpenClaw对话页面。
二、阿里云OpenClaw(Clawdbot)部署简单步骤(速查表,小白快速查阅)
为方便零基础小白快速上手,提前整理部署核心简单步骤(适配小白首选的“专属镜像一键部署”方案),全程5步,无需复杂操作,后续会详细拆解每一步的具体操作,速查表可直接对照使用,节省查阅时间:
- 购买阿里云轻量应用服务器,选择“OpenClaw专属镜像”,配置按推荐选择(2核2GB内存、40GB ESSD、香港/海外地域),完成支付,等待服务器创建成功;
- 重置服务器登录密码,在阿里云控制台放行18789核心端口(一键放通即可);
- 用FinalShell远程连接服务器,执行环境预检脚本,排查基础环境问题;
- 配置阿里云百炼API-Key,重启OpenClaw服务,获取访问Token并保存;
- 访问OpenClaw控制台,输入Token登录,发送测试指令,验证部署成功,设置开机自启。
三、阿里云OpenClaw(Clawdbot)详细部署步骤(零基础全程实操)
完成前置准备后,正式进入OpenClaw部署环节,本文提供两种部署方案,小白首选“方案一:专属镜像一键部署”,省时省力,无需手动配置环境,全程可视化操作+少量代码复制粘贴,10-15分钟即可完成部署,适配2026年阿里云最新一键部署规范,成功率最高;方案二为“手动部署方案”,适合已有阿里云服务器、不想使用专属镜像的用户,步骤稍繁琐,但小白可跟随代码复制粘贴完成,全程拆解每一步操作,确保不出错。
(一)方案一:小白首选——轻量应用服务器+专属镜像一键部署(最简单,推荐)
阿里云已预置OpenClaw专属应用镜像,集成了Node.js 22.0.0、Python 3.9、Docker、OpenClaw主程序、汉化包及所有所需依赖库,无需手动配置环境,部署流程直接简化80%,避免用户额外配置环境导致的依赖冲突问题,该镜像来源于阿里云计算巢,安全可靠,定期更新依赖包,小白直接照搬配置即可,结合阿里云一键部署专题页面优化流程,提升部署效率。
步骤1:购买阿里云轻量应用服务器(高性价比配置,小白直接照搬)
- 访问阿里云OpenClaw一键部署专题页面,点击右上角“一键购买并部署”,直接跳转至服务器配置界面,更便捷,无需手动选择镜像,系统默认匹配OpenClaw专属镜像(2026年默认版本为v2026.2.3,集成汉化包);若未找到专属入口,也可登录阿里云官网,依次点击“产品→人工智能→OpenClaw云服务”进入配置界面,首次使用需仔细阅读《OpenClaw服务协议》,勾选同意后进入下一步;
- 根据页面提示完成资源配置,具体配置项说明如下(小白直接照搬,无需修改,兼顾流畅度与低成本,结合2026年最新配置推荐,参考阿里云开发者社区实测配置):
| 配置项 | 推荐选择 | 说明(保姆级解读) |
|---|---|---|
| 地域 | 国内用户:中国香港(免备案,联网功能完整);海外用户:新加坡、美国弗吉尼亚 | 地域选择直接影响访问延迟和功能可用性,重点注意:中国内地地域(除香港外)的轻量应用服务器,联网搜索功能受限(无法实现网页抓取、信息查询等功能),且后续功能扩展时可能出现集成失败、消息延迟等问题;服务器创建后不支持更换地域,请谨慎选择,小白优先推荐中国香港地域,无需备案,购买后可直接使用,网络通畅,适配OpenClaw所有功能,同时与阿里云百炼模型服务地域邻近可降低延迟。 |
| 实例规格 | 通用型(2核2GB内存,40GB ESSD系统盘,200Mbps带宽) | 小白首选配置,完全满足OpenClaw日常使用(如办公自动化、指令响应),同时支持后续多用户并发请求(如10-20人同时发送指令);若需同时运行多个自动化任务、集成多个工具(如文件解析、图片识别),可选择通用型(2核4GB内存),性价比更高;最低配置需满足2核2GB内存+40GB ESSD,否则可能出现卡顿、部署失败、服务闪退等问题,2026年OpenClaw最新版本对内存要求略有提升,不建议选择低于2核2GB的配置。 |
| 镜像选择 | 应用镜像:OpenClaw(原Moltbot/Clawdbot) | 核心配置!小白务必选择此镜像,该镜像基于Alibaba Cloud Linux 3.2104 LTS 64位系统,已预装所有核心依赖与汉化包,无需手动配置环境、无需额外安装汉化包,部署完成后直接进入中文界面;若已购买服务器,可通过“重置系统”重新选择此镜像(重置前需备份数据,避免数据丢失)。 |
| 付费类型 | 按需付费(测试阶段)、包年包月(长期使用) | 1. 测试阶段:推荐“按需付费”,按实际使用时长计费,每小时仅需几毛钱,测试完成后可随时释放服务器,避免浪费;2. 长期使用:推荐“包年包月”,新用户可享受首月折扣,年付更划算,且可勾选“自动续费”,避免因忘记续费导致服务中断;中国内地地域服务器若用于Web服务,需完成ICP备案(备案实例时长需≥3个月),香港/海外地域无需备案,小白测试阶段优先选择按需付费,成本可控。 |
| 实例名称 | 自定义(如“OpenClaw-部署服务器”) | 便于后续管理,可根据自己的习惯命名,无需遵循特殊规则(如“OpenClaw测试服务器”“零基础部署-OpenClaw”),建议包含“OpenClaw”字样,便于区分其他服务器实例,后续维护更便捷。 |
- 配置完成后,点击页面底部“立即购买”,进入支付页面,选择支付方式(支付宝、微信均可),完成支付后,返回轻量应用服务器控制台,等待3-5分钟,服务器状态由“准备中”变为“运行中”,此时轻量服务器实例创建成功,同时OpenClaw专属镜像已自动部署完成,系统会自动启动OpenClaw服务,后续仅需完成简单配置(API-Key、Token)即可使用。
步骤2:服务器基础配置(端口放行+密码重置,必做,否则无法正常访问)
服务器创建成功后,需要完成两项基础配置:重置登录密码(用于远程连接服务器,后续调试、维护需用到)、放行OpenClaw核心端口(用于OpenClaw服务访问、功能验证),具体操作步骤如下,结合2026年阿里云服务器最新防火墙配置规则,确保端口放行生效,小白可通过“一键放通”简化操作:
重置服务器登录密码(核心,远程连接必备):
- 在轻量应用服务器控制台,找到刚刚创建的服务器实例,点击实例名称,进入实例详情页面;
- 点击左侧导航栏“重置密码”,进入密码重置页面,输入新密码(建议设置复杂密码,包含大小写字母、数字、特殊符号,如Abc123!@#),确认密码后,点击“确定”;
- 系统会提示“重置密码成功,需重启服务器生效”,点击页面提示的“重启服务器”,等待2-3分钟,服务器重启完成后,新密码即可生效,将密码保存至Notepad++/TextEdit中,后续远程连接服务器时需要使用,切勿忘记,若忘记密码,可再次通过控制台重置。
放行OpenClaw核心端口(18789端口,必做,访问控制台关键):
- OpenClaw服务默认使用18789端口,若未放行该端口,后续将无法访问OpenClaw控制台,也无法验证部署是否成功,需同时配置服务器内部防火墙和阿里云控制台防火墙,具体操作如下,两步缺一不可,避免端口被拦截;小白可直接使用阿里云控制台的“一键放通”功能,无需手动执行命令:
- (1)阿里云控制台防火墙配置(放行端口,小白一键操作):在服务器实例详情页面,点击左侧导航栏“防火墙”,进入防火墙配置页面;点击“添加规则”,在弹出的窗口中,按以下配置填写:端口范围:18789(OpenClaw核心端口,不可修改);协议:TCP(默认即可);授权对象:0.0.0.0/0(允许所有IP访问,小白首选,测试阶段便捷;若需提高安全性,可填写自己本地设备的公网IP);备注:自定义(如“OpenClaw核心端口,用于访问控制台”);填写完成后,点击“确定”,即可完成端口放行,此时防火墙规则列表中会显示“18789/TCP”,状态为“已放行”;小白可直接点击“一键放通”按钮,自动配置端口放行规则,更便捷,避免手动配置遗漏。
- (2)服务器内部防火墙配置(补充放行,避免端口被拦截):后续远程连接服务器后,需执行代码命令放行内部防火墙端口,此处先提前说明代码,后续远程连接后直接复制粘贴即可,适配Alibaba Cloud Linux系统,无需手动修改命令:
# 1. 查看服务器内部防火墙状态(Alibaba Cloud Linux系统默认使用firewalld) systemctl status firewalld # 2. 放行18789/TCP端口(永久放行,重启服务器后仍生效) firewall-cmd --add-port=18789/tcp --permanent # 3. 放行80端口(备用,用于后续功能扩展,可选但推荐) firewall-cmd --add-port=80/tcp --permanent # 4. 重新加载防火墙规则,使端口放行生效 firewall-cmd --reload # 5. 验证端口是否放行成功(输出18789/tcp、80/tcp即为成功) firewall-cmd --list-ports | grep -E "18789|80" - 补充说明:若执行命令后提示“firewalld is not running”(防火墙未启动),无需担心,说明服务器内部防火墙未开启,端口不会被拦截,可跳过后续放行命令;若防火墙已启动,必须执行上述命令,否则端口会被拦截,导致OpenClaw控制台无法访问。
步骤3:远程连接服务器,完成OpenClaw核心配置(API-Key+Token)
这一步是部署的核心,完成后即可激活OpenClaw的AI能力,同时获取登录控制台的凭证,全程代码复制粘贴,小白可轻松操作,结合OpenClaw官方安装指引,补充环境预检、服务状态查看等关键步骤,避免配置出错:
远程连接服务器(两种方式,小白任选其一,FinalShell更便捷):
- 方式一:FinalShell连接(推荐,小白首选)
- 打开本地设备安装的FinalShell工具,首次打开会提示“新建连接”,点击“新建”,选择“SSH连接”;
- 在弹出的连接配置窗口中,按以下信息填写(信息均来自服务器实例详情页面和之前保存的文本工具):
- 名称:自定义(如“OpenClaw服务器-零基础部署”)
- 主机:填写服务器的“公网IP”(在实例详情页面顶部,如47.xxx.xxx.xxx,复制完整IP,无多余空格)
- 端口:22(默认端口,无需修改,若修改过默认端口,需填写对应端口)
- 用户名:root(阿里云轻量服务器默认登录用户名,不可修改)
- 密码:填写之前重置的服务器登录密码(保存至文本工具中的密码)
- 填写完成后,点击“确定”,然后在FinalShell左侧“会话管理”中,找到刚刚创建的连接,双击连接,弹出“是否信任此主机”提示,点击“信任”,等待1-2秒,即可成功连接到服务器(连接成功后,终端会显示“[root@xxx ~]#”,表示已进入服务器命令行界面)。
- 方式二:PowerShell连接(Windows用户可选,无需安装FinalShell)
- 打开Windows PowerShell(按下Win+R,输入powershell,回车即可);
- 输入连接命令(替换公网IP和密码),直接复制执行:
# 替换47.xxx.xxx.xxx为服务器公网IP,输入命令后按提示输入密码(输入时不显示) ssh root@47.xxx.xxx.xxx - 弹出“是否继续连接”提示,输入yes,回车,然后输入服务器登录密码,回车即可成功连接,连接成功后终端显示“[root@xxx ~]#”。
- 补充说明:若连接失败,检查公网IP、密码是否正确,或服务器是否已重启生效,也可检查本地网络是否通畅,避免网络问题导致连接失败;若提示“Connection refused”,检查服务器22端口是否放行(默认已放行)。
- 方式一:FinalShell连接(推荐,小白首选)
执行环境预检脚本(避免部署中途出错,小白必做):
- 连接成功后,复制粘贴以下代码,执行OpenClaw专属环境预检脚本,检查服务器是否满足部署条件(系统版本、内存、端口、网络等),有问题提前修复,避免后续配置出错,2026年最新预检脚本,适配OpenClaw stable-2026.02版本,可快速检测依赖、网络、端口等关键项:
# 执行2026版OpenClaw环境预检脚本(直接复制回车,无需修改) curl -fsSL https://gitee.com/openclaw-team/script/raw/main/2026/aliyun_precheck.sh | bash - 预检通过会显示以下结果(有(×)需先修复,再进行下一步,修复方法脚本会自动提示,小白可按提示操作):
- (√) 系统版本适配:Alibaba Cloud Linux 3.2104 LTS 64位
- (√) 内存/存储满足要求:2核2GB/40GB ESSD
- (√) 18789端口未被占用(OpenClaw默认Web服务端口)
- (√) 外网访问正常,可连接阿里云百炼API
- (√) 服务器地域与百炼API-Key地域匹配
- (√) 核心依赖(Node.js、Python、Docker)已预装完成
- (√) OpenClaw汉化包已集成,无需额外安装
- 补充说明:若预检提示“外网访问异常”,检查服务器地域是否为中国香港/海外,内地地域可能因网络限制导致访问异常,需更换地域;若提示“依赖缺失”,重新部署OpenClaw专属镜像即可,无需手动安装依赖;若提示“端口被占用”,执行“lsof -i:18789”查看占用进程,执行“kill -9 进程ID”终止进程,再重新预检。
- 连接成功后,复制粘贴以下代码,执行OpenClaw专属环境预检脚本,检查服务器是否满足部署条件(系统版本、内存、端口、网络等),有问题提前修复,避免后续配置出错,2026年最新预检脚本,适配OpenClaw stable-2026.02版本,可快速检测依赖、网络、端口等关键项:
配置阿里云百炼API-Key(激活OpenClaw AI能力,必做,核心步骤):
- 这一步是核心,若未配置API-Key,OpenClaw将无法使用AI自动化功能,也无法响应指令,全程代码复制粘贴,无需手动编写配置文件,小白可轻松操作,结合阿里云帮助中心最新配置指引,确保API-Key配置生效,同时支持系统推荐与手动输入两种方式,小白可选择系统推荐简化操作:
- 方式一:手动配置(小白首选,直接编辑配置文件)
- 首先执行以下代码,进入OpenClaw配置目录(专属镜像已默认创建该目录,无需手动创建):
# 进入OpenClaw配置目录 cd /root/.openclaw # 编辑配置文件(使用nano编辑器,小白友好,无需复杂操作,支持复制粘贴) nano config.json - 打开配置文件后,找到“models.providers.bailian”节点,将之前获取的阿里云百炼API-Key(Access Key ID和Access Key Secret)填写到对应位置,修改后的内容如下(替换括号内的内容,保留双引号,不要删除任何原有符号,避免配置出错,参考阿里云百炼API配置规范):
"models": { "providers": { "bailian": { "accessKeyId": "你的阿里云百炼Access Key ID", "accessKeySecret": "你的阿里云百炼Access Key Secret", "defaultModel": "bailian/qwen3-max-2026-01-23" // 2026年推荐默认模型,适配性最佳 } }, "default": "bailian/qwen3-max-2026-01-23" } - 填写完成后,按“Ctrl+O”保存配置(输入O,不是0),按“Ctrl+X”退出编辑器,返回终端界面。
- 首先执行以下代码,进入OpenClaw配置目录(专属镜像已默认创建该目录,无需手动创建):
- 方式二:系统推荐配置(简化操作,无需手动编辑配置文件)
- 执行以下命令,调用系统推荐配置脚本,自动匹配最近地域的API-Key:
# 系统推荐配置百炼API-Key(直接复制执行,无需修改) openclaw config set models.providers.bailian.accessKeyId "你的阿里云百炼Access Key ID" openclaw config set models.providers.bailian.accessKeySecret "你的阿里云百炼Access Key Secret"
- 执行以下命令,调用系统推荐配置脚本,自动匹配最近地域的API-Key:
-
- 执行以下代码,重启OpenClaw服务,使API-Key配置生效,同时查看服务状态,确保服务正常运行,若服务异常,可快速排查问题:
# 重启OpenClaw服务(专属镜像默认已安装服务,直接执行命令即可) systemctl restart openclaw # 查看OpenClaw服务状态(输出active(running)即为正常,若为errored需排查问题) systemctl status openclaw
- 执行以下代码,重启OpenClaw服务,使API-Key配置生效,同时查看服务状态,确保服务正常运行,若服务异常,可快速排查问题:
- 补充说明:若查看服务状态显示异常(如errored),大概率是API-Key填写错误(如多空格、少字符),可重新进入配置文件修改,再次重启服务即可;若仍异常,执行“journalctl -u openclaw”查看服务日志,根据日志提示修复问题,日志可显示具体错误原因(如API-Key无效、模型调用失败等);若API-Key地域与服务器地域不匹配,需重新选择对应地域的API-Key。
获取OpenClaw访问Token(登录控制台必用,核心凭证):
- Token是OpenClaw控制台登录的核心凭证,同时也是后续功能扩展(如集成Web页面)的身份验证凭证,执行以下代码,获取Token并保存,无需手动生成,专属镜像会自动生成Token,结合阿里云帮助中心指引,确保Token获取正确,切勿泄露:
# 生成并查看OpenClaw访问Token(核心命令,直接复制执行) cat /root/.openclaw/config.json | grep token # 示例输出:"token": "abcdef1234567890abcdef1234567890"(复制该token,不含双引号) - 将生成的Token复制到Notepad++/TextEdit中保存,后续登录OpenClaw控制台、配置功能扩展时会用到,切勿泄露,若不慎泄露,可执行以下代码重新生成Token,避免安全风险:
# 重新生成OpenClaw访问Token(泄露后必做) openclaw token regenerate # 查看新Token cat /root/.openclaw/config.json | grep token - 补充说明:阿里云控制台“应用详情”页也提供“查看Token”的快捷操作,小白可直接点击“执行命令”,快速获取Token,无需手动输入命令。
- Token是OpenClaw控制台登录的核心凭证,同时也是后续功能扩展(如集成Web页面)的身份验证凭证,执行以下代码,获取Token并保存,无需手动生成,专属镜像会自动生成Token,结合阿里云帮助中心指引,确保Token获取正确,切勿泄露:
步骤4:访问OpenClaw控制台,验证部署是否成功(小白必做,确保能正常使用)
- 保持FinalShell终端连接(无需关闭),打开本地设备的Chrome/Edge浏览器,在地址栏输入:http://服务器公网IP:18789(替换为自己服务器的公网IP,如http://47.xxx.xxx.xxx:18789),按下回车键,进入OpenClaw登录页面(2026年汉化版界面,全中文显示,小白可轻松操作,界面简洁,核心功能一目了然);
- 在登录页面的“Token输入框”中,粘贴之前获取的OpenClaw访问Token,点击“登录”,即可成功进入OpenClaw控制台,控制台左侧为对话窗口,右侧为功能配置模块(如模型配置、插件管理、日志查看、汉化设置等),小白无需额外配置,默认即可使用,后续可根据需求调整配置;
- 部署验证(小白必做,确保部署成功,测试AI能力是否正常):
- 进入控制台后,在左侧对话窗口中,输入以下指令(任意一条均可),测试AI能力是否正常,验证部署是否成功,指令贴合日常办公场景,便于后续实际使用:
- 指令1:“帮我生成一份50字左右的工作日报,包含今日工作、明日计划,适配日常办公格式”
- 指令2:“帮我查询明天杭州的天气,整理成简洁文本,适合发送到工作群”
- 指令3:“帮我编写一段团队周会纪要模板,包含会议主题、参会人员、会议内容、后续安排”
- 指令4:“帮我抓取阿里云官网的核心服务介绍,整理成3条关键信息”
- 指令5:“帮我生成一段简单的服务器运维日志,包含日期、运维内容、状态”
- 输入指令后,点击“发送”,等待1-3秒(取决于网络速度和AI响应速度),若OpenClaw能返回对应的结果(文本形式,适配日常使用场景),说明部署完全成功,OpenClaw可正常使用所有功能;若返回“AI模型调用失败”,请检查API-Key是否配置正确,或重新执行“systemctl restart openclaw”重启服务,再次测试;若仍失败,检查阿里云百炼API-Key是否有效,可重新创建API-Key后再次配置;若返回“汉化失败”,执行“openclaw locale set zh-CN”重启汉化服务,再次登录即可。
- 进入控制台后,在左侧对话窗口中,输入以下指令(任意一条均可),测试AI能力是否正常,验证部署是否成功,指令贴合日常办公场景,便于后续实际使用:
步骤5:设置OpenClaw开机自启(长期使用必做,避免服务中断)
为了确保服务器重启后,OpenClaw服务能自动启动,无需手动重启(避免影响日常使用,导致指令无法及时响应),执行以下代码,设置开机自启,后续服务器重启后,OpenClaw会自动运行,无需手动操作,结合OpenClaw官方运维指引,确保开机自启配置生效:
# 设置OpenClaw开机自启(核心命令,直接复制执行)
systemctl enable openclaw
# 验证开机自启设置是否成功(输出enabled即为成功,disabled为失败)
systemctl is-enabled openclaw
- 补充说明:若验证失败,重新执行设置开机自启的命令,确保命令输入正确,无多余空格;若仍失败,执行“systemctl daemon-reload”重新加载系统服务,再执行设置开机自启的命令,即可生效;长期使用的用户,建议勾选服务器的“自动续费”功能,避免因服务器到期导致服务中断。
步骤6:汉化版补充配置(可选,默认已集成,按需调整)
OpenClaw专属镜像已默认集成2026年最新汉化包,登录控制台后直接显示中文界面,若需调整汉化细节(如界面语言、提示语),可执行以下代码,按需配置,小白无需操作,默认即可满足使用需求:
# 查看当前语言配置(默认zh-CN,中文)
openclaw locale show
# 若需重新设置中文,执行以下命令
openclaw locale set zh-CN
# 重启OpenClaw服务,使汉化配置生效
systemctl restart openclaw
(二)方案二:手动部署方案(适合已有服务器、不想使用专属镜像的用户)
若你已有阿里云轻量应用服务器/ECS,且不想使用OpenClaw专属镜像,可选择手动部署方案,全程需手动安装依赖、克隆源码、配置环境,步骤稍繁琐,但小白可跟随代码复制粘贴完成,具体步骤如下(核心步骤,简化非必要环节,结合2026年最新手动部署流程,适配OpenClaw stable-2026.02版本,参考OpenClaw官方安装文档与阿里云开发者社区指引,完善依赖安装、容器化部署流程):
步骤1:远程连接服务器(同方案一步骤3-1,此处不再重复,确保连接成功,若连接失败,排查公网IP、密码、端口等问题)
步骤2:安装OpenClaw必备依赖(复制粘贴代码,一键安装,避免依赖缺失)
OpenClaw运行需要依赖Node.js、Python、Git、Docker等核心工具,手动部署需逐一安装,所有代码均可直接复制粘贴,小白无需手动下载,结合OpenClaw官方安装要求,安装最新版本依赖,避免版本兼容问题,国内用户使用阿里云镜像源,避免下载缓慢:
# 1. 更新系统依赖(避免依赖版本过低,导致安装失败,适配Alibaba Cloud Linux/CentOS)
yum update -y --disablerepo=* --enablerepo=aliyunos,epel
yum install -y wget curl gcc gcc-c++ make
# 2. 安装Node.js(22.0.0版本,OpenClaw官方推荐,2026年最新兼容版本,插件安装必备)
wget https://npmmirror.com/mirrors/node/v22.0.0/node-v22.0.0-linux-x64.tar.xz
tar -xvf node-v22.0.0-linux-x64.tar.xz
mv node-v22.0.0-linux-x64 /usr/local/node
echo "export PATH=/usr/local/node/bin:\$PATH" >> /etc/profile
source /etc/profile
node -v # 验证,输出版本号v22.0.0即为成功
npm -v # 验证,输出版本号≥10.5.0即为成功
# 3. 安装pnpm(包管理工具,OpenClaw官方推荐,替代npm,下载速度更快,避免依赖冲突)
npm install -g pnpm@latest
pnpm -v # 验证,输出版本号≥9.0.0即为成功
# 若pnpm安装后提示“Ignored build scripts”,执行以下命令批准构建脚本
pnpm approve-builds -g
pnpm add -g openclaw@latest # 重新运行,执行postinstall脚本
# 4. 安装Git(用于克隆OpenClaw源码,国内用户使用阿里云镜像源,避免下载缓慢)
yum install -y git
git --version # 验证,输出版本号≥2.0.0即为成功
# 5. 安装Docker(可选,容器化部署,推荐,便于后续维护和升级,适配2026年最新版本)
yum install -y yum-utils device-mapper-persistent-data lvm2
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
yum install -y docker-ce docker-ce-cli containerd.io
systemctl start docker
systemctl enable docker
docker -v # 验证,输出版本号即为成功
# 6. 安装OpenClaw核心包(一键安装,简化操作,2026年最新版本,stable-2026.02)
# 方式一:通过安装器快速安装(推荐,自动完成配置,小白首选)
curl -fsSL https://openclaw.ai/install.sh | bash
# 方式二:通过pnpm手动安装(备选,适合熟悉命令行的用户)
pnpm add -g openclaw@latest
openclaw -v # 验证,输出版本号即为成功(需与stable-2026.02一致)
# 7. 安装OpenClaw汉化包(手动部署需额外安装,专属镜像已集成)
openclaw locale install zh-CN
openclaw locale set zh-CN # 设置中文为默认语言
# 8. 放行18789端口和80端口(同方案一步骤2-2,必做,避免端口被拦截)
firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --add-port=80/tcp --permanent
firewall-cmd --reload
firewall-cmd --list-ports | grep -E "18789|80"
- 补充说明:若执行“yum update”命令提示错误,可执行“yum clean all”清理缓存,再重新执行更新命令;若Node.js、pnpm安装失败,可更换阿里云镜像源后重新安装;若Docker安装失败,检查服务器系统版本,确保适配Docker最新版本;若OpenClaw安装失败,执行“pnpm uninstall -g openclaw”卸载后,重新执行安装命令,或使用官方安装器安装;Windows用户通过WSL2部署,需先启用WSL2功能,再执行上述命令。
步骤3:初始化OpenClaw并配置API-Key(激活AI能力,核心步骤)
手动安装完成后,需初始化OpenClaw,启动安装向导,配置阿里云百炼API-Key,激活AI能力,全程跟随向导操作,小白可轻松完成,结合OpenClaw官方初始化指引,简化配置流程:
# 1. 初始化OpenClaw(启动安装向导,简化配置,小白友好,无需手动编写配置文件)
openclaw onboard --install-daemon
# 2. 跟随向导提示,完成基础配置(无需手动输入,复制粘贴凭证即可,步骤清晰)
# 步骤1:选择语言,输入1(中文),回车(已安装汉化包,默认显示中文向导)
# 步骤2:选择模型提供商,输入bailian(阿里云百炼),回车
# 步骤3:粘贴阿里云百炼Access Key ID和Access Key Secret,依次回车(粘贴后回车确认)
# 步骤4:设置默认模型,直接回车(默认bailian/qwen3-max-2026-01-23,无需修改)
# 步骤5:设置OpenClaw服务端口,直接回车(默认18789,不可修改)
# 步骤6:初始化完成,提示“OpenClaw初始化成功”,即可进入下一步
# 3. 启动OpenClaw服务(开发模式,用于测试,小白首选,便于查看实时日志)
pnpm dev
# 若需后台启动(长期使用,推荐,避免终端关闭后服务中断),执行以下命令:
pnpm install -g pm2
pm2 start src/index.js --name openclaw
pm2 enable openclaw # 设置pm2开机自启,避免服务中断
pm2 status openclaw # 查看服务状态,确保正常运行(输出online即为成功)
# 4. 检查OpenClaw健康状态(核心,确保服务正常运行,无异常)
openclaw doctor
openclaw health # 查看网关健康状态,输出healthy即为正常
- 补充说明:启动服务后,若终端显示“OpenClaw server started on port 18789”,说明服务启动成功;若显示错误,查看终端输出的错误信息,排查依赖缺失、API-Key错误等问题,修复后重新启动服务;若网关状态异常,执行“openclaw gateway restart”重启网关,再次检查健康状态。
步骤4:获取Token、验证部署(同方案一步骤3-4至步骤4,此处不再重复,确保能正常登录控制台、AI指令能正常响应,测试指令贴合日常办公场景,便于后续实际使用)
(三)两种部署方案对比(小白选择参考)
为方便零基础小白选择适合自己的部署方案,整理两种方案的核心对比,结合使用场景、操作难度、耗时等因素,给出明确建议,小白可根据自身情况选择:
| 对比项 | 方案一:专属镜像一键部署 | 方案二:手动部署 |
|---|---|---|
| 操作难度 | 极低,小白首选,全程可视化+少量代码 | 中等,需手动安装依赖,步骤稍繁琐 |
| 耗时 | 10-15分钟,快速完成 | 30-40分钟,依赖安装耗时较长 |
| 适用人群 | 零基础小白、不想手动配置环境的用户 | 已有阿里云服务器、熟悉基础命令行的用户 |
| 优势 | 无需手动配置依赖,成功率高,集成汉化包,省时省力 | 灵活度高,可自定义配置,适合二次开发 |
| 劣势 | 灵活度较低,不适合二次开发 | 步骤繁琐,易出现依赖冲突、版本兼容问题 |
| 后续维护 | 简单,阿里云镜像定期更新,无需手动升级 | 复杂,需手动更新依赖、升级OpenClaw版本 |
(四)OpenClaw部署总结(小白必看)
两种部署方案均可实现OpenClaw的正常运行,小白首选“方案一:专属镜像一键部署” ,省时省力,无需手动配置环境,全程可视化操作+少量代码,10-15分钟即可完成,适配2026年阿里云最新操作规范,成功率最高,结合阿里云开发者社区、OpenClaw官方文档的实测经验,优化流程,避免小白踩坑;已有服务器、不想使用专属镜像的用户,可选择“方案二:手动部署方案”,跟随代码复制粘贴,也能顺利完成部署,重点注意依赖安装和API-Key配置,避免出现依赖缺失、服务启动失败等问题,手动部署用户需重点关注Node.js、pnpm版本,确保适配OpenClaw最新版本。
部署成功后,OpenClaw已具备完整的AI自动化功能,可实现自然语言指令解析、任务自动执行、结果快速反馈等核心功能,后续可根据需求,通过阿里云AppFlow实现Web页面集成等功能扩展,也可安装插件,扩展文档解析、图片识别、日程管理等进阶功能,真正实现办公提效、运维简化,适配个人、轻量团队及中小企业的使用需求。
四、OpenClaw(Clawdbot)基础使用教程(零基础入门,快速上手)
部署成功后,小白可快速上手使用OpenClaw,核心使用场景为“自然语言指令驱动自动化任务”,无需手动编写代码,以下是基础使用步骤和常用指令,结合日常办公场景,帮助小白快速解锁OpenClaw的核心功能,同时补充控制台操作指引,便于后续配置调整:
(一)控制台基础操作(全中文,小白友好)
登录OpenClaw控制台(http://服务器公网IP:18789),输入Token登录后,左侧为“对话窗口”(输入指令、接收结果),右侧为“配置面板”,核心配置项说明如下(小白无需修改,默认即可使用):
- 模型配置:可切换默认模型(推荐使用qwen3-max-2026-01-23),调整模型响应速度、上下文长度;
- 插件管理:可安装、卸载插件,扩展OpenClaw功能(如文档解析插件、图片识别插件);
- 日志查看:可查看指令执行日志、服务运行日志,便于排查使用过程中的异常;
- 汉化设置:可调整界面语言、提示语,默认中文,无需修改;
- Token管理:可重新生成Token、设置Token有效期,提升安全性。
核心操作:在左侧对话窗口输入指令,点击“发送”,即可等待OpenClaw执行任务并返回结果;若指令复杂,OpenClaw会自动规划任务步骤,逐步执行,最终返回完整结果;可在对话窗口查看历史指令和执行结果,便于后续查阅。
(二)常用指令(贴合日常办公,小白直接复制使用)
OpenClaw支持多种日常办公、运维相关的指令,以下是高频常用指令,小白可直接复制到对话窗口,替换括号内的内容,即可使用,同时可根据自身需求,自定义指令:
文档生成类(最常用,办公提效首选)
- “帮我生成一份50字左右的工作日报,今日工作:完成OpenClaw部署,明日计划:学习OpenClaw进阶使用”;
- “帮我编写一段团队周会纪要模板,包含会议主题、参会人员、会议内容、后续安排、负责人、截止时间”;
- “帮我生成一封请假条,请假类型:事假,请假时间:3天,请假原因:个人事务,申请人:XXX”;
- “帮我整理一份服务器运维日报,包含运维内容、服务器状态、异常情况、后续计划”。
信息查询与整理类
- “帮我查询明天北京的天气,整理成简洁文本,包含温度、天气状况、穿衣建议”;
- “帮我抓取阿里云官网的核心服务介绍,整理成3条关键信息,每条不超过50字”;
- “帮我查询Node.js 22.0.0版本的核心更新内容,整理成简洁清单”;
- “帮我整理一份OpenClaw部署常见问题及解决方法,适配零基础用户”。
运维相关类(适合服务器运维场景)
- “帮我编写一段Linux服务器基础巡检脚本,包含内存、磁盘、CPU使用率检查”;
- “帮我查询当前服务器的CPU使用率、内存使用率,整理成简洁文本”;
- “帮我生成一段服务器重启通知,发送给团队成员,包含重启时间、重启原因、影响范围”;
- “帮我排查OpenClaw服务无法启动的可能原因,给出具体解决方法”。
进阶指令(功能扩展,按需使用)
- “帮我安装OpenClaw文档解析插件,用于解析Word、Excel文件”;
- “帮我设置一个每日18点的提醒,提醒内容:整理当日工作日报”;
- “帮我编写一段简单的Python代码,实现批量创建文件夹,文件夹名称为test1-test10”;
- “帮我解析这份文本中的关键信息,提取姓名、电话、邮箱,整理成表格形式”。
(三)使用注意事项(小白必看,避免出错)
- 指令描述需清晰、具体,避免模糊表述(如不要只输入“生成工作日报”,需说明日报长度、包含内容),否则OpenClaw可能无法准确理解需求,导致执行结果不符合预期;
- 若指令执行失败或结果不符合预期,可重新描述指令,补充细节,再次发送;也可查看右侧“日志查看”模块,排查异常原因;
- 避免输入违规、违法指令,OpenClaw会自动拦截违规指令,同时确保指令内容符合阿里云服务协议、OpenClaw使用规范;
- 长期使用时,定期查看阿里云百炼API-Key的调用额度和费用,避免超出预算;可开启“消费限额”“免费额度用完即停”功能,控制成本;
- 若长时间未使用OpenClaw,再次使用时,先查看服务状态(执行“systemctl status openclaw”),确保服务正常运行,避免出现无响应的情况。
五、常见问题排查(零基础小白避坑指南,99%的问题都能解决)
部署和使用过程中,小白可能会遇到一些基础问题(如服务启动失败、控制台无法访问、AI指令无响应等),以下整理了最常见的10个问题,结合2026年最新版本的适配问题,给出具体的排查方法和解决步骤,小白可对照排查,无需技术基础,全程复制粘贴代码即可解决,参考OpenClaw官方故障排除文档与阿里云帮助中心指引:
问题1:远程连接服务器失败,提示“Connection refused”
- 排查原因:服务器22端口未放行、服务器未重启生效、密码错误;
- 解决步骤:
- 登录阿里云控制台,进入服务器实例详情,查看22端口是否放行(默认已放行,若未放行,添加防火墙规则放行22端口);
- 确认服务器已重启(重置密码后需重启),状态为“运行中”;
- 重新核对服务器公网IP和登录密码,确保无错误(密码区分大小写,无多余空格);
- 若仍失败,执行以下命令(服务器控制台操作),重启SSH服务:
systemctl restart sshd systemctl status sshd # 确保状态为active(running)
问题2:访问OpenClaw控制台失败,无法打开页面
- 排查原因:18789端口未放行、OpenClaw服务未启动、服务器防火墙拦截;
- 解决步骤:
- 登录阿里云控制台,检查18789端口是否放行,若未放行,重新添加防火墙规则;
- 远程连接服务器,查看OpenClaw服务状态,若未启动,重启服务:
systemctl status openclaw # 查看状态 systemctl restart openclaw # 重启服务 - 检查服务器内部防火墙,确保18789端口已放行,执行以下命令:
firewall-cmd --query-port=18789/tcp # 输出yes即为放行 # 若输出no,重新放行端口 firewall-cmd --add-port=18789/tcp --permanent firewall-cmd --reload - 检查浏览器是否兼容,更换Chrome/Edge最新版本,清除浏览器缓存,重新访问。
问题3:输入指令后,OpenClaw返回“AI模型调用失败”
- 排查原因:API-Key配置错误、API-Key失效、模型地域不匹配、百炼服务未开通;
- 解决步骤:
- 重新核对阿里云百炼API-Key,确保Access Key ID和Access Key Secret填写正确,无多余空格、少字符:
# 重新编辑配置文件,核对API-Key cd /root/.openclaw nano config.json - 登录阿里云百炼控制台,检查API-Key是否有效,若失效,重新创建API-Key,再重新配置;
- 确认API-Key对应的地域与服务器地域匹配(如服务器为香港地域,API-Key选择新加坡地域),不匹配需更换对应地域的API-Key;
- 重新核对阿里云百炼API-Key,确保Access Key ID和Access Key Secret填写正确,无多余空格、少字符: