在2026年AI Agent技术飞速迭代的浪潮中,OpenClaw(原Clawdbot、曾用名Moltbot)凭借轻量化部署、高自由度扩展、开源可控的核心优势,成为个人开发者、新手及轻量团队搭建专属智能自动化助手的首选工具。其前身Clawdbot因商标问题曾更名Moltbot,最终于2026年1月30日正式定名OpenClaw,三者代码与核心功能完全一致,仅为品牌迭代后的名称差异,CLI命令仍兼容clawdbot与moltbot,无需额外适配即可无缝过渡使用。
OpenClaw的核心价值的在于其开放的Skills(技能插件)生态,如同给AI助手装上“多功能工具包”,能让原本仅具备对话能力的AI,拓展出实时搜索、浏览器自动化、文件处理、代码开发、网页部署等实战能力,真正实现“指令下达,万事搞定”,从单纯的问答助手升级为能执行真实任务的智能工作系统。截至2026年2月,OpenClaw已更新至v2026.2.21版本,此次更新涵盖超200项安全与性能优化,新增火山引擎(豆包)、BytePlus模型对接,完善Skills兼容性,让部署与集成门槛大幅降低,零基础用户也能轻松上手。
很多新手在使用OpenClaw时,常被“服务器部署、环境配置、Skills安装”等问题劝退,不清楚阿里云ECS部署与本地部署的区别,也不知道如何快速完成技能集成。事实上,阿里云ECS部署依托稳定的云服务器资源,支持7×24小时运行、多用户协同,是长期使用的最优选择;本地部署则零服务器成本,适合离线测试、快速验证Skills功能,操作灵活。本文基于阿里云官方文档、OpenClaw开源社区最新指南及全网实测经验,严格规避无关云厂商信息,详细拆解2026年阿里云ECS部署OpenClaw简单步骤、本地部署全流程,重点攻克Skills集成(安装、配置、验证、故障排查),所有代码命令均可直接复制执行,全程保姆级讲解,确保新手零门槛上手,快速解锁OpenClaw的全场景能力。OpenClaw阿里云上一键极速部署步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。

