OpenClaw技能系统完全指南:从入门到精通ClawHub使用

---
name: example-skill
description: 这是一个示例技能，用于演示技能结构
version: 1.0.0
author: TJMtaotao
tags: ["example", "tutorial"]
metadata:
  openclaw:
    emoji: "📚"
    homepage: https://example.com/skill
    requires:
      bins: ["python3", "curl"]
      skills: ["web-search"]
---

# 示例技能

这个技能演示了OpenClaw技能的基本结构。

## 使用场景

当用户说"xxx"时激活此技能。

## 前置要求

-Python 3.x
-curl命令
-网络连接

## 执行步骤

1. 第一步：准备
2. 第二步：执行
3. 第三步：返回结果

## 输出格式

技能返回的结果格式为Markdown表格。

1.Workspace技能<workspace>/skills/
2.项目Agent技能<workspace>/.agents/skills/
3.用户Agent技能~/.agents/skills/
4.托管技能~/.openclaw/skills/
5.内置技能[安装目录]/skills/
6.额外目录skills.load.extraDirs配置

# 搜索包含"calendar"的技能
openclawskillssearch"calendar"

# 搜索包含多个关键词的技能
openclawskillssearch"email automation"

# 查看搜索结果
# 输出示例：
# 📦 calendar-manager (v1.2.3) - ⭐4.8 (2.3k安装)
#    Google Calendar集成技能
#    
# 📦 remind-me (v0.8.1) - ⭐4.2 (800安装)
#    简单的提醒技能

# 标准安装（安装到默认位置）
openclawskillsinstall<skill-slug>

# 安装到指定目录
openclawskillsinstall<skill-slug>--dir./my-skills

# 从GitHub安装（开发版）
openclawskillsinstallgithub:username/repo--branchmain

# 列出所有已安装技能
openclawskillslist

# 列出可用的技能（符合当前任务上下文的）
openclawskillslist--eligible

# 查看特定技能的详细信息
openclawskillsinfo<skill-name>

# 更新单个技能
openclawskillsupdate<skill-name>

# 更新所有已安装技能
openclawskillsupdate--all

# 查看可用的更新
openclawskillscheck

# 卸载技能（保留配置文件）
openclawskillsuninstall<skill-name>

# 完全移除（包括配置）
openclawskillsuninstall<skill-name>--purge

# 安装CLI（需要npm或pnpm）
npmi-gclawhub
# 或
pnpmadd-gclawhub

# 登录ClawHub账号
clawhublogin

# 查看当前登录用户
clawhubwhoami

# 发布技能
clawhubskillpublish./my-skill--slugmy-skill--version1.0.0

# 探索技能包
clawhubpackageexplore--familycode-plugin

# 检查技能健康度
clawhubpackageinspect<package-name>

# 同步所有技能到最新
clawhubsync--all

openclawskillsinstallgithub

openclawskillsinstallcoding-agent

openclawskillsinstallhumanizer

---
name: daily-weather
description: 每天早上播报天气情况
version: 1.0.0
---

# 每日天气播报技能

## 触发条件

当用户说"今天天气怎么样"、"天气播报"、"播报天气"时激活。

## 执行步骤

1. 使用 `web_fetch` 工具访问 wttr.in 获取当前天气
2. 解析温度、湿度、风速、天气状况等信息
3. 生成简洁的中文播报内容
4. 使用 `message` 工具发送到用户聊天窗口

## 输出格式

## 注意事项

- 如果用户没有指定城市，默认查询广州
- 如果网络请求失败，返回"抱歉，无法获取天气数据"

## 执行步骤

1. 使用 `exec` 工具运行 `ls -la`
2. 解析输出：
-如果包含"Permission denied"，告知用户权限不足
-如果包含"No such file"，告知用户文件不存在
-如果正常返回，提取文件列表并格式化输出
3. 如果用户指定了"--long"参数，额外显示文件详情
4. 结束

---
name:skill-name# 技能唯一标识（字母、数字、连字符）
description:简短描述# 用于搜索和展示
version:1.0.0# 语义化版本号
author:作者名# 开发者信息
tags:["tag1","tag2"]# 分类标签

metadata:
openclaw:
emoji:"📦"# 技能图标（emoji）
homepage:https://...# 技能文档链接
requires:
bins:["python3","gh"]# 需要的系统命令
skills:["github"]# 依赖的其他技能
env:# 需要的环境变量
-GITHUB_TOKEN
install:
-kind:uv# 安装方式：uv/npm/pip等
package:requests
triggers:
keywords:["关键词1","关键词2"]# 触发关键词
commands:["/cmd1","/cmd2"]# 触发命令
---

# 查看技能是否被正确加载
openclawskillslist--eligible|grep<skill-name>

# 测试技能触发
# 在OpenClaw对话中说触发关键词
# 观察技能是否被激活，以及执行结果

# 查看技能执行日志
openclawlogs--skill<skill-name>

my-skill/
├── SKILL.md           # 必需：技能定义文件
├── README.md          # 可选：详细使用说明
├── references/        # 可选：参考文档
├── scripts/           # 可选：辅助脚本
├── config/            # 可选：配置文件模板
└── test/              # 可选：测试文件

# 1. 确保你的技能目录结构正确
# 2. 编写完整的SKILL.md

# 3. 登录ClawHub
clawhublogin

# 4. 发布技能
clawhubskillpublish./my-skill\
--slugmy-skill\
--name"我的技能"\
--version1.0.0\
--description"这是一个示例技能"

# 5. 如果想先检查
clawhubskillpublish./my-skill--dry-run

# 安装特定版本
openclawskillsinstallmy-skill--version1.0.0

# 锁定版本（防止自动更新）
openclawskillspinmy-skill--version1.0.0

# 查看版本历史
clawhubpackageinspectmy-skill--show-versions

# 升级到新版本
openclawskillsupdatemy-skill

# 使用--safe参数安装，限制技能权限
openclawskillsinstall<skill-slug>--safe

# safe模式会：
# - 禁止执行shell命令
# - 禁止访问工作目录以外的文件
# - 禁止调用exec工具
# - 禁止安装新的技能

// openclaw.json
{
"skills":{
"allowlist":{
"enabled":true,
"skills":[
"github",
"weather",
"tavily",
"memory-search"
]
},
"denylist":{
"enabled":true,
"skills":[]
}
}
}

# 检查所有技能的新版本
openclawskillscheck

# 更新所有过时技能
openclawskillsupdate--all

# 自动更新（配置cron）
# 每天凌晨3点自动更新所有技能
openclawcronadd"0 3 * * *""openclaw skills update --all"

## 优先级

本技能优先级为5（1-10，数字越大优先级越高）
如果同时有其他技能处理同一请求，使用本技能的输出。

## 激活条件（排他）

当用户说"查询天气"且没有指定其他城市时激活。
如果用户已经说过"我不想用天气技能"，本技能不激活。

# 导出所有技能列表
openclawskillslist--json>skills-backup.json

# 备份特定技能目录
cp-r~/.openclaw/skills./backup-skills-$(date+%Y%m%d)

# 从备份恢复
cp-r./backup-skills-20260315/*~/.openclaw/skills/