OpenClaw技能系统深度解析：插件化架构设计与实战

┌─────────────────────────────────────┐
│           用户指令（自然语言）         │
├─────────────────────────────────────┤
│           Agent 推理引擎              │
│    （模型选择 → 任务分解 → 工具调用）   │
├─────────────────────────────────────┤
│           技能调度层                  │
│   SKILL.md 解析 → 匹配 → 执行         │
├──────────┬──────────┬───────────────┤
│  内置技能  │  社区技能  │  自定义技能   │
│  github   │  xbrowser │  用户开发     │
│  pdf      │  docx     │  企业私有     │
│  xlsx     │  ima      │              │
└──────────┴──────────┴───────────────┘

# SKILL.md

## 描述
简要描述技能的用途和触发场景。

## 触发条件
- 关键词匹配
- 意图识别
- 文件类型

## 执行流程
1. 读取输入
2. 调用工具
3. 处理结果
4. 返回输出

## 工具依赖
- tool_name: 用途说明

## 配置
- 环境变量
- API密钥
- 路径设置

# SKILL.md - 文件管理技能

## 描述
当用户要求管理、整理、搜索文件时触发。

## 触发条件
- "整理文件"、"搜索文件"、"移动到"
- 文件路径出现在对话中

## 执行流程
1. 识别操作类型（搜索/移动/删除/重命名）
2. 确认目标路径和范围
3. 执行文件操作
4. 返回操作摘要

## 工具依赖
- read: 读取文件内容
- write: 创建/覆盖文件
- exec: 执行文件系统命令

# 技能目录结构
my-skill/
├── SKILL.md          # 技能定义
├── scripts/          # 脚本
│   ├── install.sh
│   └── run.py
├── templates/        # 模板文件
└── config.json       # 配置

{
  "skills": {
    "my-custom-skill": {
      "path": "./skills/my-skill",
      "enabled": true,
      "config": {
        "apiKey": "your-api-key",
        "timeout": 30000
      }
    }
  }
}

class SkillExecutor:
    def __init__(self, skill_config):
        self.config = skill_config
        self.tools = self.load_tools()
    
    def execute(self, user_input, context):
        # 1. 解析SKILL.md判断是否匹配
        if not self.match_trigger(user_input):
            return None
        
        # 2. 构建执行上下文
        exec_context = {
            "input": user_input,
            "workspace": context.get("workspace"),
            "tools": self.tools,
        }
        
        # 3. 按SKILL.md流程执行
        result = self.run_flow(exec_context)
        
        # 4. 后处理
        return self.format_output(result)

# 从ClawHub安装
openclaw skill install xbrowser

# 从本地安装
openclaw skill install ./my-skill/

# 查看已安装技能
openclaw skill list

# SKILL.md - 企业知识库搜索

## 描述
搜索企业内部知识库，返回相关文档和答案。

## 触发条件
- "查一下公司..."
- "知识库里有没有..."
- "文档里怎么说的..."

## 执行流程
1. 提取搜索关键词
2. 调用企业搜索API
3. 对结果进行摘要
4. 返回答案+来源链接

## 工具依赖
- web_fetch: 调用搜索API
- read: 读取本地缓存

# SKILL.md - 服务器运维

## 描述
执行服务器运维任务：部署、监控、日志分析。

## 触发条件
- "部署到生产环境"
- "查看服务器状态"
- "分析错误日志"

## 执行流程
1. 确认操作目标
2. 要求用户确认（生产环境操作）
3. 执行SSH命令
4. 返回执行结果
5. 更新运维日志

## 安全要求
- 生产环境操作必须二次确认
- 敏感命令需要审批
- 所有操作记录审计日志