OpenClaw 技能系统指南

技能系统概述

技能（Skills）是 OpenClaw 的核心扩展机制，让 AI 助手能够完成复杂的任务。

技能 vs 工具

理解技能和工具的区别很重要：

工具（Tools）：

单个原子操作
例如：读文件、发 HTTP 请求、执行 Shell 命令

技能（Skills）：

组合工具完成复杂任务的知识
例如：管理 GitHub Issue = 搜索 + 读取 + 添加评论 + 修改标签

技能本质上是系统指令 + 工具定义的组合。

技能的三个层级

| 层级 | 说明 | 来源 | |------|------|------| | Bundled Skills | 内置技能，随 OpenClaw 安装 | 核心仓库 | | Managed Skills | 社区技能，通过 ClawHub 安装 | clawhub.com | | Workspace Skills | 自定义本地技能 | 工作空间目录 |

内置技能

OpenClaw 提供丰富的内置技能，涵盖多个领域。

办公效率

Google Workspace (gog)：

Gmail 邮件管理
Google Calendar 日历管理
Google Docs 文档操作

# 启用 Google Workspace 技能
openclaw skills enable gog

# 配置认证
openclaw skills config gog --auth

Notion (notion)：

页面管理
数据库操作
内容搜索

Trello (trello)：

看板管理
任务卡片操作

Slack (slack)：

工作区消息管理
频道操作

1Password (1password)：

密码查询（只读）
安全凭证管理

笔记管理

Obsidian (obsidian)：

笔记搜索
文件管理
链接导航

Apple Notes (apple-notes)：

备忘录管理
文件夹操作

Bear Notes (bear-notes)：

笔记管理
标签操作

开发工具

Coding Agent (coding-agent)：

编程助手
代码生成
调试和重构

GitHub (github)：

仓库管理
Pull Request 操作
Issue 管理

GitHub Issues (gh-issues)：

Issue 专项管理
标签和里程碑

tmux (tmux)：

终端会话管理
窗口和面板操作

任务管理

Apple Reminders (apple-reminders)：

提醒事项管理
列表操作

Things (things-mac)：

任务管理
项目和区域

多媒体

Spotify (spotify-player)：

音乐播放控制
播放列表管理

Voice Call (voice-call)：

语音通话（ElevenLabs）
实时对话

Peekaboo (peekaboo)：

屏幕截图
图像处理

Camera Snap (camsnap)：

摄像头拍照
图像捕获

Video Frames (video-frames)：

视频帧提取
视频分析

实用工具

Weather (weather)：

天气查询
预报信息

Summarize (summarize)：

内容摘要
文本压缩

PDF (nano-pdf)：

PDF 处理
文本提取

Skill Creator (skill-creator)：

创建自定义技能
技能模板生成

系统管理

Health Check (healthcheck)：

系统健康检查
状态监控

Session Logs (session-logs)：

会话日志查看
历史记录

Model Usage (model-usage)：

模型使用统计
成本分析

管理技能

查看技能列表

# 查看所有可用技能
openclaw skills list

# 查看已启用的技能
openclaw skills list --enabled

# 查看技能详情
openclaw skills info github

启用和禁用技能

# 启用技能
openclaw skills enable weather
openclaw skills enable github

# 禁用技能
openclaw skills disable weather

# 批量启用
openclaw skills enable weather,github,notion

配置技能

# 配置技能参数
openclaw skills config github --token "YOUR_GITHUB_TOKEN"

# 查看技能配置
openclaw skills config github --show

# 重置技能配置
openclaw skills config github --reset

社区技能（ClawHub）

ClawHub 是 OpenClaw 的技能市场，提供社区开发的技能。

浏览技能

访问 https://clawhub.com 浏览可用技能。

安装技能

# 搜索技能
openclaw skills search "email"

# 安装技能
openclaw skills install email-automation

# 查看已安装的社区技能
openclaw skills list --source clawhub

更新技能

# 更新单个技能
openclaw skills update email-automation

# 更新所有技能
openclaw skills update --all

卸载技能

# 卸载技能
openclaw skills uninstall email-automation

开发自定义技能

技能结构

技能是一个包含以下文件的目录：

my-skill/
├── skill.json          # 技能元数据
├── instructions.md     # 系统指令
├── tools.json          # 工具定义（可选）
└── README.md          # 说明文档（可选）

创建技能

使用 Skill Creator 快速创建：

# 使用内置技能创建器
openclaw agent --message "帮我创建一个天气查询技能"

# 或手动创建
mkdir -p ~/.openclaw/workspace/skills/my-skill
cd ~/.openclaw/workspace/skills/my-skill

skill.json 示例

{
  "name": "my-skill",
  "version": "1.0.0",
  "description": "我的自定义技能",
  "author": "Your Name",
  "keywords": ["custom", "example"],
  "dependencies": {
    "tools": ["http", "file"]
  },
  "config": {
    "apiKey": {
      "type": "string",
      "required": true,
      "description": "API Key"
    }
  }
}

instructions.md 示例

# My Skill Instructions

你是一个专门处理特定任务的助手。

## 能力

- 能力 1：描述
- 能力 2：描述

## 工作流程

1. 步骤 1
2. 步骤 2
3. 步骤 3

