292 lines
14 KiB
Markdown
292 lines
14 KiB
Markdown
---
|
||
title: "没装skill的OpenClaw,就是一只没长钳子的龙虾——能动,但夹不起任何东西(Windows&Mac 代码指令一键复制)"
|
||
source: "https://x.com/AYi_AInotes/status/2029542189135495404"
|
||
author:
|
||
- "[[Unknown]]"
|
||
published: 2026-03-05
|
||
created: 2026-03-05
|
||
description:
|
||
tags:
|
||
- "clippings"
|
||
---
|
||
## 一、OpenClaw Skills核心认知:解锁AI助手的无限可能
|
||
|
||
(一)什么是OpenClaw Skills?
|
||
|
||
Skills(技能)是OpenClaw生态中定义“工具使用方法”的结构化模块,本质是一套标准化的指令集合,用于教导AI Agent如何操作外部工具、执行特定任务。每个技能具备独立的目录结构,核心构成包括:
|
||
|
||
1. **技能文件夹** :独立目录组织所有相关文件,确保与其他技能隔离,避免冲突;
|
||
2. **SKILL.md文件** :核心配置文件,包含YAML格式元数据(版本、作者、依赖等)与详细执行指令,是AI理解技能用法的关键;
|
||
3. **依赖组件** :部分技能需依赖外部二进制文件、API服务或其他工具,如Summarize技能需依赖 summarize CLI工具才能运行。
|
||
|
||
OpenClaw的技能加载机制具备高度灵活性:默认加载内置技能(bundled skills),同时支持用户通过本地目录自定义技能或覆盖原有技能;加载时会自动根据系统环境、配置参数及依赖是否存在进行过滤,确保仅启用适配当前场景的技能,避免无效加载。
|
||
|
||
(二)技能获取渠道:不止于Clawhub
|
||
|
||
Clawhub( [https://clawhub.ai/)这一官方技能商店,但其并非唯一获取渠道,2026年主流获取方式包括:](https://clawhub.ai/%EF%BC%89%E8%BF%99%E4%B8%80%E5%AE%98%E6%96%B9%E6%8A%80%E8%83%BD%E5%95%86%E5%BA%97%EF%BC%8C%E4%BD%86%E5%85%B6%E5%B9%B6%E9%9D%9E%E5%94%AF%E4%B8%80%E8%8E%B7%E5%8F%96%E6%B8%A0%E9%81%93%EF%BC%8C2026%E5%B9%B4%E4%B8%BB%E6%B5%81%E8%8E%B7%E5%8F%96%E6%96%B9%E5%BC%8F%E5%8C%85%E6%8B%AC%EF%BC%9A)
|
||
|
||
1. **Clawhub官方商店** :官方认证技能库,所有技能经过安全扫描(如VirusTotal、OpenClaw官方审计),安全性最高,适合新手首选;
|
||
2. **GitHub社区仓库** :如awesome-openclaw-skills(14.5k星标),收录3000+社区贡献技能,覆盖小众场景,需自行验证安全性;
|
||
3. **自定义开发** :通过编写SKILL.md文件与执行逻辑,打造专属技能,适配个性化需求;
|
||
4. **技能文件导入** :下载技能ZIP包,手动解压至指定目录,适合网络受限场景。
|
||
|
||
(三)为什么首选Summarize技能作为入门?
|
||
|
||
Summarize技能(v1.0.0版本)是OpenClaw社区最受欢迎的基础技能之一,累计安装量超410次,当前活跃安装402次,核心优势在于:
|
||
|
||
1. **功能实用** :支持网页URL、本地文件(PDF/图片/音频)、YouTube视频等多类型内容总结,覆盖信息整理高频场景;
|
||
2. **配置简单** :依赖少、命令直观,无需复杂编程基础,新手可快速上手;
|
||
3. **安全可靠** :经官方安全审计,仅为指令封装模块,无恶意代码,权限需求清晰;
|
||
4. **扩展性强** :支持自定义模型、摘要长度、输出格式,可适配不同使用场景。
|
||
|
||
## 二、本地部署:Summarize技能安装全流程(Ubuntu24.04为例)
|
||
|
||
原文以Ubuntu24.04系统为例,详细演示了Summarize技能的安装过程,以下结合2026年最新配置优化,提供更全面的实操指南,Windows、MacOS用户可参考对应步骤调整。
|
||
|
||
(一)前置准备
|
||
|
||
1. **环境要求** : 系统:Ubuntu24.04(64位)、Windows10+/MacOS12+; 已部署OpenClaw稳定版(推荐stable-2026.02),并完成基础配置(如绑定Telegram、Minimax模型); 网络通畅,可访问GitHub、Clawhub等资源(国内用户建议配置镜像加速); 安装必要依赖: npm (v18+)、 brew (MacOS)/ apt (Ubuntu)、 git 。
|
||
2. **依赖工具安装** : Summarize技能需依赖外部 summarize CLI工具,需提前安装: \`\`\`bash
|
||
3. Ubuntu24.04系统(通过apt安装)
|
||
4. sudo apt update && sudo apt install -y curl curl -fsSL [https://raw.githubusercontent.com/steipete/homebrew-tap/main/install.sh](https://raw.githubusercontent.com/steipete/homebrew-tap/main/install.sh) | bash sudo apt install steipete-tap/summarize
|
||
|
||
# MacOS系统(通过brew安装)
|
||
|
||
brew install steipete/tap/summarize
|
||
|
||
# Windows系统(PowerShell管理员模式)
|
||
|
||
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser iwr -useb [https://raw.githubusercontent.com/steipete/summarize/main/scripts/install-windows.ps1](https://raw.githubusercontent.com/steipete/summarize/main/scripts/install-windows.ps1) | iex
|
||
|
||
# 验证安装成功(输出版本号即为成功)
|
||
|
||
summarize --version
|
||
|
||
```text
|
||
### (二)Summarize技能安装(3种方式)
|
||
#### 方式1:Clawhub CLI一键安装(推荐)
|
||
Clawhub CLI是OpenClaw官方提供的技能管理工具,支持安装、更新、卸载等全生命周期管理,操作最简单:
|
||
bash
|
||
# 1. 安装Clawhub CLI(仅需执行一次)
|
||
npm install -g clawhub@latest --registry https://registry.npmmirror.com
|
||
|
||
# 2. 安装Summarize技能
|
||
npx clawhub@latest install summarize
|
||
|
||
# 安装成功提示(路径因系统而异)
|
||
# OK. Installed summarize -> /home/yourname/.openclaw/workspace/skills/summarize
|
||
```
|
||
|
||
方式2:手动下载导入(网络受限场景)
|
||
|
||
1. 访问Clawhub Summarize技能页面( [https://clawhub.ai/skill/summarize),点击“Download](https://clawhub.ai/skill/summarize%EF%BC%89%EF%BC%8C%E7%82%B9%E5%87%BB%E2%80%9CDownload) zip”下载技能压缩包;
|
||
2. 解压压缩包至OpenClaw技能目录: \`\`\`bash
|
||
3. Ubuntu/MacOS
|
||
4. unzip [summarize-v1.0.0.zip](https://summarize-v1.0.0.zip/) -d ~/.openclaw/workspace/skills/summarize
|
||
|
||
# Windows
|
||
|
||
Expand-Archive -Path [summarize-v1.0.0.zip](https://summarize-v1.0.0.zip/) -DestinationPath C:\\Users\\YourName.openclaw\\workspace\\skills\\summarize
|
||
|
||
```text
|
||
#### 方式3:GitHub克隆安装(获取最新开发版)
|
||
bash
|
||
# 克隆技能仓库
|
||
git clone https://github.com/steipete/summarize.git ~/.openclaw/workspace/skills/summarize
|
||
|
||
# 进入技能目录,安装依赖
|
||
cd ~/.openclaw/workspace/skills/summarize
|
||
npm install --registry https://registry.npmmirror.com
|
||
```
|
||
|
||
(三)技能配置:环境变量与自定义设置
|
||
|
||
1\. 环境变量配置(模型API密钥)
|
||
|
||
```text
|
||
Summarize技能需调用第三方大模型(如OpenAI、Anthropic、Gemini)完成总结,需配置对应API密钥:
|
||
# Ubuntu/MacOS(临时生效,重启终端失效)
|
||
export OPENAI_API_KEY="你的OpenAI API密钥"
|
||
export ANTHROPIC_API_KEY="你的Anthropic API密钥"
|
||
export GEMINI_API_KEY="你的Gemini API密钥"
|
||
|
||
# Ubuntu/MacOS(永久生效,编辑环境变量文件)
|
||
echo 'export OPENAI_API_KEY="你的OpenAI API密钥"' >> ~/.bashrc(Ubuntu)/~/.zshrc(MacOS)
|
||
source ~/.bashrc(或source ~/.zshrc)
|
||
|
||
# Windows(PowerShell永久生效)
|
||
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的OpenAI API密钥", "User")
|
||
```
|
||
|
||
2\. 自定义配置文件(进阶优化)
|
||
|
||
可通过配置文件设置默认模型、摘要长度、输出语言等,避免每次执行命令重复输入参数:
|
||
|
||
```text
|
||
# 1. 创建配置文件目录
|
||
mkdir -p ~/.summarize
|
||
|
||
# 2. 编写配置文件(JSON格式)
|
||
nano ~/.summarize/config.json
|
||
```
|
||
|
||
配置文件内容(可直接复制,按需修改):
|
||
|
||
```text
|
||
{
|
||
|
||
"model": "google/gemini-3-flash-preview", // 默认模型
|
||
"output": {
|
||
|
||
"language": "auto" // 输出语言(auto/zh/en/de等)
|
||
},
|
||
"length": "medium", // 默认摘要长度(short/medium/long/xl/xxl)
|
||
"cache": {
|
||
|
||
"enabled": true, // 启用缓存(避免重复处理同一内容)
|
||
"maxMb": 512, // 缓存最大容量(512MB)
|
||
"ttlDays": 30 // 缓存有效期(30天)
|
||
},
|
||
"prompt": "请用简洁明了的语言总结核心内容,突出关键信息和结论" // 自定义总结提示词
|
||
}
|
||
```
|
||
|
||
(四)技能验证:3种方式确认安装成功
|
||
|
||
方式1:TUI界面验证(推荐,直观易用)
|
||
|
||
TUI(Terminal User Interface)是OpenClaw的终端交互界面,可直接查询技能用法:
|
||
|
||
```text
|
||
# 启动OpenClaw TUI
|
||
openclaw tui
|
||
|
||
# 在TUI界面输入指令(直接复制发送)
|
||
"我刚刚安装了summarize技能,请检查并告诉我详细用法"
|
||
```
|
||
|
||
OpenClaw会返回技能完整用法说明,包括支持的内容类型、参数列表、示例命令等,确认输出与预期一致即为验证成功。
|
||
|
||
方式2:终端命令直接测试
|
||
|
||
```text
|
||
# 1. 总结网页URL(以OpenClaw教程为例)
|
||
summarize "https://creatoreconomy.so/p/master-openclaw-in-30-minutes-full-tutorial" --model "openai/gpt-4o" --length "long"
|
||
|
||
# 2. 总结本地PDF文件
|
||
summarize "/home/yourname/Documents/report.pdf" --json(输出JSON格式)
|
||
|
||
# 3. 总结YouTube视频(需添加--youtube auto参数)
|
||
summarize "https://youtu.be/xxx" --youtube auto --lang "zh"
|
||
```
|
||
|
||
若成功输出总结结果,无报错信息,说明技能可正常使用。
|
||
|
||
方式3:Telegram交互验证
|
||
|
||
通过已绑定的Telegram账号发送指令,测试远程调用能力:
|
||
|
||
1. 打开Telegram,找到绑定的OpenClaw机器人;
|
||
2. 发送指令: summarize "[https://example.com](https://example.com/)" --model "gemini-3-flash-preview" --length "short" ;
|
||
3. 若机器人返回网页总结内容,说明技能已成功集成至交互渠道。
|
||
|
||
(五)技能进阶用法:参数详解与场景示例
|
||
|
||
Summarize技能支持丰富的参数配置,可适配不同使用场景,核心参数与示例如下:
|
||
|
||

|
||
|
||
高频场景示例:
|
||
|
||
1. **职场报告总结** : summarize "/path/to/工作周报.pdf" --model "openai/gpt-4o" --length "long" --prompt "总结工作成果、问题与下周计划,分3点呈现" ;
|
||
2. **学术文献提炼** : summarize "[https://arxiv.org/abs/xxx](https://arxiv.org/abs/xxx)" --extract-only --json > 文献内容.json (仅提取内容用于后续分析);
|
||
3. **视频笔记生成** : summarize "[https://youtu.be/AI](https://youtu.be/AI)教程视频ID" --youtube auto --lang "zh" --length "xl" (生成详细视频笔记);
|
||
4. **多语言内容总结** : summarize "[https://foreign-article.com](https://foreign-article.com/)" --lang "zh" --model "google/gemini-3-flash-preview" (将英文文章总结为中文)。
|
||
|
||
## 四、常见问题排查(新手必看)
|
||
|
||
(一)技能安装失败(提示“command not found: clawhub”)
|
||
|
||
- 原因:npm全局路径未添加至系统环境变量;
|
||
- 解决方案:
|
||
|
||
```text
|
||
# 查找clawhub安装路径
|
||
npm list -g clawhub
|
||
# 示例输出:/usr/local/lib/node_modules/clawhub
|
||
# 添加路径至环境变量(Ubuntu/MacOS)
|
||
echo 'export PATH="$PATH:/usr/local/lib/node_modules/clawhub/bin"' >> ~/.bashrc
|
||
source ~/.bashrc
|
||
```
|
||
|
||
(二)执行summarize命令提示“API key not found”
|
||
|
||
- 原因:未配置模型API密钥,或密钥配置错误;
|
||
- 解决方案: 确认API密钥正确(无多余空格、换行符); 重新配置环境变量(参考前文步骤); 阿里云部署用户可优先使用百炼模型,无需额外配置第三方API密钥。
|
||
|
||
(三)总结YouTube视频失败(提示“youtube-dl not found”)
|
||
|
||
- 原因:缺少YouTube视频解析依赖;
|
||
- 解决方案:
|
||
|
||
```text
|
||
# 安装youtube-dl
|
||
pip3 install youtube-dl
|
||
|
||
# 验证安装
|
||
youtube-dl --version
|
||
|
||
# 重新执行总结命令
|
||
summarize "https://youtu.be/xxx" --youtube auto
|
||
```
|
||
|
||
(四)技能加载成功但无法使用(TUI中无响应)
|
||
|
||
- 原因:OpenClaw未识别技能依赖,或技能目录权限不足;
|
||
- 解决方案:
|
||
|
||
```text
|
||
# 检查技能目录权限
|
||
chmod -R 755 ~/.openclaw/workspace/skills/summarize
|
||
|
||
# 手动触发技能加载
|
||
openclaw skills reload
|
||
|
||
# 重启OpenClaw服务
|
||
openclaw gateway restart(本地部署)
|
||
systemctl restart openclaw(阿里云部署)
|
||
```
|
||
|
||
(五)摘要结果不符合预期(过短/过长/偏离重点)
|
||
|
||
- 原因:默认提示词或参数配置不适配场景;
|
||
- 解决方案: 调整摘要长度参数(--length); 自定义提示词(--prompt),明确总结要求; 更换更适合的模型(如复杂内容用Claude Opus,简单内容用Gemini Flash)。
|
||
|
||
## 五、安全使用与技能管理建议
|
||
|
||
(一)安全使用准则
|
||
|
||
1. **技能来源验证** :优先选择Clawhub官方认证技能,第三方技能需查看SKILL.md文件与安全审计报告,避免安装恶意技能;
|
||
2. **权限最小化** :Summarize等技能无需管理员权限,运行OpenClaw时使用普通用户账号,避免权限泄露风险;
|
||
3. **API密钥保护** :切勿将API密钥明文写入配置文件或分享给他人,定期更换密钥;
|
||
4. **安全审计** :定期执行OpenClaw安全审计命令,排查潜在风险:
|
||
|
||
openclaw security audit --deep
|
||
|
||
(二)技能管理实用命令
|
||
|
||
\# 查看已安装技能列表 npx clawhub list # 更新Summarize技能至最新版本 npx clawhub update summarize # 卸载技能 npx clawhub uninstall summarize # 搜索同类技能(如其他总结类技能) npx clawhub search "summary" "总结"
|
||
|
||
(三)进阶拓展建议
|
||
|
||
1. **技能组合使用** :将Summarize技能与其他技能联动,如“网页总结→PDF生成→邮件发送”,实现全流程自动化;
|
||
2. **自定义技能开发** :基于Summarize技能模板,开发适配特定场景的总结技能(如学术文献专用总结、职场报告总结);
|
||
3. **本地模型部署** :为降低API调用成本,可部署MiniMax、Qwen等本地模型,通过配置文件指定本地模型路径,实现离线总结。
|
||
|
||
## 总结:从技能入门到AI助手个性化
|
||
|
||
OpenClaw的Skills生态是其区别于普通AI工具的核心竞争力,而Summarize技能作为入门首选,不仅能快速解决信息整理痛点,更能帮助用户理解技能安装、配置、使用的完整流程,按本文步骤操作,均可在10分钟内完成技能搭建,实现“一句话驱动多类型内容总结”。
|
||
|
||
2026年,AI助手的价值已从“被动响应”转向“主动赋能”,而技能的灵活运用正是赋能的关键。除了Summarize技能,OpenClaw还有1700+各类技能可供选择,建议新手循序渐进,先掌握基础技能,再根据自身场景添加专业技能,逐步打造专属的全能AI助手。
|
||
|
||
最后提醒:OpenClaw生态与技能库持续更新,建议开启Clawhub通知,及时获取技能更新与新功能动态,让你的AI助手持续进化。通过不断探索与实践,你将发现OpenClaw远不止是一个工具,更是一个能够持续学习、适配需求的“数字员工”。 |