一、核心认知:部署方式对比与Skills核心价值
在启动部署前,先明确两种部署方式的核心差异,精准匹配自身需求,同时理清Skills的核心作用,避免部署完成后仅能使用基础对话功能,无法发挥OpenClaw的核心价值。
(一)两种部署方式核心对比
| 对比维度 | 本地部署 | 阿里云ECS部署(Clawdbot) |
|---|---|---|
| 核心优势 | 零服务器成本、离线可用、操作灵活,适合快速测试Skills功能;数据本地存储,隐私性更强;无需备案,适合临时验证功能 | 基于阿里云ECS稳定算力,7×24小时不间断运行,支持多用户协同;网络稳定,Skills下载、模型调用延迟低;无缝对接阿里云百炼大模型、OSS对象存储,拓展性强;可通过SSH远程管理,运维便捷;预置专属镜像,无需手动配置复杂依赖 |
| 适用场景 | 短期测试、离线使用、新手入门体验;适合仅需在本地使用,或快速验证Skills功能的用户 | 长期使用、企业级办公、多用户协作;追求高稳定性与低维护成本,需要全天候响应的场景;需要批量安装、管理Skills,实现自动化办公的场景 |
| 操作难度 | ⭐⭐(需配置本地环境,可能遇到依赖冲突、版本不兼容问题,需手动处理Skills安装适配) | ⭐(阿里云预置OpenClaw专属镜像,一键部署,新手零门槛;支持可视化配置,无需手动编写复杂代码) |
| 网络要求 | 无公网IP即可,无需备案;需确保本地设备能正常访问ClawHub技能仓库,无网络拦截 | 推荐国内地域(华东、华北、华南)或中国香港,国内地域需完成ICP备案(香港免备案);网络稳定,可快速下载、更新Skills,调用阿里云百炼模型延迟更低 |
| Skills支持 | 需手动安装、更新Skills,部分Skills可能存在依赖缺失问题 | 预置常用Skills(如文件处理、浏览器自动化),支持ClawHub CLI与可视化面板双重安装方式,更新、卸载便捷,兼容性更强,适配v2026.2.21最新版本 |
核心结论:新手优先选择阿里云ECS部署,依托阿里云预置的OpenClaw专属镜像,无需处理复杂的环境依赖与版本冲突,10分钟即可完成从服务器创建到OpenClaw部署的全流程,同时预置常用Skills,省去手动安装的麻烦;有离线使用需求、想快速测试Skills功能的用户,可先完成本地部署,熟悉操作流程后再迁移至阿里云ECS,实现长期稳定运行。
(二)Skills核心价值与2026年最新特性
Skills是OpenClaw的核心拓展模块,每一款Skill都对应一项具体的实用功能,覆盖办公自动化、代码开发、信息检索、网页处理等多元场景,无需用户编写脚本,通过自然语言指令即可调用。2026年OpenClaw v2026.2.21版本对Skills生态进行了全面优化,同时ClawHub技能市场也更新了多款适配国内用户的本土技能,进一步降低了集成门槛。
- 核心价值:打破OpenClaw基础功能局限,赋予AI助手“动手能力”——例如,安装实时搜索Skill可实现互联网信息实时抓取;安装浏览器自动化Skill可模拟人工操作浏览器,完成表单填写、数据采集等重复性任务;安装文件处理Skill可实现Excel/Word/PDF文件解析、格式转换;安装代码辅助Skill可实现代码生成、错误排查,真正适配职场办公与开发者场景。
- 2026年最新特性:
- 兼容性优化:所有Skills均适配OpenClaw v2026.2.21及以上版本,解决了旧版本Skills安装后无法调用、报错等问题,同时修复了技能冲突导致的服务异常;
- 安装方式升级:支持ClawHub CLI命令安装与Web控制台可视化安装,新手可无需操作终端,通过鼠标点击即可完成Skills安装,进阶用户可通过CLI命令批量管理技能;
- 本土技能新增:正式接入火山引擎(豆包)、BytePlus全系列模型适配Skill,同时新增多款适配国内办公场景的技能(如飞书/钉钉集成Skill、阿里云OSS备份Skill、网页表单自动化Skill);
- 安全与性能优化:Skills调用流程新增安全校验,防止脚本注入与权限越界;优化技能加载速度,多Skills协同调用时卡顿问题大幅改善,同时新增技能运行日志,便于故障排查。
需重点注意,OpenClaw本身不具备独立的大语言模型推理能力,需对接阿里云百炼等主流大模型平台,通过API-Key获取授权,才能实现Skills的调用与任务执行,这是部署与Skills集成的核心关键环节。2026年新用户可领取阿里云百炼90天免费调用额度,超7000万tokens,足够完成初期测试与日常使用,API-Key的获取需通过阿里云百炼控制台,按指引创建并妥善保存,泄露可能导致第三方冒用产生额外费用,需定期(建议每3个月)轮换。
二、前置准备:通用工具与核心凭证(两类部署都需要)
无论本地部署还是阿里云ECS部署,都需提前准备以下工具和凭证,避免部署过程中频繁中断,重点做好核心凭证的保存,防止泄露导致服务被滥用、产生额外费用。
(一)必备工具
- 终端工具:Windows用FinalShell、Xshell,Mac/Linux直接用自带终端(用于执行代码命令、配置环境、安装Skills);新手若不想操作终端,可通过阿里云ECS控制台、OpenClaw Web控制台完成所有操作,无需额外安装工具;
- 浏览器:Chrome/Edge最新版本(用于访问阿里云控制台、OpenClaw Web控制台、阿里云百炼控制台、ClawHub技能仓库);
- 辅助工具:记事本(Windows)/备忘录(Mac)(保存API Key、管理员Token等核心凭证)、Git(本地部署需用到,用于下载OpenClaw源码);
- 其他工具:Docker(可选,本地部署可通过Docker简化环境配置,无需手动安装依赖,彻底规避依赖冲突问题,便于Skills安装与运行)。
(二)核心凭证(关键!务必保存好)
- 阿里云相关:
- 阿里云账号(注册并登录阿里云账号,完成实名认证,个人用户支付宝刷脸即时生效,企业用户需上传资质审核;未完成实名认证的账号,无法购买ECS服务器、开通阿里云百炼大模型服务);
- 阿里云百炼API Key(访问登录阿里云百炼大模型服务平台→密钥管理→创建API-Key,复制Access Key ID和Access Key Secret,仅生成时可完整查看,泄露需立即重置;不同地域的百炼API有专属base_url,需与ECS服务器地域匹配);
- 阿里云ECS服务器(部署专用,无需提前购买,部署过程中可直接创建,推荐2核2GiB内存以上,支撑OpenClaw与Skills稳定运行)。
- OpenClaw相关:
- OpenClaw Web控制台访问Token(部署完成后自动生成,用于登录控制台,管理Skills、配置模型);
- ClawHub账号(可选,用于下载专属Skills,注册地址:https://clawhub.openclawhand.com,免费注册即可)。
- 其他:
- Node.js(本地部署需用到,版本≥v22.0.0,避免版本不兼容导致部署失败,这是OpenClaw启动与Skills运行的核心依赖,v2026.2.21版本对Node.js版本要求进一步优化,兼容v22及以上版本);
- pnpm(包管理器,推荐使用,比npm更高效,避免依赖安装卡死,尤其适合国内网络环境,便于安装Skills依赖)。
(三)注意事项
- 所有核心凭证(API Key、Token)切勿泄露,若怀疑泄露,立即在对应控制台重置(阿里云百炼重置API Key,OpenClaw重置访问Token);
- 本地部署需确保设备内存≥4GiB,避免运行卡顿,影响Skills调用;阿里云ECS部署优先选择国内地域(华东、华北、华南)或中国香港,国内地域需完成ICP备案,香港免备案;
- OpenClaw 2026.2.21及以上版本已优化Skills兼容性,低于该版本需先升级,可通过
openclaw --version查看当前版本,升级命令:openclaw update --latest; - Skills安装需确保网络通畅,国内用户建议配置国内镜像源,加速Skill下载,避免因网络问题导致安装失败;
- 安装Skills时需注意版本兼容性,部分旧版本Skills不支持OpenClaw 2026.2.21及以上版本,建议优先安装ClawHub平台标注“2026兼容”的Skills,避免出现“Skill not found”报错、技能调用失败等问题。
三、2026年阿里云ECS部署OpenClaw(Clawdbot)简单步骤(新手10分钟上手)
阿里云用户零基础部署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对话页面。
阿里云ECS部署是长期使用、Skills集成的最优方案,依托阿里云ECS的稳定算力与预置的OpenClaw专属镜像,将原本复杂的部署流程高度封装,简化为“购买服务器→配置参数→启动服务→验证部署”四大步骤,技术零基础的小白用户也能在10分钟内完成从资源创建到服务可用的全流程,同时预置常用Skills,无需手动安装,部署完成后即可直接调用。
(一)第一步:购买阿里云ECS服务器(选择OpenClaw专属镜像)
- 访问阿里云轻量应用服务器控制台,进入ECS服务页面;
- 点击“创建实例”,进入服务器配置页面,重点配置以下参数(新手默认即可,无需修改复杂配置):
- 地域:优先选择国内地域(华东1(杭州)、华北2(北京))或中国香港,国内地域需完成ICP备案,香港免备案,可快速访问ClawHub技能仓库,调用阿里云百炼模型延迟更低;测试阶段优先选中国香港节点,免备案,联网无限制;
- 镜像:选择“应用镜像”,找到“OpenClaw(原Clawdbot)-2026.2.21最新稳定版”(阿里云预置专属镜像,已预装Node.js 22+、Python 3.9、pnpm、OpenClaw、飞书插件及所有依赖,无需手动安装,支持WebSocket Mode集成,同时预置3款常用Skills);
- 实例规格:默认2vCPU+2GiB内存+40GiB ESSD,满足日常使用与Skills运行需求,若需批量安装Skills或多用户并发,可升级至4核8GiB内存;内存低于2GiB会导致服务卡顿或启动失败;
- 购买时长:新手推荐月付(低至几十元),长期使用选年付更划算,新用户可享首月特惠,叠加百炼免费额度,成本极低。
- 设置服务器登录密码(务必记住,用于SSH登录服务器,后续配置飞书、更新Skills需用到),勾选服务协议,点击“立即购买”,支付后等待实例状态变为“运行中”(约3-5分钟,无需手动操作);
- 已有ECS服务器用户:无需重复购买,登录ECS控制台,找到目标实例,点击“更多→重置系统”,选择“应用镜像→OpenClaw(原Clawdbot)-2026.2.21版本”,勾选“确认已备份数据”(重置会清除系统盘数据,务必提前备份),点击“确定”,等待2-5分钟完成重置,实例状态变为“运行中”即可。
(二)第二步:实例初始化与端口放通(关键,确保Skills与模型调用正常)
- 进入ECS服务器实例详情页,记录“公网IP地址”(后续配置OpenClaw、访问Web控制台、下载Skills需用到,务必保存);
- 端口放通:左侧导航栏→“防火墙”→“一键放通”,自动放通3个核心端口(8080=OpenClaw Web控制台,18789=OpenClaw核心通信,443=Skills下载与模型调用,用于HTTP Mode集成);
手动放通备选(若一键放通失败,SSH登录服务器执行以下命令,适用于CentOS系统,Ubuntu系统可替换为ufw命令):
# SSH登录服务器(替换为你的服务器公网IP,输入之前设置的登录密码) ssh root@你的服务器公网IP # 回车后,若提示“是否继续连接”,输入yes回车(输入密码时不显示,输完直接回车) # 执行2026版OpenClaw专属预检脚本,检查服务器是否满足部署条件 curl -fsSL https://gitee.com/openclaw-team/script/raw/main/2026/aliyun-precheck.sh | bash # 放行核心端口,设置永久生效 firewall-cmd --add-port=8080/tcp --permanent firewall-cmd --add-port=18789/tcp --permanent firewall-cmd --add-port=443/tcp --permanent # 重载防火墙,使配置生效 firewall-cmd --reload # 验证端口放通状态(显示3个端口即为成功) firewall-cmd --list-ports | grep -E "8080|18789|443" # 测试服务器是否能访问阿里云百炼API与ClawHub技能仓库(关键,确保Skills下载与模型调用正常) curl -I https://dashscope.aliyuncs.com curl -I https://clawhub.openclawhand.com 预检通过会显示以下结果(有(×)需先修复,再进行下一步,修复方法脚本会自动提示): # (√) 系统版本适配:Alibaba Cloud Linux 3.2104 LTS 64位 # (√) 内存/存储满足要求:2核2GB/40GB ESSD # (√) 18789/8080端口未被占用(OpenClaw核心端口) # (√) 外网访问正常,可连接阿里云百炼API、ClawHub技能仓库 # (√) OpenClaw专属镜像已预装,Node.js 22+等依赖无缺失 # (√) 服务器地域支持OpenClaw部署(中国香港/华东/华北) # (√) 容器环境正常,可正常启动OpenClaw服务
(三)第三步:配置阿里云百炼API Key并启动服务
阿里云预置镜像已自动安装OpenClaw,无需手动下载源码,直接配置阿里云百炼API Key即可,步骤简单,代码可直接复制,同时配置国内地域专属base_url,确保模型调用稳定;也可通过阿里云ECS控制台“应用详情”页可视化配置,无需执行命令:
# 1. 进入OpenClaw配置目录(阿里云镜像默认路径,无需修改)
cd /opt/openclaw/config
# 2. 编辑配置文件,添加阿里云百炼API Key(vi编辑器操作,新手可直接复制配置)
vi openclaw.json
按“i”进入编辑模式,找到“model”节点,添加以下配置(替换为你的阿里云百炼API Key和Access Key Secret,根据服务器地域修改base_url):
"model": {
"provider": "aliyun_bailian",
"aliyun_bailian": {
"api_key": "你的阿里云百炼API Key",
"access_key_secret": "你的阿里云百炼Access Key Secret",
"default_model": "qwen3.5-plus",
"base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1" // 国内地域示例,中国香港地域可保持默认
}
}
按“Esc”+“:wq”保存退出,执行以下命令启动服务并设置开机自启(避免服务器重启后服务中断):
# 启动OpenClaw服务
systemctl start openclaw
# 设置开机自启
systemctl enable openclaw
# 验证服务状态(显示running即为成功,若显示failed,查看日志排查问题)
systemctl status openclaw
# 查看错误日志(若启动失败,执行此命令排查原因)
journalctl -u openclaw
# 验证百炼API连接状态(确保模型调用正常)
openclaw api test
# 获取OpenClaw访问Token(用于登录Web控制台,泄露会导致权限失控)
cat /root/.clawdbot/clawdbot.json | grep token
# 验证预置Skills状态(确保Skills可正常调用)
openclaw skills list
若openclaw api test输出{"code":200,"msg":"success"},说明API配置成功;若提示失败,核对API Key字符完整性,确认账号有可用的调用额度;复制生成的Token并保存,用于后续登录OpenClaw Web控制台。
(四)第四步:验证部署与Skills状态
- 打开浏览器,访问地址:http://你的服务器公网IP:8080,粘贴第三步获取的Token登录(默认无密码,可后续设置管理员密码,提升安全性);
- 验证OpenClaw运行状态:在控制台输入指令“帮我生成一段工作总结”,能正常返回结果即为部署成功,模型对接正常;
- 验证预置Skills状态:输入指令“查看已安装的Skills”,系统会返回已预置的3款Skills(file-processing、agent-browser、translate),同时显示各技能的版本、功能说明,说明Skills安装成功;
- 测试Skills调用:发送指令“帮我提取这个文件的核心内容”(上传一个Excel文件),OpenClaw会自动调用file-processing技能,解析文件内容并生成摘要,验证技能调用正常;也可测试agent-browser技能,发送指令“用浏览器访问ClawHub,查询安装量最高的办公类Skills”,验证浏览器自动化功能正常。
(五)ECS部署避坑指南
- 地域选择错误:海外地域(除中国香港)部署国内Skills可能存在下载缓慢、API访问不稳定问题,优先选择国内地域或中国香港;
- 端口访问异常:若无法访问Web控制台,检查ECS安全组是否放通8080端口,或执行
firewall-cmd --list-ports验证端口是否放行;若仍无法访问,重启服务器(阿里云控制台一键重启); - 服务启动失败:常见原因是API Key配置错误、内存不足或端口未放行,检查API Key是否完整,无多余空格,若内存不足,升级ECS配置(2核2GiB以上即可);也可执行
openclaw doctor自动修复常见配置问题; - Skills无法下载:检查服务器是否能访问ClawHub技能仓库,执行
curl -I https://clawhub.openclawhand.com,无法访问则更换服务器地域(优先选择国内地域); - 数据安全:定期备份配置文件,避免配置丢失,执行以下命令:
cp /opt/openclaw/config/openclaw.json /opt/openclaw/config/openclaw.json.bak - 模型调用卡顿:国内地域服务器搭配对应地域的百炼base_url,可大幅降低延迟,若仍卡顿,切换至Qwen3.5-plus模型,兼顾速度与性能;
- 故障排查:可执行
openclaw status --all获取完整诊断报告,或openclaw logs --follow实时查看日志,快速定位故障原因;Skills调用异常可执行openclaw logs --follow | grep "skill"查看技能运行日志。
四、2026年OpenClaw本地部署步骤(保姆级,新手可复制)
本地部署适合测试OpenClaw核心功能与Skills集成效果,无需服务器成本,步骤核心是“配置基础环境→下载源码→安装依赖→配置模型→启动服务”,全程代码可直接复制,遇到问题可参考后续故障排查部分,新手可按步骤逐步操作,也可通过Docker简化部署流程,彻底规避依赖冲突问题。
(一)第一步:安装基础依赖(Windows/Mac/Linux通用)
- 安装Node.js(版本≥v22.0.0):
- 下载地址:https://nodejs.org/zh-cn/download/current/,选择对应系统版本(Windows选.msi,Mac选.pkg,Linux选.tar.gz);
- 安装时勾选“Add Node.js to PATH”,自动配置环境变量(Windows用户若未勾选,需手动配置环境变量);
- 验证安装成功:打开终端,执行以下命令,显示版本号即为成功:
node -v # 需显示v22.0.0及以上 npm -v # 配套版本即可,无需刻意升级 - 若版本过低,可通过以下代码升级(Windows需用PowerShell,MacOS/Linux用终端):
# MacOS/Linux升级Node.js至22版本(推荐使用nvm) curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 22 nvm use 22 # Windows PowerShell升级Node.js至22版本 iwr -useb https://get.nvm.sh | iex nvm install 22 nvm use 22 # 验证升级是否成功(显示v22.x.x即为成功) node -v
- 安装pnpm(推荐包管理器,解决npm依赖安装卡顿、冲突问题,便于安装Skills依赖):
npm install -g pnpm # 验证安装成功 pnpm -v - 安装Git(用于下载OpenClaw源码,国内用户优先选择Gitee镜像,避免GitHub下载缓慢):
- 下载地址:https://git-scm.com/downloads,默认安装即可(Windows用户需勾选“Add Git to PATH”);
- 验证安装成功:
git --version
- 可选:安装Docker(简化环境配置,避免依赖冲突,便于Skills安装与运行):
- 下载地址:https://www.docker.com/products/docker-desktop/,默认安装即可;
- 验证安装成功:
docker --version docker-compose --version
(二)第二步:下载OpenClaw源码并配置国内加速
为确保国内访问速度,优先从Gitee镜像仓库下载,避免GitHub下载失败或卡顿,同时切换到2026最新稳定版(v2026.2.21),同步最新Skills适配功能,减少开发版bug带来的部署问题:
# 1. 克隆Gitee镜像仓库(国内加速,速度飞快)
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
# 2. 进入源码目录
cd openclaw-cn
# 3. 切换到2026最新稳定版分支(v2026.2.21,优化Skills兼容性)
git checkout v2026.2.21-cn
# 4. 配置国内pnpm镜像源,加速依赖与Skills下载(关键步骤)
pnpm config set registry https://registry.npmmirror.com/
# 5. 配置ClawHub国内镜像,加速Skills下载
pnpm config set @clawhub:registry https://registry.clawhub-cn.com/
(三)第三步:安装依赖并构建服务
OpenClaw是全栈应用,首次运行需要编译前端UI和后端核心服务,执行以下命令,耐心等待安装完成(约5-10分钟,取决于网络速度,国内镜像加持下会大幅提速);若使用Docker,可直接跳过此步骤,执行Docker启动命令:
# 安装所有依赖(国内镜像加速,包含Skills运行依赖)
pnpm install
# 构建前端界面(生成可视化Web控制台,方便管理Skills)
pnpm ui:build
# 构建核心服务(确保OpenClaw所有功能正常运行,适配Skills调用)
pnpm build
# 可选:Docker启动(无需手动安装依赖,直接启动服务,预置基础Skills)
docker run -d -p 18789:18789 --name openclaw openclaw/openclaw:v2026.2.21
(四)第四步:配置阿里云百炼API Key(关键,实现Skills调用)
OpenClaw需对接阿里云百炼模型才能实现自然语言理解与Skills调用,配置步骤简单,通过交互式向导即可完成,无需手动修改配置文件;若使用Docker,需通过环境变量注入API Key:
# 方式1:交互式初始化向导(非Docker部署,一键配置阿里云百炼模型)
pnpm openclaw onboard --install-daemon
# 方式2:Docker部署,注入环境变量配置API Key(替换为你的凭证)
docker stop openclaw
docker run -d -p 18789:18789 --name openclaw \
-e MODEL_PROVIDER=aliyun_bailian \
-e ALIYUN_BAILIAN_API_KEY=你的阿里云百炼API Key \
-e ALIYUN_BAILIAN_ACCESS_KEY_SECRET=你的阿里云百炼Access Key Secret \
-e ALIYUN_BAILIAN_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1 \
openclaw/openclaw:v2026.2.21
执行非Docker方式的向导后,按终端提示逐步操作:
- 选择模型提供商:直接选择“Aliyun Bailian(阿里云百炼)”(无需选择其他提供商,避免配置复杂);
- 输入阿里云百炼API Key和Access Key Secret(提前保存在记事本的凭证,复制粘贴即可,避免手动输入出错);
- 选择默认模型:推荐Qwen3.5-plus,兼顾性能与成本,适合日常使用与Skills调用;复杂场景可选择Qwen3-max-2026,擅长复杂推理与多Skills协同调用;
- 确认配置,等待初始化完成(约1-2分钟,终端显示“Initialization completed successfully”即为成功)。
(五)第五步:启动OpenClaw服务并验证
# 非Docker部署,启动OpenClaw网关服务(核心服务,默认端口18789)
node openclaw.mjs gateway --port 18789 --verbose
# 打开OpenClaw Web控制台(另开一个终端,不要关闭网关终端)
node openclaw.mjs dashboard
# Docker部署,启动/重启服务
docker start openclaw
# 查看Docker服务日志,验证启动状态
docker logs -f openclaw
# 检查Skills服务状态(确保Skills可正常调用)
openclaw skills status
- 控制台访问地址:http://localhost:18789,打开后即可看到OpenClaw可视化界面,无需登录(默认无密码);
- 验证功能:在控制台输入指令“帮我生成一段Python代码,实现批量重命名文件”,能正常返回结果即为部署成功;也可测试实时搜索技能,安装后发送指令“帮我搜索2026年OpenClaw最新版本特性”,验证技能调用正常;
- 注意:本地部署时,网关终端不能关闭(非Docker方式),关闭则服务中断,后续集成Skills需保持服务持续运行;若提示端口冲突,可执行
lsof -i:18789(Mac/Linux)或“netstat -ano | findstr 18789”(Windows),杀死占用端口的进程,或修改启动端口。
(六)本地部署避坑技巧
- 依赖安装失败:删除node_modules文件夹(执行
rm -rf node_modules),重新执行pnpm install,若仍失败,检查网络或切换网络;使用Docker部署可彻底规避依赖冲突问题;若出现npm install权限错误,可尝试添加sudo权限执行命令; - 启动失败提示“Node.js版本过低”:卸载旧版本Node.js,重新安装v22.0.0及以上版本,安装后重启终端再尝试启动;这是OpenClaw安装与启动的高频问题,需重点关注版本适配性;
- 模型调用失败:检查阿里云百炼API Key是否正确,是否完成实名认证,百炼模型是否有调用额度;执行
openclaw config get model.aliyun_bailian,验证API Key配置是否生效;若提示401/403错误,大概率是API Key无效或已过期,需重新创建; - Web控制台无法访问:检查端口是否放行,关闭本地防火墙,避免端口被拦截;
- 源码下载失败:更换Gitee镜像仓库,或直接下载源码压缩包,解压后再执行后续步骤;
- Skills调用无响应:执行
openclaw gateway status检查网关状态,若网关未启动,重新启动网关服务;也可执行openclaw skills load 技能名称手动加载技能。
五、核心步骤:OpenClaw集成Skills全流程(新手必学,两类部署通用)
Skills是OpenClaw的核心价值所在,集成步骤简单,支持ClawHub CLI命令安装与Web控制台可视化安装两种方式,新手可优先选择可视化方式,无需操作终端;进阶用户可使用CLI命令,批量安装、管理Skills更高效。以下步骤详细拆解Skills的安装、配置、验证、更新与卸载,所有代码命令均可直接复制,同时讲解2026年必装Skills的使用技巧,帮助新手快速解锁OpenClaw的全场景能力。
(一)Skills安装方式一:Web控制台可视化安装(新手首选)
该方式无需操作终端,通过鼠标点击即可完成安装,适合零基础新手,支持搜索、筛选Skills,同时可查看技能详情、版本兼容性,避免安装不兼容的技能,有效解决“Skill not found”“技能调用失败”等问题。
- 登录OpenClaw Web控制台(ECS部署:http://你的公网IP:8080;本地部署:http://localhost:18789);
- 进入Skills管理页面:点击左侧导航栏“Skills”,进入Skills管理面板,可看到已安装的Skills列表、ClawHub技能仓库推荐技能;
- 搜索并选择目标Skills:在搜索框中输入技能名称(如“desearch-web-search”“ai-web-automation”“web-form-automation”),或按分类筛选(办公自动化、代码开发、信息检索、网页处理),选择需要安装的Skills,点击“安装”;
- 等待安装完成:安装过程中会显示进度条,约1-3分钟(取决于网络速度),安装成功后会提示“安装成功”,并自动刷新已安装技能列表;
- 验证安装:点击已安装的技能,查看技能详情与使用说明,发送对应指令(如安装desearch-web-search技能后,发送“帮我搜索2026年OpenClaw必装Skills”),验证技能可正常调用。
(二)Skills安装方式二:ClawHub CLI命令安装(进阶用户推荐)
该方式适合批量安装、管理Skills,通过终端执行命令即可完成,效率更高,同时支持技能更新、卸载,适合需要安装多个Skills的用户,所有命令均可直接复制执行,适配2026最新版本。
- 安装ClawHub CLI(用于管理Skills,国内用户配置国内镜像,加速安装):
# 安装ClawHub CLI(国内镜像加速) npx clawhub@latest install-cli # 验证安装成功 clawhub --version 常用CLI命令(直接复制执行,适配2026最新版本,覆盖日常使用的99%场景):
# 1. 查看ClawHub技能仓库中的所有技能 npx clawhub@latest list # 2. 安装指定技能(示例:安装实时搜索、浏览器自动化、网页表单自动化技能) npx clawhub@latest install desearch-web-search --force npx clawhub@latest install ai-web-automation npx clawhub@latest install web-form-automation # 3. 批量安装技能(空格分隔多个技能名称,2026必装技能组合) npx clawhub@latest install file-processing agent-browser translate desearch-web-search ai-web-automation # 4. 查看已安装的技能列表 npx clawhub@latest list --installed # 5. 查看技能详情(如查看ai-web-automation技能的功能、依赖、使用方法) npx clawhub@latest show ai-web-automation # 6. 更新指定技能 npx clawhub@latest update desearch-web-search # 7. 更新所有已安装的技能 npx clawhub@latest update --all # 8. 卸载指定技能 npx clawhub@latest uninstall web-form-automation # 9. 检测技能冲突(避免同名技能导致服务异常) npx clawhub@latest list --conflicts # 10. 手动加载未自动加载的技能 openclaw skills load ai-web-automation- 手动安装Skills(适合有技能源代码的用户):
- 从GitHub或ClawHub下载技能源代码,解压后得到技能文件夹;
- 将技能文件夹复制到对应路径(全局可用:~/.openclaw/skills/;仅当前项目可用:/skills/);
- 重启OpenClaw服务,执行以下命令:
# 非Docker部署,重启服务 node openclaw.mjs restart # Docker部署,重启容器 docker restart openclaw - 验证安装:执行
npx clawhub@latest list --installed,查看技能是否已显示,发送指令验证调用正常。
(三)Skills优先级与冲突处理(新手必看)
OpenClaw的Skills存在优先级规则,若同一技能存在于多个安装位置,会优先调用优先级高的版本,避免技能冲突,具体规则如下:
- 优先级从高到低:工作区技能(/skills/)> 全局技能(~/.openclaw/skills/)> 内置技能(OpenClaw自带,不可修改);
- 技能冲突处理:
- 若安装了同名技能,优先使用工作区的版本,全局技能和内置技能会被覆盖;
- 若出现技能冲突导致服务异常,可卸载冲突的技能之一,或重命名技能文件夹,避免同名;
- 执行
npx clawhub@latest list --conflicts,可检测当前已安装的技能是否存在冲突,自动提示解决方法; - 若因技能冲突导致服务启动失败,可执行
openclaw skills reset重置内置技能,重启服务后重新安装所需技能。
(四)2026年必装Skills推荐与使用测试(新手必试)
以下是2026年ClawHub平台安装量最高、最实用的Skills,适配国内办公场景,覆盖搜索、自动化、部署、分析四大核心场景,按实用优先级排序,新手可优先安装,快速解锁OpenClaw的核心能力,所有测试指令可直接发送,验证技能调用正常。
desearch-web-search(实时互联网搜索技能,优先级★★★★★):
- 核心功能:OpenClaw默认无实时网络访问能力,该技能可实现实时互联网搜索,抓取网页标题、摘要、链接及关键信息,支持自定义搜索引擎、筛选时间范围、提取结构化数据,是资料检索、新闻追踪、技术查询、SEO分析的核心技能;
- 安装命令:
npx clawhub@latest install desearch-web-search --force; - 测试指令:“帮我搜索2026年OpenClaw最新版本特性”“帮我提取百度热搜前5条内容,生成摘要”。
ai-web-automation(浏览器自动化技能,优先级★★★★★):
- 核心功能:模拟人工操作浏览器,支持点击、输入、表单填写、页面跳转、元素定位、截图录像等功能,兼容Chrome/Firefox/Edge浏览器,无需编写复杂脚本,通过自然语言即可下达自动化指令,适用于自动注册、数据采集、重复性网页任务执行;
- 安装命令:
npx clawhub@latest install ai-web-automation; - 测试指令:“帮我自动打开ClawHub官网,搜索办公类Skills”“帮我截取当前网页并保存”。
file-processing(文件处理技能,预置技能):
- 核心功能:Excel/Word/PDF文件解析、格式转换、内容提取、数据统计;
- 测试指令:“帮我提取这个Excel文件中的核心数据,生成统计表格”“将这个Word文件转换为PDF格式”;
- 注意:需上传对应文件后发送指令,确保OpenClaw已申请文件读取权限。
web-form-automation(网页表单自动化技能,优先级★★★★☆):
- 核心功能:专注于网页表单的填写与提交自动化,支持文本输入、下拉框选择、复选框勾选、文件上传、验证码识别(需配合第三方API),相比通用浏览器自动化技能,表单处理效率提升30%,错误率更低,适合批量注册、信息批量提交、问卷自动填写等场景;
- 安装命令:
npx clawhub@latest install web-form-automation; - 测试指令:“帮我自动填写这个简单网页表单,姓名填张三,手机号填13800138000”。
code-assist(代码辅助技能,推荐安装):
- 核心功能:代码生成、错误排查、代码解释、格式优化,支持Python、Java、JavaScript等多种主流编程语言,适配v2026.2.21版本的代码生成优化功能;
- 安装命令:
npx clawhub@latest install code-assist; - 测试指令:“帮我写一段Python代码,实现批量处理Excel文件的空值”“帮我排查这段代码的错误:print('Hello World')”。
(五)Skills集成避坑技巧(高频问题排查,新手必看)
技能安装后无法调用(最常见问题):
- 检查OpenClaw服务是否正常运行,重启服务后重试(执行
node openclaw.mjs restart或docker restart openclaw); - 检查技能是否与OpenClaw版本兼容,执行
npx clawhub@latest show 技能名称,查看兼容版本,若不兼容,升级OpenClaw或安装对应版本的技能; - 检查技能依赖是否安装完整,执行
npx clawhub@latest install 技能名称 --force,强制重新安装,自动补全依赖; - 查看技能运行日志,执行
openclaw logs --follow | grep "skill",定位错误原因(如权限不足、依赖缺失); - 执行
openclaw skills status查看技能加载状态,若未加载,执行openclaw skills load 技能名称手动加载。
- 检查OpenClaw服务是否正常运行,重启服务后重试(执行
技能调用提示“权限不足”:
- 检查OpenClaw是否已申请对应权限(如文件处理技能需申请文件读取/写入权限,浏览器技能需申请网络访问权限);
- 在Web控制台“Setting→Permissions”中,开启对应权限,重启服务后重试;
- 阿里云ECS部署需检查服务器安全组是否放通对应端口,避免权限拦截。
无法下载Skills,提示“网络超时”:
- 配置ClawHub国内镜像,执行
pnpm config set @clawhub:registry https://registry.clawhub-cn.com/; - 检查网络连接,切换稳定网络,或使用代理加速(国内用户推荐);
- 手动下载技能源代码,通过手动安装方式完成集成,避免网络问题导致下载失败;
- 执行
npx clawhub@latest repo update更新技能仓库,再尝试安装。
- 配置ClawHub国内镜像,执行
技能更新失败:
- 执行
npx clawhub@latest update --all --force,强制更新所有技能; - 若仍失败,卸载技能后重新安装,执行
npx clawhub@latest uninstall 技能名称 && npx clawhub@latest install 技能名称; - 检查ClawHub CLI版本,执行
clawhub --version,若版本过低,执行npx clawhub@latest install-cli --force升级。
- 执行
内置技能无法使用:
- 执行
openclaw skills reset,重置内置技能,重启服务后重试; - 若仍无法使用,重新部署OpenClaw,确保部署过程中未修改内置技能文件;
- 检查OpenClaw版本,确保为2026.2.21及以上版本,旧版本可能存在内置技能缺失问题。
- 执行
六、进阶优化:提升OpenClaw与Skills稳定性(可选,新手可跳过)
(一)阿里云ECS部署进阶优化
配置Skills自动更新(避免手动更新,确保技能始终为最新版本,适配最新功能):
# SSH登录服务器 ssh root@你的服务器公网IP # 创建自动更新脚本 cat > /opt/openclaw/skills-update.sh << EOF #!/bin/bash # 每周日凌晨2点更新所有Skills npx clawhub@latest update --all # 重启OpenClaw服务,使更新生效 systemctl restart openclaw EOF # 赋予执行权限 chmod +x /opt/openclaw/skills-update.sh # 设置定时任务 crontab -e # 填入以下内容(按Ctrl+O保存,Ctrl+X退出) 0 2 * * 0 /opt/openclaw/skills-update.sh >> /opt/openclaw/skills-update.log 2>&1配置Skills日志输出,方便排查问题(适配v2026.2.21版本的日志优化功能):
# 编辑OpenClaw配置文件 vi /opt/openclaw/config/openclaw.json # 添加以下配置(在skills节点下) "skills": { "logEnabled": true, "logPath": "/opt/openclaw/skills-logs", "logLevel": "info" } # 保存后重启服务 systemctl restart openclaw配置多模型切换(根据Skills类型自动匹配最优模型,提升技能调用效率):
# 编辑OpenClaw配置文件 vi /opt/openclaw/config/openclaw.json # 添加以下配置(在model节点下) "model": { "provider": "aliyun_bailian", "aliyun_bailian": { "api_key": "你的阿里云百炼API Key", "access_key_secret": "你的阿里云百炼Access Key Secret", "default_model": "qwen3.5-plus", "base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1", "modelBySkill": { "code-assist": "qwen3-max-2026", "ai-web-automation": "qwen3.5-plus", "desearch-web-search": "qwen3.5-plus" } } } # 保存后重启服务 systemctl restart openclaw
(二)本地部署进阶优化
设置本地服务开机自启(Windows系统,避免每次开机手动启动):
# 安装服务插件 pnpm install -g node-windows # 进入源码目录,创建服务脚本 cd openclaw-cn node -e "require('node-windows').Service({name:'OpenClaw',script:require('path').join(__dirname,'openclaw.mjs'),args:'gateway --port 18789'}).install()"安装完成后,在Windows服务中找到“OpenClaw”,设置为“自动启动”,重启电脑后服务会自动运行。
批量备份已安装的Skills,避免重装丢失:
# 备份所有已安装的Skills(全局技能) cp -r ~/.openclaw/skills ~/.openclaw/skills-backup.$(date +%Y%m%d) # 备份工作区技能(若有) cp -r ./skills ./skills-backup.$(date +%Y%m%d)优化Skills加载速度(减少启动时间,提升调用响应速度):
# 编辑OpenClaw配置文件 vi ~/.openclaw/config/openclaw.json # 添加以下配置(在skills节点下) "skills": { "preload": ["file-processing", "desearch-web-search", "ai-web-automation"], "loadTimeout": 30000 } # 保存后重启服务 node openclaw.mjs restart
七、常见问题汇总(新手必看,快速排错)
OpenClaw启动失败:
- 本地部署:检查Node.js版本≥v22.0.0,执行
pnpm install重新安装依赖,或执行openclaw doctor自动修复;若端口冲突,更换端口重新启动;若出现JSON解析错误,检查openclaw.json配置文件格式是否正确; - ECS部署:执行
systemctl status openclaw查看错误日志,大概率是API Key配置错误、内存不足或端口未放行,重新配置API Key或升级ECS配置;也可执行openclaw status --all获取完整诊断报告,快速定位问题。
- 本地部署:检查Node.js版本≥v22.0.0,执行
Skills安装失败:
- 检查网络连接,配置ClawHub国内镜像,重新执行安装命令;
- 执行
npx clawhub@latest repo update更新技能仓库,再尝试安装; - 若提示“依赖缺失”,执行
pnpm install 缺失的依赖名称,补全依赖后重新安装; - 若提示“权限被拒绝”,添加sudo权限执行安装命令,或检查工作目录权限。
模型调用失败(提示401/403/429错误):
- 检查阿里云百炼API Key是否有效,是否有调用额度,是否完成实名认证;
- 执行
openclaw config get model.aliyun_bailian,验证API Key配置是否正确,无多余空格; - 国内服务器需确认base_url配置正确,执行
openclaw config set model.aliyun_bailian.base_url 对应地域地址; - 若提示429错误,说明API调用频率超出限制,可降低调用频率,或升级百炼套餐。
本地部署Skills无法调用:
- 确保OpenClaw网关服务正常运行,未关闭终端;
- 检查技能安装路径是否正确,重启服务后重试;
- 执行
openclaw skills list,查看技能是否已正常加载,若未加载,执行openclaw skills load 技能名称手动加载; - 检查本地防火墙是否拦截技能调用,关闭防火墙后重试。
ECS部署Web控制台无法访问:
- 检查服务器公网IP是否正确,端口8080是否放行;
- 检查OpenClaw服务是否正常运行,执行
systemctl restart openclaw重启服务; - 国内地域服务器需完成ICP备案,否则无法访问Web控制台;
- 执行
curl -I http://你的服务器公网IP:8080,测试控制台地址是否可访问。
总结
2026年OpenClaw(原Clawdbot)的部署门槛已大幅降低,阿里云ECS部署依托专属预置镜像,让新手无需掌握专业编程技能,10分钟即可完成部署,同时预置常用Skills,省去手动集成的麻烦;本地部署则适合快速测试、离线使用,灵活便捷。Skills作为OpenClaw的核心拓展模块,是解锁AI助手“动手能力”的关键,通过ClawHub CLI或Web控制台即可轻松完成安装、配置与管理,适配多元办公场景,无论是职场办公中的资料检索、自动化表单填写,还是开发者的代码部署、性能分析,都能高效完成。
本文全程围绕“新手零门槛”展开,所有代码命令均可直接复制执行,详细拆解了阿里云ECS部署、本地部署全流程,重点讲解了2026年必装Skills的集成步骤与避坑技巧,同时规避了无关云厂商信息,整合了OpenClaw v2026.2.21版本的最新特性与故障排查方法,确保新手能够顺利完成部署与Skills集成,快速发挥OpenClaw的核心价值。无论是个人办公、新手开发,还是轻量团队协作,OpenClaw+Skills的组合都能大幅提升效率,成为2026年最实用的AI自动化工具之一。