## 注意事项

- 注意事项 1
- 注意事项 2

tools.json 示例

{
  "tools": [
    {
      "name": "my_tool",
      "description": "工具描述",
      "parameters": {
        "type": "object",
        "properties": {
          "param1": {
            "type": "string",
            "description": "参数描述"
          }
        },
        "required": ["param1"]
      }
    }
  ]
}

测试技能

# 加载技能
openclaw skills load ~/.openclaw/workspace/skills/my-skill

# 测试技能
openclaw agent --skill my-skill --message "测试消息"

发布技能

# 打包技能
openclaw skills pack my-skill

# 发布到 ClawHub
openclaw skills publish my-skill

技能开发最佳实践

1. 清晰的指令

技能指令应该：

明确定义能力范围
提供详细的工作流程
包含错误处理指导
给出使用示例

2. 最小化工具依赖

只依赖必要的工具：

减少复杂度
提高可靠性
便于维护

3. 参数验证

在工具定义中明确参数类型和约束：

使用 JSON Schema 验证
提供默认值
标记必需参数

4. 错误处理

提供清晰的错误信息：

说明错误原因
提供解决建议
记录错误日志

5. 文档完善

编写详细的文档：

README.md 说明用途
提供使用示例
列出依赖和配置

6. 版本管理

遵循语义化版本：

主版本：不兼容的 API 变更
次版本：向后兼容的功能新增
修订版本：向后兼容的问题修正

技能组合

技能链

多个技能可以协同工作：

# 配置技能链
openclaw skills chain create email-to-task \
  --skills "email-reader,task-creator" \
  --trigger "new-email"

技能优先级

配置技能的加载优先级：

openclaw config set skills.priority "coding-agent,github,notion"

技能安全

权限控制

限制技能的权限：

# 配置技能权限
openclaw skills permissions my-skill \
  --allow "file:read,http:get" \
  --deny "file:write,shell:exec"

沙箱模式

在沙箱中运行技能：

# 启用沙箱模式
openclaw config set skills.sandbox.enabled true

# 配置沙箱限制
openclaw config set skills.sandbox.maxMemory "512M"
openclaw config set skills.sandbox.timeout 30

技能性能优化

懒加载

从 v2026.4.22 开始，内置技能采用懒加载，启动时间缩短 82-90%。

缓存

启用技能结果缓存：

openclaw config set skills.cache.enabled true
openclaw config set skills.cache.ttl 3600

并发控制

限制并发执行的技能数量：

openclaw config set skills.concurrency.max 5

常见问题

技能无法加载

原因：

技能文件格式错误
缺少必需的依赖
权限不足

解决：

# 验证技能格式
openclaw skills validate my-skill

# 检查依赖
openclaw skills deps my-skill

# 查看日志
openclaw logs skills

技能执行失败

原因：

配置错误
API Key 无效
网络问题

解决：

# 检查配置
openclaw skills config my-skill --show

# 测试连接
openclaw skills test my-skill

# 查看详细日志
openclaw agent --skill my-skill --message "test" --verbose

技能冲突

原因：

多个技能提供相同功能
工具名称冲突

解决：

# 禁用冲突的技能
openclaw skills disable conflicting-skill

# 配置技能优先级
openclaw config set skills.priority "preferred-skill,other-skill"

技能示例

示例 1：简单的天气查询技能

skill.json：

{
  "name": "simple-weather",
  "version": "1.0.0",
  "description": "简单的天气查询",
  "dependencies": {
    "tools": ["http"]
  }
}

instructions.md：

# Weather Query Skill

当用户询问天气时，使用 HTTP 工具调用天气 API。

API: https://api.weather.com/v1/current
参数: location (城市名称)

返回格式化的天气信息。

示例 2：GitHub Issue 管理技能

skill.json：

{
  "name": "github-issue-manager",
  "version": "1.0.0",
  "description": "GitHub Issue 管理",
  "dependencies": {
    "tools": ["http"]
  },
  "config": {
    "githubToken": {
      "type": "string",
      "required": true
    }
  }
}

instructions.md：

# GitHub Issue Manager

管理 GitHub Issues 的技能。

## 功能

1. 搜索 Issues
2. 创建新 Issue
3. 更新 Issue 状态
4. 添加评论
5. 修改标签

## API 使用

使用 GitHub REST API v3
认证: Bearer token

最佳实践总结

从内置技能开始：熟悉现有技能
按需启用：只启用需要的技能
定期更新：保持技能最新
测试后部署：确保技能正常工作
文档完善：便于维护和分享
安全第一：限制技能权限
性能优化：使用缓存和懒加载
社区贡献：分享优秀技能

下一步

掌握技能系统后，你可以：

配置记忆系统：阅读记忆系统指南
多 Agent 协作：阅读多 Agent 协作指南
部署到生产：阅读 Docker 部署指南
加固安全：阅读安全配置指南

参考资源

ClawHub 技能市场：https://clawhub.com
技能开发文档：https://docs.openclaw.ai/skills
技能 API 参考：https://docs.openclaw.ai/api/skills
社区讨论：https://discord.gg/clawd

OpenClaw 技能系统指南：扩展 AI 助手能力

分享这篇文章