OpenClaw 第三阶段详细学习指南

OpenClaw 第三阶段详细学习指南p strong 目标 strong 理解 Skills 的核心机制 掌握安装 管理和创建 Skills 的方法 p 1 什么是 Skill Skill 技能 是 OpenClaw 的核心扩展机制 它是一个独立的 可复用的功能模块 类似于 类比 说明 手机应用 每个 App

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



 

目标: 理解 Skills 的核心机制,掌握安装、管理和创建 Skills 的方法


1. 什么是 Skill?

Skill(技能) 是 OpenClaw 的核心扩展机制,它是一个独立的、可复用的功能模块,类似于:

类比 说明 手机应用 每个 App 专注做一件事 浏览器插件 扩展浏览器功能 VS Code 扩展 为编辑器添加新功能

Skills 的特点:

  • 📦 模块化 - 每个 Skill 独立开发、维护
  • 🔄 可复用 - 一个 Skill 可被多个 Agent 使用
  • 🌐 易分享 - 可发布到 ClawHub 供他人使用
  • 🛠️ 易扩展 - 新增功能只需添加新 Skill
2. Skill 的结构
GPT plus 代充 只需 145my-skill/ ├── SKILL.md             # ✅ 必需:Skill 说明文档(核心) ├── scripts/             # 可选:脚本文件 │   ├── main.py         # 主脚本 │   ├── helper.js       # 辅助脚本 │   └── … ├── references/         # 可选:参考资料 │   └── README.md ├── config.json         # 可选:配置文件 └── package.json         # 可选:Node.js 包配置
SKILL.md 详解(核心文件)

SKILL.md 是 Skill 的核心配置文件,定义了这个 Skill 的:

  1. 描述(description) - 什么时候触发这个 Skill
  2. 使用说明 - 如何使用这个 Skill
  3. 参数定义 - Skill 支持哪些参数
  4. 脚本说明 - 脚本的工作方式

示例结构:

— name: my-skill

description: 当用户说 “xxx” 时触发此 Skill。用于…

My Skill

使用方法

  1. 步骤一
  2. 步骤二 ​

    参数说明

    参数 类型 说明
    input string 输入内容

    示例

    用户输入:xxx 输出结果:yyy

    GPT plus 代充 只需 145
    3. Skill 的触发机制

    OpenClaw 的 AI 会根据用户输入自动判断使用哪个 Skill:

    用户输入 → AI 分析意图 → 匹配 Skill 描述 → 执行 Skill

    匹配关键词:

    • Skill 的 description 字段
    • Skill 的名称
    • 用户明确说“使用 xxx Skill”

1. 查看已安装的 Skills
GPT plus 代充 只需 145# 列出所有 Skills openclaw skills list ​

只显示已就绪的 Skills

openclaw skills list –eligible ​

JSON 格式输出

openclaw skills list –json ​

查看 Skill 详情

openclaw skills info pdf openclaw skills info docx

2. 检查 Skills 环境
# 检查所有 Skills 的环境依赖 openclaw skills check ​

详细输出(显示缺失的依赖)

openclaw skills check –verbose

3. 推荐安装的 Skills
📄 文件处理类
Skill 说明 命令 pdf PDF 读取、合并、分割、OCR skill_install install_skill pdf docx Word 文档创建和编辑 skill_install install_skill docx xlsx Excel 表格处理 skill_install install_skill xlsx pptx PowerPoint 演示文稿 skill_install install_skill pptx
🎨 设计类
Skill 说明 命令 frontend-design 前端界面设计 skill_install install_skill frontend-design canvas-design Canvas 画布设计 skill_install install_skill canvas-design theme-factory 主题应用工具 skill_install install_skill theme-factory
🔧 工具类
Skill 说明 命令 find-skills 搜索和发现新 Skills skill_install install_skill find-skills skill-creator 创建和优化 Skills skill_install install_skill skill-creator
🌐 搜索与信息类
Skill 说明 命令 arxiv-reader 学术论文阅读 skill_install install_skill arxiv-reader arxiv-watcher ArXiv 论文追踪 skill_install install_skill arxiv-watcher news-summary 新闻摘要 skill_install install_skill news-summary tech-news-digest 科技新闻聚合 skill_install install_skill tech-news-digest
💰 金融与数据类
Skill 说明 命令 earnings-tracker 财报追踪 skill_install install_skill earnings-tracker macro-monitor 宏观经济监控 skill_install install_skill macro-monitor analytics-dashboard 数据看板生成 skill_install install_skill analytics-dashboard
📱 社交与内容类
Skill 说明 命令 baoyu-post-to-wechat 微信公众号发布 skill_install install_skill baoyu-post-to-wechat ai-social-media-content 社交媒体内容创作 skill_install install_skill ai-social-media-content content-factory 多代理内容生产 skill_install install_skill content-factory content-repurposer 内容复用引擎 skill_install install_skill content-repurposer
🗓️ 生活与效率类
Skill 说明 命令 weather-advisor 天气顾问 skill_install install_skill weather-advisor travel-planner 旅行规划 skill_install install_skill travel-planner habit-tracker 习惯追踪 skill_install install_skill habit-tracker goal-tracker 目标追踪 skill_install install_skill goal-tracker movie-advisor 影视推荐 skill_install install_skill movie-advisor music-recommender 音乐推荐 skill_install install_skill music-recommender
4. 快速安装推荐
GPT plus 代充 只需 145# 文件处理(必装) skill_install install_skill pdf skill_install install_skill xlsx skill_install install_skill docx ​

