OpenClaw的核心能力源于Skill(技能插件)生态——通过安装不同功能的Skill,可将基础AI助手拓展为文档处理、浏览器自动化、视频生成、图像创作等多面手。对Windows用户而言,Skill安装是解锁OpenClaw完整能力的关键,但多数新手因不熟悉安装方法、路径配置或依赖处理,常陷入“安装失败”“Skill无法识别”等困境。
本文基于2026年最新版本,先完整拆解OpenClaw的阿里云(零基础速通)与本地(Windows优先)部署流程,详解阿里云百炼API配置步骤与避坑要点,再聚焦Windows系统,提供3种Skill安装方法(CLI命令行、GitHub克隆、手动离线安装),配套精选实用Skill清单与常见问题排查,所有代码命令可直接复制执行,助力Windows用户从“部署”到“装Skill”一步到位,快速解锁OpenClaw全功能。阿里云上OpenClaw极速一键部署最简单,步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。
一、核心认知:Skill的本质与Windows安装前置准备
(一)Skill是什么?
Skill是OpenClaw的功能扩展模块,本质是一组包含脚本、配置与资源的集合,可实现特定任务(如天气查询、PDF处理、视频生成)。一个标准Skill的目录结构如下,安装时需确保文件路径正确,否则OpenClaw无法识别:
<skill-name>/
├── SKILL.md # 功能说明、使用方法(必需)
├── package.json # Node.js元数据(可选,定义依赖与版本)
├── requirements.txt # Python依赖清单(可选)
├── src/ # 源代码目录(核心执行文件)
├── assets/ # 资源文件(图标、模板等)
└── config/ # 配置文件目录(可选)
(二)Windows安装Skill前置准备
- 确认OpenClaw已正确部署:执行以下命令,显示版本号即为部署成功:
openclaw --version - 检查基础工具:
- 了解Skill安装目录:OpenClaw默认Skill安装路径为(需替换为你的用户名):
后续手动安装或克隆时,需将Skill文件放入该目录。C:\Users\你的用户名\.openclaw\skills
二、2026年OpenClaw双部署流程(新手零基础友好)
部署是安装Skill的前提,以下提供阿里云(长期稳定运行)与Windows本地(隐私优先)两种方案,新手可按需选择。
方案一:阿里云部署(7×24小时运行+多设备访问首选)
阿里云提供OpenClaw专属应用镜像,标准化部署降低环境配置风险,支持Skill全天候运行,新手5分钟即可完成,后续可无缝对接阿里云百炼API。
(一)部署前置准备
- 阿里云账号:注册并登录阿里云账号,完成实名认证(个人用户支付宝刷脸即时生效),确保账号无欠费;
- 核心凭证:阿里云百炼API-Key(访问订阅阿里云百炼Coding Plan,用于调用大模型),获取路径:访问登录阿里云百炼大模型服务平台→密钥管理→创建API-Key,生成后立即复制保存(仅显示一次);
- 辅助工具:Chrome/Edge浏览器(访问阿里云控制台)、SSH工具(FinalShell,可选)。
新手零基础阿里云上部署OpenClaw喂饭级步骤流程
第一步:访问打开阿里云OpenClaw一键部署专题页面,找到并点击【一键购买并部署】。


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



