OpenClaw 技能手动安装指南

安装方法总结

方法1：直接复制目录（推荐）

# 1. 准备技能目录
$skillDir = "C:\path\to\your-skill"  # 包含SKILL.md的目录

# 2. 目标位置
$targetDir = "$env:USERPROFILE\.openclaw\skills\技能名称"

# 3. 复制
Copy-Item -Path $skillDir -Destination $targetDir -Recurse -Force

# 4. 验证
Test-Path "$targetDir\SKILL.md"

方法2：从ZIP文件安装

# 解压ZIP到技能目录
Expand-Archive -Path "技能文件.zip" -DestinationPath "$env:USERPROFILE\.openclaw\skills\技能名称" -Force

方法3：从Git仓库安装

# 克隆仓库
git clone https://github.com/用户名/仓库名.git "$env:USERPROFILE\.openclaw\skills\技能名称"

方法4：使用OpenClaw CLI

# 从ClawHub搜索和安装
openclaw skills search "关键词"
openclaw skills install 技能slug

技能目录结构要求

必需结构：

技能名称/
└── SKILL.md          # 必须有YAML frontmatter

完整结构示例：

my-skill/
├── SKILL.md          # 技能描述文件（必需）
├── scripts/          # 可执行脚本（可选）
│   ├── process.py
│   └── utils.sh
├── references/       # 参考文档（可选）
│   ├── api.md
│   └── guide.md
├── assets/           # 资源文件（可选）
│   ├── templates/
│   └── images/
└── _meta.json        # 元数据（可选）

SKILL.md 文件格式：

---
name: skill-name      # 技能名称（必需）
description: 技能描述，说明何时使用此技能（必需）
---

# 技能标题

技能详细说明和使用方法...

验证安装

1. 检查技能列表

openclaw skills list

2. 检查技能详情

openclaw skills info 技能名称

3. 检查技能状态

openclaw skills check

4. 手动验证

# 检查文件是否存在
Test-Path "$env:USERPROFILE\.openclaw\skills\技能名称\SKILL.md"

# 查看技能内容
Get-Content "$env:USERPROFILE\.openclaw\skills\技能名称\SKILL.md" -First 20

安装脚本示例

通用安装脚本：

# install-skill.ps1
param(
    [string]$SkillName,
    [string]$SourcePath
)

$SkillsDir = "$env:USERPROFILE\.openclaw\skills"
$TargetPath = "$SkillsDir\$SkillName"

# 创建目录
if (-not (Test-Path $SkillsDir)) {
    New-Item -ItemType Directory -Path $SkillsDir -Force
}

# 复制技能
if (Test-Path $TargetPath) {
    Write-Host "技能已存在，覆盖..." -ForegroundColor Yellow
    Remove-Item -Path $TargetPath -Recurse -Force
}

Copy-Item -Path $SourcePath -Destination $TargetPath -Recurse -Force

# 验证
if (Test-Path "$TargetPath\SKILL.md") {
    Write-Host "✅ 技能安装成功: $SkillName" -ForegroundColor Green
    Write-Host "位置: $TargetPath" -ForegroundColor Gray
} else {
    Write-Host "❌ 技能安装失败: 缺少SKILL.md" -ForegroundColor Red
}

使用示例：

.\install-skill.ps1 -SkillName "my-skill" -SourcePath "C:\Downloads\my-skill"

常见问题

1. 技能不显示在列表中

• 检查 SKILL.md 文件格式是否正确
• 确保YAML frontmatter包含 name 和 description
• 重启OpenClaw或运行 openclaw skills refresh

2. 技能状态为"needs setup"

• 检查技能依赖是否满足
• 查看技能文档中的安装要求
• 运行 openclaw skills check 查看详情

3. 技能目录权限问题

# 以管理员身份运行
Start-Process PowerShell -Verb RunAs -ArgumentList "Copy-Item ..."

4. 从不同来源安装

• GitHub: 下载Release的ZIP文件或克隆仓库
• ClawHub: 使用 openclaw skills install
• 本地开发: 直接复制开发目录

最佳实践

1. 备份现有技能：

# 备份技能目录
Compress-Archive -Path "$env:USERPROFILE\.openclaw\skills" -DestinationPath "skills-backup.zip"

2. 测试技能功能：

# 运行技能中的测试脚本
python "技能目录\scripts\test.py"

3. 保持技能更新：

# 更新ClawHub安装的技能
openclaw skills update

4. 组织技能目录：

# 按类别组织
New-Item -ItemType Directory -Path "$env:USERPROFILE\.openclaw\skills\productivity" -Force
New-Item -ItemType Directory -Path "$env:USERPROFILE\.openclaw\skills\development" -Force

已安装技能位置

• 用户技能: %USERPROFILE%\.openclaw\skills\
• 系统技能: OpenClaw安装目录\skills\
• 工作区技能: 工作区目录\skills\（如果配置了工作区）

获取更多技能

1. ClawHub官方仓库: https://clawhub.ai
2. GitHub搜索: "openclaw skill"
3. 社区分享: OpenClaw Discord社区

---

适用于: OpenClaw 2026.3.24+