设计工具

skill_install install_skill frontend-design ​

信息获取

skill_install install_skill weather-advisor skill_install install_skill news-summary ​

内容创作

skill_install install_skill content-factory


1. ClawHub(OpenClaw 官方市场)

网址: https://clawhub.com

特点:

  • OpenClaw 官方 Skill 市场
  • 经过审核和质量检查
  • 直接通过 CLI 安装
# 访问 ClawHub npx clawhub ​

搜索 Skills

npx clawhub search pdf ​

安装 Skill

npx clawhub install pdf

2. SkillHub(另一个 Skill 市场)

安装 SkillHub CLI:

GPT plus 代充 只需 145skill_install install_cli

使用 SkillHub:

# 搜索 Skills npx skills find [关键词] ​

安装 Skill

skill_install install_skill [skill-name] ​

检查更新

npx skills check ​

更新所有 Skills

npx skills update

3. 从 GitHub 安装

很多 Skills 托管在 GitHub 上,可以直接安装:

GPT plus 代充 只需 145# 安装 GitHub 上的 Skill npx skills add owner/repo@skill-name -g -y ​

例如

npx skills add vercel-labs/agent-skills@vercel-react-best-practices -g -y

4. 搜索和发现 Skills

常用搜索关键词:

类别 关键词 Web 开发 react, nextjs, typescript, css, tailwind 测试 testing, jest, playwright, e2e DevOps deploy, docker, kubernetes, ci-cd 文档 docs, readme, changelog, api-docs 代码质量 review, lint, refactor, best-practices 设计 ui, ux, design-system, accessibility 效率 workflow, automation, git

1. 安装 Skill

方式一:使用 skill_install(推荐)

# 安装单个 Skill skill_install install_skill pdf ​

安装多个 Skills

skill_install install_skill pdf skill_install install_skill docx skill_install install_skill xlsx

方式二:使用 clawhub

GPT plus 代充 只需 145npx clawhub install pdf

方式三:使用 npm/pnpm

# npm 安装 npm install -g @openclaw/skill-pdf ​

pnpm 安装

pnpm add -g @openclaw/skill-pdf

2. 卸载 Skill
GPT plus 代充 只需 145# 卸载 Skill openclaw skills remove pdf ​

或者直接删除 Skill 文件夹

rm -rf ~/.agents/skills/pdf/

3. 查看 Skill 详情
# 查看 Skill 信息 openclaw skills info pdf ​

读取 Skill 的 SKILL.md

cat ~/.agents/skills/pdf/SKILL.md


1. 创建流程概览
GPT plus 代充 只需 145确定功能 → 创建目录 → 编写 SKILL.md → 编写脚本 → 测试 → 发布
2. 使用 skill-creator 创建(推荐)
# 使用 skill-creator Skill

在对话中告诉 AI:“帮我创建一个 xxx Skill”

3. 手动创建 Skill
步骤 1:创建目录结构
GPT plus 代充 只需 145# 创建 Skill 目录 mkdir -p ~/.agents/skills/my-skill cd ~/.agents/skills/my-skill ​

创建必要文件夹

mkdir -p scripts references

步骤 2:编写 SKILL.md
— name: my-first-skill

description: 当用户说 “xxx” 或需要 “xxx” 功能时使用此 Skill。用于…

我的第一个 Skill

功能说明

​ 这个 Skill 用于实现 xxx 功能。 ​

