manage-skill

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Install Skill

安装技能

Install skills into OpenClaw using the

npx skills

CLI (vercel-labs/skills).

使用

npx skills

CLI将技能安装到OpenClaw中（项目地址：vercel-labs/skills）。

Install Command

安装命令

bash

npx skills add <source> --skill <name> -g -y --copy

Required flags for OpenClaw:

```
-g
```
/
```
--global
```
: Install to user-level (
```
~/.openclaw/skills/
```
)
```
-y
```
/
```
--yes
```
: Skip prompts
```
--copy
```
: Copy files — symlinks break when the temp clone is deleted

Optional flags:

```
-a openclaw
```
: Target only OpenClaw (skip other agents). Use when you only need the skill here.
```
--list
```
/
```
-l
```
: List available skills without installing
```
--all
```
: Install all skills to all agents without prompts
```
--full-depth
```
: Deep recursive search when skills aren't in standard locations

bash

npx skills add <source> --skill <name> -g -y --copy

OpenClaw必填参数：

```
-g
```
/
```
--global
```
: 安装到用户级目录（
```
~/.openclaw/skills/
```
）
```
-y
```
/
```
--yes
```
: 跳过确认提示
```
--copy
```
: 复制文件——临时克隆目录删除后符号链接会失效

可选参数：

```
-a openclaw
```
: 仅针对OpenClaw（跳过其他Agent）。当仅需在此处安装技能时使用。
```
--list
```
/
```
-l
```
: 列出可用技能但不安装
```
--all
```
: 无提示地将所有技能安装到所有Agent
```
--full-depth
```
: 当技能不在标准位置时进行深度递归搜索

Source Formats

源格式

Always use a remote source (GitHub/GitLab). Local paths produce a broken hash in

skills-lock.json

, which means

npx skills update

will never detect changes. Remote sources get a real content hash and update correctly.

bash

undefined

请始终使用远程源（GitHub/GitLab）。 本地路径会在

skills-lock.json

中生成无效哈希，导致

npx skills update

永远无法检测到变更。远程源会生成真实内容哈希，确保更新正常进行。

bash

undefined

GitHub shorthand (clones default branch)

GitHub简写形式（克隆默认分支）

npx skills add owner/repo

Full GitHub URL

完整GitHub URL

npx skills add https://github.com/owner/repo

Specific branch via tree URL

通过tree URL指定特定分支

npx skills add https://github.com/owner/repo/tree/branch-name

Specific branch + subpath

特定分支+子路径

npx skills add https://github.com/owner/repo/tree/branch-name/path/to/skills

Skill filter (find skill named "foo" in default branch)

技能筛选（在默认分支中查找名为“foo”的技能）

npx skills add owner/repo@foo

GitLab

npx skills add https://gitlab.com/org/repo


**⚠️ Do NOT use local paths** (`npx skills add ./path`) — the lock file hash will be empty and updates will silently fail.

**⚠️ `owner/repo@thing` is a skill name filter, NOT a branch ref.** To target a non-default branch, use the full tree URL: `https://github.com/owner/repo/tree/branch-name`

The CLI clones the repo's **default branch**. If the default branch doesn't have the skill, use the tree URL.

npx skills add https://gitlab.com/org/repo


**⚠️ 请勿使用本地路径**（`npx skills add ./path`）——锁文件哈希会为空，更新将静默失败。

**⚠️ `owner/repo@thing`是技能名称筛选器，而非分支引用。** 若要指定非默认分支，请使用完整tree URL：`https://github.com/owner/repo/tree/branch-name`

CLI会克隆仓库的**默认分支**。如果默认分支中没有目标技能，请使用tree URL。

Skill Discovery

技能发现

The CLI scans these locations for

SKILL.md

files with valid YAML frontmatter (

name

description

Root directory,

skills/

.openclaw/skills/

.agents/skills/

.claude/skills/

, and 25+ other agent dirs

.claude-plugin/marketplace.json

plugin.json

if present

Recursive fallback if no standard locations match

If a skill isn't found: Check that its SKILL.md has valid YAML frontmatter with

name

and

description

fields. Without both, the skill is invisible.

CLI会在以下位置扫描带有有效YAML前置元数据（包含

name

和

description

字段）的

SKILL.md

文件：

根目录、

skills/

、

.openclaw/skills/

、

.agents/skills/

、

.claude/skills/

以及其他25+个Agent目录

若存在

.claude-plugin/marketplace.json

或

plugin.json

文件

若标准位置未匹配到，则进行递归回退搜索

若未找到技能： 检查其SKILL.md文件是否包含带有

name

和

description

字段的有效YAML前置元数据。缺少其中任意一个字段，技能都将无法被识别。

Post-Install Checklist

安装后检查清单

Verify copy (not symlink):
bash
```
ls -la ~/.openclaw/skills/<name>/SKILL.md
```
If symlink → reinstall with
```
--copy
```
.
Restart gateway so OpenClaw loads the new skill: Use the gateway restart tool.

验证是否为复制（而非符号链接）：
bash
```
ls -la ~/.openclaw/skills/<name>/SKILL.md
```
如果是符号链接→使用
```
--copy
```
参数重新安装。
重启网关使OpenClaw加载新技能：使用网关重启工具。

Other Commands

其他命令

bash

undefined

bash

undefined

List installed skills

列出已安装技能

npx skills list # or: npx skills ls npx skills ls -g # global only

npx skills list # 或：npx skills ls npx skills ls -g # 仅列出全局安装的技能

Search for skills

搜索技能

npx skills find [query]

Check for updates

检查更新

npx skills check

Update all installed skills

更新所有已安装技能

npx skills update

Remove a skill

移除技能

npx skills remove <name> -g -y

Create new skill template

创建新技能模板

npx skills init [name]

undefined

npx skills init [name]

undefined

Updating an Installed Skill

更新已安装技能

bash

npx skills update -g

Or remove and reinstall:

bash

npx skills remove <name> -g -y
npx skills add <source> --skill <name> -g -y --copy

Then restart the gateway.

bash

npx skills update -g

或者先移除再重新安装：

bash

npx skills remove <name> -g -y
npx skills add <source> --skill <name> -g -y --copy

然后重启网关。

Troubleshooting

故障排查

"No matching skills found": SKILL.md missing or lacks
```
name
```
/
```
description
```
frontmatter

Wrong branch cloned: Use

https://github.com/owner/repo/tree/branch

— not

owner/repo@branch

Skill not in available_skills: Restart the gateway
Permission errors: Check write access to
```
~/.openclaw/skills/
```

“未找到匹配技能”：SKILL.md文件缺失或缺少
```
name
```
/
```
description
```
前置元数据

克隆了错误分支：使用

https://github.com/owner/repo/tree/branch

——而非

owner/repo@branch

技能不在available_skills中：重启网关
权限错误：检查对
```
~/.openclaw/skills/
```
目录的写入权限

Reference

参考链接

Skills directory: skills.sh
Agent Skills spec: agentskills.io
OpenClaw skills docs: docs.openclaw.ai/tools/skills

Skills官网：skills.sh
Agent Skills规范：agentskills.io
OpenClaw技能文档：docs.openclaw.ai/tools/skills