Files
Obsidian/openclaw/没装skill的OpenClaw,就是一只没长钳子的龙虾——能动,但夹不起任何东西(Windows&Mac 代码指令一键复制).md
T
2026-07-21 14:53:24 +08:00

292 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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技能支持丰富的参数配置,可适配不同使用场景,核心参数与示例如下:
![图像](https://pbs.twimg.com/media/HCphZTzbQAAAv7y?format=png&name=large)
高频场景示例:
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远不止是一个工具,更是一个能够持续学习、适配需求的“数字员工”。