技能系统

引言 在AI Agent的工程实践中，“如何扩展Agent能力"是一个核心问题。大多数框架选择将能力硬编码在Agent内部，或者通过插件机制实现有限的扩展。OpenClaw采用了不同的路线——技能系统（Skill System），一个完全可组合、可热插拔的能力扩展框架。本文将深入解析其设计理念与工程实现。 设计哲学 核心原则 OpenClaw技能系统的设计遵循三个核心原则： 声明式优先：技能通过自描述文件定义，而非命令式代码注册 可组合性：技能之间可以自由组合，不会产生副作用 渐进式复杂度：简单技能只需一个Markdown文件，复杂技能可以包含完整工具链 与传统插件系统的区别 维度 传统插件系统 OpenClaw技能系统 定义方式 代码注册（Python/JS） 声明式文件（SKILL.md） 激活机制 显式调用 意图匹配自动激活 组合能力 通常有冲突风险 设计上保证可组合 热插拔 需要重启 运行时动态加载 开发门槛 需要理解框架API 写Markdown即可入门 SKILL.md：技能的声明式定义 每个技能的核心是一个SKILL.md文件，它同时是文档、配置和激活规则： # SKILL.md - PDF处理技能 ## 描述 处理PDF文件的创建、读取、编辑、合并、拆分等操作。 当用户提到 .pdf 文件、要求处理PDF时触发。 ## 触发条件 - 文件扩展名为 .pdf - 用户消息包含"PDF"、"pdf"、"文档处理" - 用户拖拽PDF文件到对话框 ## 能力 - 读取/提取PDF文本和表格 - 合并多个PDF - 拆分PDF - 添加水印 - 填充PDF表单 - OCR扫描件 ## 工具依赖 - Python 3.10+ - pdfplumber - PyMuPDF - reportlab ## 使用示例 用户："把这个PDF拆分成每页一个文件" 动作：调用PDF拆分工具，输出多个PDF文件 关键设计决策 为什么用Markdown而非JSON/YAML？ ...

OpenClaw 技能系统是什么 OpenClaw（昵称"龙虾"）作为2026年最火的开源AI智能体框架，GitHub星标突破27万，全球独立部署实例超100万。其核心竞争力之一就是技能系统（Skills System）——一套插件化架构，让AI从"只说不做"变成"能干活"。 技能系统相当于AI的"手脚"：通过插件化方式扩展能力，包括文件管理、批量处理、脚本执行、代码调试、浏览器自动化、邮件日程等。 架构全景 ┌─────────────────────────────────────┐ │ 用户指令（自然语言） │ ├─────────────────────────────────────┤ │ Agent 推理引擎 │ │ （模型选择 → 任务分解 → 工具调用） │ ├─────────────────────────────────────┤ │ 技能调度层 │ │ SKILL.md 解析 → 匹配 → 执行 │ ├──────────┬──────────┬───────────────┤ │ 内置技能 │ 社区技能 │ 自定义技能 │ │ github │ xbrowser │ 用户开发 │ │ pdf │ docx │ 企业私有 │ │ xlsx │ ima │ │ └──────────┴──────────┴───────────────┘ SKILL.md 规范 每个技能的核心是一个 SKILL.md 文件，定义了技能的触发条件、执行流程和工具集成。 标准结构 # SKILL.md ## 描述 简要描述技能的用途和触发场景。 ## 触发条件 - 关键词匹配 - 意图识别 - 文件类型 ## 执行流程 1. 读取输入 2. 调用工具 3. 处理结果 4. 返回输出 ## 工具依赖 - tool_name: 用途说明 ## 配置 - 环境变量 - API密钥 - 路径设置 实例：文件处理技能 # SKILL.md - 文件管理技能 ## 描述 当用户要求管理、整理、搜索文件时触发。 ## 触发条件 - "整理文件"、"搜索文件"、"移动到" - 文件路径出现在对话中 ## 执行流程 1. 识别操作类型（搜索/移动/删除/重命名） 2. 确认目标路径和范围 3. 执行文件操作 4. 返回操作摘要 ## 工具依赖 - read: 读取文件内容 - write: 创建/覆盖文件 - exec: 执行文件系统命令 技能开发实战 1. 创建自定义技能 # 技能目录结构 my-skill/ ├── SKILL.md # 技能定义 ├── scripts/ # 脚本 │ ├── install.sh │ └── run.py ├── templates/ # 模板文件 └── config.json # 配置 2. 技能注册 在 OpenClaw 配置中注册技能： ...