OpenClaw Skills 技能开发完全指南

OpenClaw 使用 AgentSkills 兼容的技能文件夹来教 agent 如何使用工具。每个技能是一个目录，包含带有 YAML frontmatter 的 SKILL.md。

技能位置和优先级

OpenClaw 从以下来源加载技能：

1. 额外技能文件夹：通过 skills.load.extraDirs 配置
2. 内置技能：随安装一起提供（npm 包或 OpenClaw.app）
3. 管理/本地技能：~/.openclaw/skills
4. 个人智能体技能：~/.agents/skills
5. 项目智能体技能：<workspace>/.agents/skills
6. 工作区技能：<workspace>/skills

如果技能名称冲突，优先级为：

<workspace>/skills（最高）→ <workspace>/.agents/skills → ~/.agents/skills → ~/.openclaw/skills → 内置技能 → skills.load.extraDirs（最低）

每个智能体 vs 共享技能

在多智能体设置中，每个智能体有自己的工作区：

• 每个智能体的技能：位于该智能体的 <workspace>/skills
• 项目智能体技能：位于 <workspace>/.agents/skills，适用于该工作区
• 个人智能体技能：位于 ~/.agents/skills，跨工作区适用
• 共享技能：位于 ~/.openclaw/skills（管理/本地），对所有智能体可见

插件 + 技能

插件可以通过在 openclaw.plugin.json 中列出 skills 目录来自带技能。插件技能在插件启用时加载。

ClawHub（安装 + 同步）

ClawHub 是 OpenClaw 的公共技能注册表。在 clawhub.com 浏览。

常用命令

# 安装技能到工作区
openclaw skills install [skill-slug]

# 更新所有已安装的技能
openclaw skills update --all

# 同步（扫描 + 发布更新）
clawhub sync --all

创建自己的技能

技能目录结构

my-skill/
├── SKILL.md          # 必需：技能定义
├── scripts/          # 可选：辅助脚本
├── references/       # 可选：参考文档
└── assets/           # 可选：静态资源

SKILL.md 格式

---
name: my-skill
description: 我的自定义技能
metadata:
  openclaw:
    triggers:
      - "使用我的技能"
---

# 技能说明

这里是技能的详细使用说明...

相关资源

• ClawHub 技能市场
• 插件系统
• 多智能体路由

更多详细信息请访问：OpenClaw 官方 Skills 文档