一、先搞懂：OpenClaw Skills 到底是什么？
（一）技能的核心逻辑：给 AI 定 “操作手册”
Skills（技能）是 OpenClaw 生态中「定义工具使用方法」的结构化模块，本质是一套标准化指令集 —— 简单说，就是教 AI Agent “怎么用工具做具体事”。
每个技能都有清晰的结构，新手不用怕复杂：
1.技能文件夹 ：独立目录，避免和其他技能冲突；
2.SKILL.md 文件 ：核心配置文件（YAML 格式），包含版本、依赖、执行指令，是 AI 的 “操作指南”；
3.依赖组件 ：部分技能需外部工具支持（比如 Summarize 要依赖 summarize CLI 工具）。
更灵活的是：OpenClaw 会自动适配系统环境，只加载能用的技能，不会无效占用资源～
（二）4 种技能获取渠道，不止 Clawhub！
2026 年获取 OpenClaw 技能的主流方式，按需选择：
| 渠道类型 | 特点 | 适合人群 |
|---|---|---|
| Clawhub 官方商店 | 官方认证，安全扫描（VirusTotal+OpenClaw 审计），安全性最高 | 新手、追求稳定的用户 |
| GitHub 社区仓库 | 如 awesome-openclaw-skills（14.5k 星标），3000 + 小众技能 | 有一定技术基础，需要个性化功能 |
| 自定义开发 | 自己写 SKILL.md 和执行逻辑，100% 适配需求 | 开发者、有特殊场景需求的用户 |
| 本地文件导入 | 下载 ZIP 包手动解压，无需联网 | 网络受限环境、离线部署 |
（三）为什么首选 Summarize 技能入门？
作为 OpenClaw 社区 “爆款基础技能”（当前活跃安装 402 次），它的优势太香了：
功能实用 ：网页 URL、PDF / 图片 / 音频、YouTube 视频全支持，覆盖 90% 信息整理场景；
上手简单 ：依赖少、命令直观，不懂编程也能操作；
安全靠谱 ：官方审计无恶意代码，权限需求清晰；
扩展性强 ：可自定义模型、摘要长度、输出格式，适配不同场景。
二、实操指南：Summarize 技能本地部署（多系统适配）
以 Ubuntu24.04 为基准，Windows10+/MacOS12 + 用户直接对应调整，步骤全程可视化～
（一）前置准备：3 分钟搞定环境
1. 基础要求
•系统：Ubuntu24.04（64 位）/ Windows10+/MacOS12+；
•已部署 OpenClaw 稳定版（推荐 stable-2026.02），并绑定 Telegram、配置 Minimax 等模型；
•网络：能访问 GitHub/Clawhub（国内用户建议配置镜像加速）；
•必备工具：npm（v18+）、brew（MacOS）/apt（Ubuntu）、git。
2. 安装核心依赖：summarize CLI 工具
这是 Summarize 技能的 “底层支撑”，按系统复制命令执行：
Ubuntu24.04（apt安装）
sudo apt update && sudo apt install -y curl
curl -fsSL 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 iex
验证成功：执行summarize --version，输出版本号即可。
（二）3 种安装方式：按需选择，最快 1 分钟搞定
方式 1：Clawhub CLI 一键安装（推荐！新手首选）
Clawhub CLI 是官方技能管理工具，安装、更新、卸载全搞定：
1. 安装Clawhub CLI（仅需一次）
npm install -g clawhub@latest --registry https://registry.npmmirror.com
2. 安装Summarize技能
npx clawhub@latest install summarize
方式 2：手动下载导入（网络受限）
1.访问summarize，下载 — ClawHub ZIP 压缩包；
2.解压到指定目录：
Ubuntu/MacOS
unzip summarize-v1.0.0.zip -d ~/.openclaw/workspace/skills/summarize
Windows
Expand-Archive -Path summarize-v1.0.0.zip -DestinationPath C:\Users\YourName.openclaw\workspace\skills\summarize
方式 3：GitHub 克隆（获取最新开发版）
适合想尝鲜新功能的用户：
克隆仓库到技能目录
git clone GitHub - steipete/summarize: Point at any URL/YouTube/Podcast or file. Get the gist. CLI and Chrome Extension. · GitHub ~/.openclaw/workspace/skills/summarize
进入目录安装依赖
cd ~/.openclaw/workspace/skills/summarize
npm install --registry https://registry.npmmirror.com
（三）关键配置：环境变量 + 自定义设置
1. 配置模型 API 密钥（必做！）
Summarize 需要调用 OpenAI/Gemini 等大模型，需配置 API 密钥：
Ubuntu/MacOS（临时生效，重启终端失效）
export OPENAI_API_KEY=“你的密钥”
export ANTHROPIC_API_KEY=“你的密钥”
export GEMINI_API_KEY=“你的密钥”
Ubuntu/MacOS（永久生效）
echo ‘export OPENAI_API_KEY=“你的密钥”’ >> ~/.bashrc（Ubuntu）/~/.zshrc（MacOS）
source ~/.bashrc（或source ~/.zshrc）
Windows（PowerShell永久生效）
[Environment]::SetEnvironmentVariable(“OPENAI_API_KEY”, “你的密钥”, “User”)
注意：密钥别泄露，定期更换更安全～
2. 自定义配置文件（进阶优化，可选）
不想每次输入参数？创建配置文件预设默认值：
1. 创建配置目录
mkdir -p ~/.summarize
2. 编写配置文件（JSON格式）
nano ~/.summarize/config.json
复制以下内容，按需修改：
{
“model”: “google/gemini-3-flash-preview”, // 默认模型
“output”: { “language”: “auto” }, // 输出语言（auto/zh/en等）
“length”: “medium”, // 摘要长度（short/medium/long/xl/xxl）
“cache”: {
“enabled”: true, // 启用缓存（避免重复处理）
“maxMb”: 512, // 缓存最大512MB
“ttlDays”: 30 // 缓存有效期30天
},
“prompt”: “请用简洁语言总结核心内容，突出关键信息和结论” // 自定义提示词
}
（四）3 种验证方式：确认安装成功
方式 1：TUI 界面验证（直观！推荐）
启动OpenClaw终端交互界面
openclaw tui
在界面输入：“我刚刚安装了summarize技能，请检查并告诉我详细用法”
成功：AI 返回技能用法（支持的内容类型、参数、示例命令）。
方式 2：终端直接测试
1. 总结网页
summarize “https://creatoreconomy.so/p/master-openclaw-in-30-minutes-full-tutorial” --model “openai/gpt-4o” --length “long”
2. 总结本地PDF（输出JSON格式）
summarize “/home/yourname/Documents/report.pdf” --json
3. 总结YouTube视频
summarize “https://youtu.be/xxx” --youtube auto --lang “zh”
成功：无报错，输出总结结果。
方式 3：Telegram 远程验证
打开绑定的 OpenClaw 机器人，发送指令：
summarize “https://example.com” --model “gemini-3-flash-preview” --length “short”
成功：机器人返回总结内容。
三、进阶用法：4 个高频场景直接抄作业
Summarize 技能的强大之处，在于参数灵活适配不同需求，这 4 个场景直接套用：
1. 职场报告总结（结构化输出）
summarize “/path/to/工作周报.pdf” --model “openai/gpt-4o” --length “long” --prompt “总结工作成果、问题与下周计划，分3点呈现”
2. 学术文献提炼（纯内容提取）
summarize “https://arxiv.org/abs/xxx” --extract-only --json > 文献内容.json
适合后续导入文献管理工具分析～
3. 视频笔记生成（详细版）
summarize “https://youtu.be/AI教程ID” --youtube auto --lang “zh” --length “xl”
4. 多语言总结（英文→中文）
summarize “https://foreign-article.com” --lang “zh” --model “google/gemini-3-flash-preview”
四、新手必看：5 个常见问题排查
1. 提示 “command not found: clawhub”
原因：npm 全局路径未添加到系统环境变量
解决：
npm list -g clawhub # 查找安装路径
echo ‘export PATH=“$PATH:/usr/local/lib/node_modules/clawhub/bin”’ >> ~/.bashrc
source ~/.bashrc
2. 提示 “API key not found”
原因：未配置密钥或密钥错误
解决：检查密钥无多余空格，重新配置环境变量（参考前文）；阿里云用户可改用百炼模型，无需第三方密钥。
3. 总结 YouTube 视频失败（“youtube-dl not found”）
原因：缺少解析依赖
解决：
pip3 install youtube-dl
youtube-dl --version # 验证
4. 技能加载成功但 TUI 无响应
原因：目录权限不足或未重新加载
解决：
chmod -R 755 ~/.openclaw/workspace/skills/summarize
openclaw skills reload
openclaw gateway restart（本地部署）/ systemctl restart openclaw（服务器）
5. 摘要结果不符合预期
原因：参数 / 提示词不适配
解决：调整–length参数；自定义–prompt明确要求；换模型（复杂内容用 Claude Opus，简单内容用 Gemini Flash）。
五、安全使用 + 技能管理建议
（一）安全使用 3 准则
1.优先选 Clawhub 官方技能，第三方技能需查 SKILL.md 和安全审计报告；
2.运行 OpenClaw 用普通用户账号，避免管理员权限；
3.定期执行安全审计：openclaw security audit --deep。
（二）实用管理命令
npx clawhub list # 查看已安装技能
npx clawhub update summarize # 更新技能
npx clawhub uninstall summarize # 卸载技能
npx clawhub search “summary” “总结” # 搜索同类技能
（三）进阶拓展方向
1.技能组合：Summarize→PDF 生成→邮件发送，实现全流程自动化；
2.自定义开发：基于 Summarize 模板，开发学术 / 职场专用总结技能；
3.本地模型部署：用 MiniMax、Qwen 等本地模型，实现离线总结，降低 API 成本。
最后总结
OpenClaw 的 Skills 生态，让 AI 助手从 “被动响应” 变成 “主动赋能”—— 而 Summarize 技能作为入门钥匙，不仅能解决信息整理痛点，更能让你快速掌握技能安装、配置、使用的完整逻辑。
按本文步骤，10 分钟就能搭建起 “全能总结工具”，后续还能探索 OpenClaw 的 1700 + 其他技能（比如数据可视化、自动化办公等），逐步打造专属 “数字员工”～
记得开启 Clawhub 通知，及时获取技能更新和新功能！如果遇到问题，欢迎在评论区留言，一起交流进阶技巧～