--- 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远不止是一个工具,更是一个能够持续学习、适配需求的“数字员工”。