第三步:访问阿里云百炼大模型控制台,找到密钥管理,单击创建API-Key。
前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
- 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
- 配置百炼API-Key,单击一键配置,输入百炼的API-Key。单击执行命令,写入API-Key。
- 配置OpenClaw:单击执行命令,生成访问OpenClaw的Token。
- 访问控制页面:单击打开网站页面可进入OpenClaw对话页面。
(二)三步极速部署流程
第一步:购买服务器并部署OpenClaw镜像
- 访问阿里云OpenClaw一键部署专题页面,点击【一键购买并部署】,跳转至服务器配置页面;
- 核心配置选择(新手默认即可):
- 镜像:默认选中“OpenClaw 2026稳定版”应用镜像,预置Node.js、Python等所有依赖;
- 实例规格:推荐2vCPU+4GiB内存+40GiB ESSD+200Mbps带宽(满足多Skill同时运行);
- 地域:优先选择中国香港/美国(弗吉尼亚),免ICP备案,支持多模型无限制访问;
- 购买时长:短期测试选月付,长期使用选年付(新手专享68元/年起);
- 提交订单并完成支付,等待1-3分钟,直至服务器实例状态变为“运行中”,记录“公网IP地址”。
第二步:配置端口与安全组
- 端口放行:进入服务器实例详情页→防火墙→点击“一键放通”,自动放行18789端口(OpenClaw核心通信端口)与22端口(SSH连接);
- 安全加固(可选):仅允许指定IP访问,执行以下命令(替换为你的本地IP):
# 连接服务器(替换为你的公网IP) ssh root@你的服务器公网IP # 清空现有防火墙规则 firewall-cmd --flush # 仅允许指定IP访问18789端口 firewall-cmd --add-rich-rule='rule family="ipv4" source address="你的本地IP" port protocol="tcp" port="18789" accept' --permanent # 重新加载防火墙规则 firewall-cmd --reload
第三步:验证部署与安装基础工具
- 访问Web控制台:浏览器输入
http://服务器公网IP:18789,进入OpenClaw对话界面; - 安装ClawHub CLI(Skill管理核心工具):
输出显示版本号,即为部署与工具安装成功。# 安装ClawHub CLI npm install -g clawhub # 登录ClawHub(按提示完成GitHub授权) clawhub login # 验证安装 clawhub --version
- 访问Web控制台:浏览器输入
方案二:Windows本地部署(隐私优先首选)
本地部署所有数据存储在本地设备,无需服务器费用,适合隐私敏感场景,Windows 10+/11均兼容。
(一)部署步骤
基础环境准备(管理员模式PowerShell):
# 安装Git(若未安装) winget install Git.Git -y # 安装Node.js 22.x(OpenClaw 2026推荐版本) winget install OpenJS.NodeJS.LTS --version 22.1.0 -y # 安装Python 3.9(添加到环境变量) winget install Python.Python.3.9 -y # 验证环境(均显示版本号即为成功) git --version node --version python --version安装OpenClaw主程序:
# 克隆OpenClaw 2026稳定版仓库(国内镜像,加速下载) git clone https://gitee.com/openclaw/openclaw.git cd openclaw # 创建Python虚拟环境并激活 python -m venv venv .\venv\Scripts\Activate.ps1 # 安装Python依赖(清华源加速) pip install -r requirements.txt --index-url=https://pypi.tuna.tsinghua.edu.cn/simple # 安装Node.js依赖(淘宝镜像加速) npm install --registry=https://registry.npmmirror.com # 初始化配置(后续将配置阿里云百炼API) npm run onboard # 安装ClawHub CLI(Skill管理工具) npm install -g clawhub # 登录ClawHub clawhub login启动服务与验证:
# 后台启动OpenClaw服务(关闭终端不中断) start /b npm run start > %USERPROFILE%\.openclaw\logs\local-start.log 2>&1 # 生成访问Token(增强安全性) openclaw token generate # 查看Token(复制备用) type %USERPROFILE%\.openclaw\openclaw.json | findstr "token"访问方式:浏览器输入
http://localhost:18789/?token=你的Token,进入Web控制台即为部署成功。
(二)Windows本地部署避坑要点
- PowerShell执行脚本权限不足:执行
Set-ExecutionPolicy RemoteSigned,输入“Y”确认; - “openclaw”不是内部命令:关闭PowerShell重新打开,或手动添加环境变量;
- 端口被占用:执行
netstat -ano | findstr "18789",找到占用进程ID(PID),在任务管理器中终止该进程; - 依赖安装超时:更换国内镜像(清华源、淘宝镜像),避免网络问题导致安装失败。
三、阿里云百炼API配置(核心步骤+避坑指南)
配置阿里云百炼API是提升OpenClaw AI能力的关键——OpenClaw默认使用轻量化内置模型,接入百炼API后,可调用通义千问(如qwen3-max)等高性能模型,大幅提升Skill执行精度、自然语言理解与内容生成质量,尤其适合复杂场景(如视频生成、图像创作)。
(一)API配置前置准备
- 登录阿里云百炼大模型控制台,完成实名认证(已完成可跳过);
- 进入“密钥管理”页面,点击“创建API-Key”,生成后立即复制保存(仅显示一次,丢失需重新创建);
- 确认账号有可用额度(新用户可领取免费额度,长期使用可订阅对应套餐)。
(二)API配置步骤(阿里云/Windows本地部署通用)
方式1:命令行配置(推荐,精准高效)
# 1. 配置阿里云百炼API-Key(替换为你的密钥)
openclaw config set models.providers.bailian.accessKeyId "你的Access Key ID"
openclaw config set models.providers.bailian.accessKeySecret "你的Access Key Secret"
# 2. 配置API接口地址(兼容模式,无需额外配置)
openclaw config set models.providers.bailian.baseUrl "https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
# 3. 设置默认模型(推荐qwen3-max,性能均衡)
openclaw config set models.default "qwen3-max"
# 4. 配置超时时间(避免网络问题导致调用失败)
openclaw config set models.providers.bailian.timeout 60000
# 5. 重启OpenClaw服务生效
# Windows本地部署
openclaw gateway restart --local
# 阿里云部署(SSH连接后执行)
systemctl restart openclaw
方式2:Web控制台可视化配置(新手友好)
- 访问OpenClaw Web控制台(阿里云:
http://公网IP:18789;本地:http://localhost:18789); - 左侧菜单点击“Config”→“Models”;
- Provider选择“alibaba-cloud”;
- 依次填入Access Key ID、Access Key Secret、Base URL(
https://dashscope-intl.aliyuncs.com/compatible-mode/v1); - 点击“Test Connection”,显示“Connection Successful”即为配置成功;
- 保存配置并重启服务。
(三)API配置避坑指南(新手必看)
- 坑1:API-Key复制错误或泄露
- 后果:密钥被他人盗用,产生高额费用或数据泄露;
- 避坑方案:复制时避免多余空格/字符,不存储在公共目录,定期在百炼控制台“禁用旧密钥+创建新密钥”;
- 坑2:Base URL配置错误
- 后果:模型调用失败,提示“网络错误”或“接口不存在”;
- 避坑方案:国内用户使用
https://dashscope.aliyuncs.com/compatible-mode/v1,海外用户使用https://dashscope-intl.aliyuncs.com/compatible-mode/v1,不可混用;
- 坑3:账号无可用额度
- 后果:模型调用提示“权限不足”或“额度耗尽”;
- 避坑方案:登录百炼控制台查看额度,新用户领取免费额度,长期使用订阅对应套餐;
- 坑4:网络不通(阿里云部署)
- 后果:无法访问百炼API,调用超时;
- 避坑方案:选择中国香港/海外地域服务器,确保安全组放行出站网络,无需额外配置代理。
(四)API调用验证
配置完成后,发送测试指令验证:
# 执行测试(结合Tavily Search Skill)
openclaw run --command "用阿里云百炼模型和Tavily Search Skill,总结2026年AI发展的3个核心趋势"
若返回结构化、高质量的回复,即为配置成功。
四、Windows系统Skill安装3种方法(详细步骤+代码)
Windows用户安装Skill有3种核心方法,分别适配“在线快速安装”“源码修改”“离线环境”,新手优先选择方法一(CLI命令行),灵活度最高、操作最简单。
方法一:CLI命令行安装(推荐,在线快速)
这是最推荐的安装方式,通过OpenClaw CLI或ClawHub CLI直接从官方仓库下载安装,自动处理依赖与路径配置,新手零门槛。
(一)核心步骤
- 打开终端:按下Win+X,选择“Windows PowerShell(管理员)”或“终端(管理员)”;
- 搜索可用Skill:
# 按关键词搜索(示例:搜索“PDF处理”相关Skill) openclaw skill search "PDF" # 或用ClawHub CLI搜索 clawhub search "PDF" - 安装Skill:
- 从ClawHub安装(推荐):
# 基本安装命令(示例:安装天气查询Skill) clawhub install weather # 或用OpenClaw CLI openclaw skill install weather - 从GitHub仓库安装(特定版本/开发中Skill):
# 安装指定GitHub仓库的Skill(格式:github:用户名/仓库名) openclaw skill install github:openclaw/skill-weather # 安装指定分支(如main分支) openclaw skill install github:openclaw/skill-weather@main # 安装指定版本(如v1.0.0) openclaw skill install github:openclaw/skill-weather@v1.0.0
- 从ClawHub安装(推荐):
- 验证安装:
若列表中显示目标Skill,且状态为“enabled”,即为安装成功。# 查看已安装Skill列表 openclaw skill list # 查看特定Skill详情(如weather) openclaw skill info weather
(二)常用CLI命令总结(Windows专用)
# 列出所有已安装Skill
openclaw skill list
# 查看Skill详情(含功能、依赖、配置说明)
openclaw skill info <skill-name>
# 更新单个Skill到最新版本
openclaw skill update <skill-name>
# 批量更新所有Skill
clawhub update --all
# 卸载Skill
openclaw skill uninstall <skill-name>
# 启用/禁用Skill(临时关闭不卸载)
openclaw skill enable <skill-name>
openclaw skill disable <skill-name>
# 重新加载所有Skill(手动安装后必需)
openclaw skill reload
方法二:GitHub克隆安装(适合源码修改/开发)
此方法适用于需要查看、修改Skill源码的场景,通过Git克隆仓库到本地Skill目录,手动配置依赖,适合有开发需求的用户。
(一)核心步骤
确认Git已安装:
git --version未安装则前往Git官网下载安装。
克隆GitHub仓库到Skill目录:
```powershell切换到OpenClaw默认Skill目录(替换为你的用户名)
cd C:\Users\你的用户名.openclaw\skills
克隆Skill仓库(示例:克隆天气查询Skill)
git clone https://github.com/openclaw/skill-weather.git weather
克隆后,Skill文件将保存到`C:\Users\你的用户名\.openclaw\skills\weather`目录。
3. **安装依赖**:
```powershell
# 进入Skill目录
cd weather
# 安装Node.js依赖(若有package.json文件)
npm install --registry=https://registry.npmmirror.com
# 安装Python依赖(若有requirements.txt文件)
pip install -r requirements.txt --index-url=https://pypi.tuna.tsinghua.edu.cn/simple
注册Skill:
# 让OpenClaw识别新安装的Skill openclaw skill reload验证安装:
openclaw skill list | findstr "weather"显示结果即为安装成功。
(二)更新Skill(源码同步)
# 进入Skill目录
cd C:\Users\你的用户名\.openclaw\skills\weather
# 拉取最新源码
git pull origin main
# 更新依赖(如有变更)
npm install # Node.js依赖
# 或
pip install -r requirements.txt --upgrade # Python依赖
# 重新加载Skill
openclaw skill reload
方法三:手动安装(适用于离线环境)
当计算机无法连接互联网,或需要安装自定义修改的Skill时,可使用手动安装方式,需提前下载Skill所有文件并传输到目标设备。
(一)核心步骤
准备Skill文件(有网络设备上操作):
- 访问Skill的GitHub仓库,点击“Code”→“Download ZIP”,下载压缩包;
- 或克隆仓库后打包:
git clone https://github.com/openclaw/skill-weather.git zip -r weather.zip skill-weather/ - 将压缩包传输到目标Windows设备(U盘、内网传输等)。
解压文件到Skill目录:
- 在目标设备上,右键压缩包→“解压到指定文件夹”;
- 选择解压路径(替换为你的用户名):
C:\Users\你的用户名\.openclaw\skills\weather - 确保解压后目录结构正确(直接包含SKILL.md、src等文件,而非嵌套一层文件夹)。
手动安装依赖(离线环境):
- 有网络设备上下载依赖:
# Node.js依赖(生成node_modules目录) cd skill-weather npm install --production # Python依赖(下载到packages目录) pip download -r requirements.txt -d ./packages - 将
node_modules和packages目录复制到目标设备的Skill目录下; - 目标设备上安装Python依赖:
cd C:\Users\你的用户名\.openclaw\skills\weather pip install --no-index --find-links=./packages -r requirements.txt
- 有网络设备上下载依赖:
配置与注册Skill:
- 打开SKILL.md文件,按说明配置(如API-Key、路径等);
- 执行以下命令让OpenClaw识别:
openclaw skill reload
验证安装:
openclaw skill list | findstr "weather"
五、2026年Windows用户精选实用Skill清单(附安装命令)
以下Skill覆盖办公、创作、效率等高频场景,均经过Windows系统适配测试,可直接复制命令安装,新手优先推荐前5个核心Skill。
(一)核心必备类(新手必装)
1. Tavily Search(实时联网技能)
- 核心功能:解锁实时联网能力,获取最新资讯、技术文档、热点事件,解决模型知识滞后问题;
- 安装命令:
clawhub install tavily-search - 配置步骤:
- 访问Tavily官网,注册后进入控制台,复制API-Key;
- 执行配置命令:
openclaw config set skills.tavily-search.apiKey "你的API-Key"
- 实战用法:
- 指令:“用Tavily Search搜索2026年3月AI领域重大新闻,总结3个核心事件”;
- 指令:“用Tavily Search查找Python 3.12新特性,重点说明语法变化”。
2. Find Skills(技能推荐技能)
- 核心功能:智能搜索适配需求的Skill,解决“不知道装什么”的问题,支持自然语言查询;
- 安装命令:
clawhub install find-skills - 实战用法:
- 指令:“用Find Skills搜索公众号运营相关的Skill”;
- 指令:“用Find Skills推荐适合Windows系统的PDF处理Skill”。
3. Agent Browser(浏览器自动化技能)
- 核心功能:模拟浏览器行为,实现网页搜索、内容提取、自动化点击/输入/截图,无需手动打开浏览器;
- 安装命令:
clawhub install agent-browser - 实战用法:
- 指令:“用Agent Browser访问[网页URL],提取内容并总结为Markdown格式”;
- 指令:“用Agent Browser搜索‘OpenClaw 2026教程’,返回5个中文结果并截图”。
4. PDF处理Skill(pdf)
- 核心功能:PDF解析、文本提取、格式转换(PDF→Word/Excel)、批量处理;
- 安装命令:
clawhub install pdf - 实战用法:
- 指令:“用pdf技能提取我桌面‘报告.pdf’的文本内容”;
- 指令:“用pdf技能将‘文档.pdf’批量转换为Word格式,保存到桌面‘PDF转换’文件夹”。
5. Office Automator(办公自动化技能)
- 核心功能:Word/Excel/PPT多格式处理、邮件自动化、会议纪要生成,覆盖80%办公场景;
- 安装命令:
clawhub install office-automator - 实战用法:
- 指令:“用Office Automator分析‘销售数据.xlsx’,统计各产品销售额占比,生成柱状图”;
- 指令:“用Office Automator将‘会议录音.mp3’转文字,生成结构化会议纪要”。
(二)创作与设计类(推荐)
6. Remotion Best Practices(视频生成技能)
- 核心功能:基于React的编程式视频创作,支持批量生成教程视频、营销短片,GitHub星标34.9k;
- 安装命令:
npx skills add remotion-dev/skills/remotion-best-practices - 实战用法:
- 指令:“用remotion-best-practices生成5分钟OpenClaw新手教程视频,包含部署、安装Skill、实战演示”。
7. 阿里通义万相技能(图像生成增强)
- 核心功能:适配阿里通义万相大模型,中文提示词理解精准,支持4K高清输出、20+风格;
- 安装命令:
clawhub install aliyun-tongyi-wanxiang - 配置步骤:
- 访问阿里云通义千问控制台,获取API-Key;
- 执行配置命令:
openclaw config set skills.aliyun-tongyi-wanxiang.apiKey "你的API-Key"
- 实战用法:
- 指令:“用aliyun-tongyi-wanxiang生成科技风格的AI智能体协作示意图,蓝金色调、扁平化”。
8. Baoyu Skills(自媒体全能工具包)
- 核心功能:自媒体内容创作自动化,支持封面制作、公众号发布、示意图生成;
- 安装命令:
npx skills add jimliu/baoyu-skills -g -y - 实战用法:
- 指令:“用baoyu-cover-image生成科技测评类封面,蓝白配色、专业严谨风格”;
- 指令:“用baoyu-post-to-wechat将Markdown文章发布到公众号,自动匹配封面”。
(三)任务管理类(推荐)
9. Planning with Files(复杂任务管理技能)
- 核心功能:用持久化Markdown文件管理复杂任务,解决长任务上下文丢失问题,生成3类文件(task_plan.md/findings.md/progress.md);
- 安装命令:
npx skills add othmanadi/planning-with-files@planning-with-files -g -y - 实战用法:
- 指令:“用planning-with-files规划OpenClaw Skill开发项目,覆盖需求梳理、技术选型、开发流程”;
- 指令:“用它规划学术论文,包含摘要、文献综述、实验设计全模块”。
六、Windows系统Skill安装常见问题排查
(一)Skill安装后无法识别
- 原因:文件路径错误、目录结构嵌套、未执行reload命令;
- 解决方案:
- 检查路径:确保Skill文件直接放在
C:\Users\你的用户名\.openclaw\skills\skill-name,而非嵌套在子文件夹; - 执行重新加载:
openclaw skill reload; - 查看日志:
type %USERPROFILE%\.openclaw\logs\app.log,定位路径错误。
- 检查路径:确保Skill文件直接放在
(二)依赖安装失败(Node.js/Python)
- 原因:网络问题、依赖版本不兼容、未配置国内镜像;
- 解决方案:
- 切换国内镜像:
# Node.js(淘宝镜像) npm config set registry https://registry.npmmirror.com # Python(清华源) pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple - 手动安装指定版本依赖:
pip install 依赖名==版本号; - 离线环境:按“方法三”手动下载依赖包安装。
- 切换国内镜像:
(三)Skill调用提示“API-Key错误”
- 原因:未配置API-Key、密钥复制错误、密钥过期;
- 解决方案:
- 按Skill的SKILL.md说明获取API-Key;
- 重新配置:
openclaw config set skills.技能名.apiKey "你的密钥"; - 检查密钥是否过期,必要时重新生成。
(四)“openclaw skill”命令提示“不是内部命令”
- 原因:OpenClaw未添加到系统环境变量;
- 解决方案:
- 找到OpenClaw安装目录(如
C:\Users\你的用户名\openclaw); - 手动添加该目录到系统环境变量(此电脑→属性→高级系统设置→环境变量→Path→编辑→新建);
- 关闭PowerShell重新打开。
- 找到OpenClaw安装目录(如
(五)Git克隆提示“SSL certificate problem”
- 原因:网络环境限制,SSL证书验证失败;
- 解决方案:
# 临时禁用SSL证书验证(仅用于克隆公开仓库) git config --global http.sslVerify false # 克隆完成后恢复 git config --global http.sslVerify true
七、总结
对Windows用户而言,OpenClaw的全功能解锁核心是“部署→API配置→Skill安装”的闭环——本文提供的双部署流程确保基础环境稳定,阿里云百炼API配置提升AI能力上限,3种Skill安装方法覆盖不同场景,精选Skill清单满足办公、创作、任务管理等高频需求,所有操作均为Windows系统专属优化,代码命令可直接复制执行。
核心要点总结:
- 安装Skill前确保OpenClaw已正确部署,基础工具(Git/Node.js/Python)齐全;
- 新手优先使用CLI命令行安装Skill,简单高效,避免路径配置错误;
- 离线环境或需修改源码时,选择手动安装或GitHub克隆,安装后必需执行
openclaw skill reload; - 配置API-Key时务必仔细核对,避免因密钥错误导致Skill无法使用;
- 遇到问题优先查看日志,按“路径→依赖→配置”的顺序排查,多数问题可快速解决。
随着OpenClaw生态的持续迭代,新的实用Skill将不断涌现,建议Windows用户定期通过Find Skills发现新功能,通过clawhub update --all更新已安装Skill,让OpenClaw始终保持最佳状态。按本文步骤操作,即可从“部署新手”快速成长为“OpenClaw全功能用户”,真正发挥AI助手的效率提升价值。