使用方法

  1. 第一步操作
  2. 第二步操作 ​

    参数说明

    参数 类型 必填 说明
    input string 输入内容
    option string 可选参数

    示例

    输入:

    用户说:帮我 xxx

    GPT plus 代充 只需 145输出:

    Skill 执行结果:xxx

    依赖

  • Python 3.x
  • requests 库(如需要网络请求)
    步骤 3:编写脚本

    Python 脚本示例(scripts/main.py):

    GPT plus 代充 只需 145#!/usr/bin/env python3 “”“ My First Skill - 主脚本 ”“” ​ import sys import json ​ def main():    “”“主函数”“”    # 读取输入参数    if len(sys.argv) > 1:        args = json.loads(sys.argv[1])        input_text = args.get(‘input’, ‘’)    else:        input_text = ‘’ ​    # 执行功能    result = process_input(input_text) ​    # 输出结果    print(json.dumps({        ‘success’: True,        ‘result’: result   }, ensure_ascii=False)) ​ def process_input(text):    “”“处理输入”“”    # 实现你的功能逻辑    return f“处理结果:{text}” ​ if name == ‘main’:    main()

    JavaScript 脚本示例(scripts/main.js):

    #!/usr/bin/env node /

    • My First Skill - 主脚本 */ ​ const main = () => )); }; ​ const processInput = (text) => {  // 实现你的功能逻辑  return `处理结果:${text}`; }; ​ main();
      步骤 4:测试 Skill
      GPT plus 代充 只需 145# 测试 Python 脚本 python3 scripts/main.py ‘{“input”: “测试数据”}’ ​

      赋予执行权限

      chmod +x scripts/main.py ​

      在 OpenClaw 中触发 Skill

      对 AI 说:“使用 my-first-skill 处理这个数据”

      4. Skill **实践
      ✅ 应该做的
      1. 清晰的 description - 准确描述何时触发
      2. 完整的文档 - 说明参数、使用方法、示例
      3. 错误处理 - 处理异常情况
      4. 日志输出 - 便于调试和追踪
      5. 权限最小化 - 只请求必要的权限
      ❌ 不应该做的
      1. 不要在 Skill 中硬编码敏感信息(API 密钥等)
      2. 不要创建过于复杂的 Skill(拆分成多个)
      3. 不要省略 SKILL.md(这是必需文件)
      4. 不要忽略错误处理
      5. 发布 Skill
      发布到 GitHub
      # 1. 创建 GitHub 仓库

      2. 推送代码

      git init git add . git commit -m “Initial commit” git remote add origin https://github.com/username/my-skill.git git push -u origin main ​

      3. 在 README 中说明安装方法

      发布到 ClawHub
      GPT plus 代充 只需 145# 1. 准备 Skill

      确保 SKILL.md 完整

      2. 提交到 ClawHub

      访问 https://clawhub.com 了解提交流程


1. PDF Skill 结构分析
# 查看 PDF Skill 位置 ls ~/.agents/skills/pdf/ ​

查看目录结构

pdf/ ├── SKILL.md              # 核心配置 ├── scripts/              # 脚本 │   └── office/ │       ├── soffice.py │       ├── unpack.py │       └── validate.py └── references/           # 参考资料   ├── REFERENCE.md   └── FORMS.md

2. DOCX Skill 结构分析
GPT plus 代充 只需 145docx/ ├── SKILL.md              # 核心配置 ├── scripts/ │   ├── office/ │   │   ├── soffice.py │   │   ├── unpack.py │   │   └── validate.py │   └── accept_changes.py └── references/   └── README.md
3. 学习要点
Skill 学习重点 PDF PDF 处理库的使用、命令行工具集成 DOCX 文档结构理解、XML 操作 frontend-design React 组件生成、设计规范 skill-creator Skill 创建的**实践

练习 1:安装和使用 PDF Skill
# 1. 安装 PDF Skill skill_install install_skill pdf ​

2. 检查安装

openclaw skills list | grep pdf ​

3. 测试:读取一个 PDF 文件

对 AI 说:“读取 ~/Desktop/test.pdf 的内容”

4. 测试:合并多个 PDF

对 AI 说:“合并 ~/Desktop/1.pdf 和 ~/Desktop/2.pdf”

练习 2:安装和使用天气 Skill
GPT plus 代充 只需 145# 1. 安装天气 Skill skill_install install_skill weather-advisor ​

2. 测试

对 AI 说:“今天天气怎么样?”

练习 3:创建第一个自定义 Skill
# 1. 创建 Skill 目录 mkdir -p ~/.agents/skills/hello-world mkdir -p ~/.agents/skills/hello-world/scripts ​

2. 创建 SKILL.md

(参考上面的模板)

3. 创建主脚本

cat > ~/.agents/skills/hello-world/scripts/main.py << ‘EOF’ #!/usr/bin/env python3 import sys import json ​ def main():   name = sys.argv[1] if len(sys.argv) > 1 else “World”   print(json.dumps({        “success”: True,        “message”: f“Hello, {name}!”   })) ​ if name == “main”:   main() EOF ​ chmod +x ~/.agents/skills/hello-world/scripts/main.py ​

4. 测试

python3 ~/.agents/skills/hello-world/scripts/main.py “OpenClaw”

练习 4:阅读一个复杂 Skill
GPT plus 代充 只需 145# 阅读 PDF Skill 的完整源码 cat ~/.agents/skills/pdf/SKILL.md ​

理解其结构

ls -la ~/.agents/skills/pdf/


Q1: 为什么我的 Skill 不生效?

可能原因:

  1. SKILL.md 的 description 不够准确
  2. Skill 没有被正确安装
  3. 触发关键词不匹配

解决方法:

# 检查 Skill 是否存在 openclaw skills list ​

检查 Skill 描述

openclaw skills info your-skill ​

手动触发

对 AI 说:“使用 your-skill”

Q2: Skill 依赖缺失怎么办?
GPT plus 代充 只需 145# 检查依赖 openclaw skills check –verbose ​

安装缺失的依赖

根据提示安装 Python 库或 Node 包

Q3: 如何调试 Skill?
# 直接运行脚本 python3 ~/.agents/skills/your-skill/scripts/main.py ‘{“input”: “test”}’ ​

查看日志

openclaw logs –follow

Q4: Skill 和 Agent 有什么区别?
对比 Skill Agent 本质 功能模块 AI 实体 触发 自动匹配或手动调用 需要创建 数量 可以有多个 Skill 通常 1 个主 Agent 关系 Skill 是 Agent 的工具 Agent 使用 Skill
Q5: 可以同时使用多个 Skill 吗?

可以! AI 可以根据任务需要同时调用多个 Skill。


1. Skill 参数传递
GPT plus 代充 只需 145# 从 AI 接收参数 args = json.loads(sys.argv[1]) ​

访问各个参数

input_text = args.get(‘input’, ‘’) option = args.get(‘option’, ‘default’)

2. Skill 间的通信
Agent ├── Skill A → 处理任务 A │     └── 结果 → Agent ├── Skill B → 处理任务 B │     └── 结果 → Agent └── 综合结果 → 用户
3. Skill 条件触发

在 SKILL.md 中精确描述触发条件:

GPT plus 代充 只需 145description: | 当用户提到以下情况时触发:

  • “读取 PDF” 或 “处理 PDF”
  • 需要从 PDF 中提取内容
  • 需要合并或分割 PDF
    4. Skill 错误处理
    def main():    try:        # 处理逻辑        result = process()        print(json.dumps({‘success’: True, ‘result’: result}))    except Exception as e:        print(json.dumps({            ‘success’: False,            ‘error’: str(e)       }))

  • 理解 Skill 的概念和作用
  • 能够使用 openclaw skills list 查看 Skills
  • 能够使用 openclaw skills check 检查环境
  • 成功安装 2-3 个实用的 Skills
  • 能够使用已安装的 Skills 处理实际任务
  • 理解 Skill 的目录结构
  • 能够阅读和理解 SKILL.md
  • 创建一个简单的自定义 Skill
  • 理解 Skill 的触发机制
  • 知道如何发布和分享 Skill

查看 Skills
GPT plus 代充 只需 145openclaw skills list                # 列出所有 Skills openclaw skills list –eligible     # 只显示已就绪的 openclaw skills info 
         
   
           
            
    
                  # 查看详情 openclaw skills check              # 检查环境 openclaw skills check –verbose    # 详细检查 
         
   
           
安装和卸载
skill_install install_skill 
         
   
           
            
    
           # 安装 Skill openclaw skills remove 
          
    
            
                  # 卸载 Skill 
             
         
   
           
创建 Skill
GPT plus 代充 只需 145mkdir -p ~/.agents/skills/my-skill/scripts

创建 SKILL.md 和脚本文件

测试 Skill
python3 ~/.agents/skills/my-skill/scripts/main.py ‘{“input”: “test”}’

资源 链接 说明 ClawHub https://clawhub.com 官方 Skill 市场 技能市场 https://skills.sh 另一个 Skill 市场 官方文档 https://docs.openclaw.ai Skills 详细文档 skill-creator 内置 Skill Skill 创建指南

小讯
上一篇 2026-03-27 08:18
下一篇 2026-03-27 08:16

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/249524.html