На цій сторінці
На цій сторінці
CLI commands
Skills
openclaw skills
Переглядайте локальні Skills, шукайте в ClawHub, установлюйте Skills із ClawHub, Git або локальних каталогів, перевіряйте Skills із ClawHub та оновлюйте встановлення, відстежувані через ClawHub.
Пов’язані матеріали:
- Система Skills: Skills
- Майстерня Skills: Майстерня Skills
- Конфігурація Skills: Конфігурація Skills
- Встановлення з ClawHub: ClawHub
Команди
search, update і verify використовують ClawHub безпосередньо. install @owner/<slug> установлює Skill із ClawHub, install git:owner/repo[@ref] клонує Skill із Git, а install ./path копіює локальний каталог Skill. За замовчуванням install, update і verify спрямовані на каталог skills/ активного робочого простору; з --global вони спрямовані на спільний керований каталог Skills. list/info/check і далі перевіряють локальні Skills, видимі для поточного робочого простору та конфігурації. Команди, що працюють із робочим простором, визначають цільовий робочий простір спочатку за --agent <id>, потім за поточним робочим каталогом, якщо він розташований у налаштованому робочому просторі агента, і зрештою використовують агента за замовчуванням.
Для встановлення з Git і локального каталогу файл SKILL.md має бути в корені джерела. Ідентифікатор встановлення береться зі значення name у frontmatter файлу SKILL.md, якщо воно дійсне, а інакше — з назви каталогу джерела або репозиторію; використовуйте --as <slug>, щоб перевизначити його. --version застосовується лише до ClawHub. Встановлення Skills не підтримує специфікації пакетів npm або шляхи до zip-файлів чи архівів, а openclaw skills update оновлює лише встановлення, відстежувані через ClawHub.
Встановлення залежностей Skills через Gateway, запущене під час початкового налаштування або з налаштувань Skills, натомість використовує окремий шлях запиту skills.install.
Примітки:
| Прапорець/поведінка | Опис |
|---|---|
search [query...] |
Необов’язковий запит; пропустіть його, щоб переглянути стандартну стрічку пошуку ClawHub. |
search --limit <n> |
Обмежує кількість повернених результатів. |
install git:owner/repo[@ref] |
Установлює Skill із Git. Посилання на гілки можуть містити скісні риски, наприклад git:owner/repo@feature/foo. |
install ./path/to/skill |
Установлює локальний каталог, корінь якого містить SKILL.md. |
install --as <slug> |
Перевизначає автоматично визначений ідентифікатор для встановлень із Git і локальних каталогів. |
install --version <version> |
Застосовується лише до посилань на Skills у ClawHub. |
install --force |
Перезаписує наявну папку Skill у робочому просторі з тим самим ідентифікатором. |
install/update --force-install |
Установлює Skill із ClawHub на базі GitHub, що очікує перевірки, до завершення сканування ClawHub. |
--global |
Спрямовує операцію на спільний керований каталог Skills; не можна поєднувати з --agent <id>. |
--agent <id> |
Спрямовує операцію на один налаштований робочий простір агента; перевизначає визначення за поточним робочим каталогом. |
update @owner/<slug> |
Оновлює один відстежуваний Skill. Додайте --global, щоб спрямувати операцію на спільний керований каталог Skills замість робочого простору. |
update --all |
Оновлює встановлення з ClawHub, відстежувані у вибраному робочому просторі, або в спільному керованому каталозі Skills за використання --global. |
verify @owner/<slug> |
За замовчуванням виводить JSON-конверт ClawHub clawhub.skill.verify.v1. Прапорця --json немає, оскільки JSON уже використовується за замовчуванням. Ідентифікатори без власника підтримуються для сумісності, коли Skill уже встановлено або його можна визначити однозначно; посилання із зазначенням власника усувають неоднозначність видавця. |
Походження verify |
Коли ClawHub повертає визначене сервером походження джерела, JSON перевірки також містить openclaw.verifiedSourceUrl, закріплену за конкретним комітом. Недоступні або самостійно заявлені URL-адреси джерел залишаються лише в необробленому конверті походження й не підвищуються до перевірених. |
Вибір версії verify |
verify використовує .clawhub/origin.json для встановлених Skills із ClawHub, тому перевіряє встановлену версію за реєстром, з якого її отримано. --version і --tag перевизначають вибір версії, але зберігають цей реєстр, якщо наявні метадані походження. |
verify --card |
Виводить згенерований Markdown картки Skill замість JSON. Завершується з ненульовим кодом, коли ClawHub повертає ok: false або decision: "fail"; непідписані сигнатури мають інформаційний характер, якщо політика ClawHub не зміниться. |
| Відбиток картки Skill | Установлені пакети ClawHub можуть містити згенерований файл skill-card.md. OpenClaw розглядає перевірку як рішення сервера ClawHub і не відхиляє встановлений Skill лише через те, що ця згенерована картка змінює відбиток пакета. |
check --agent <id> |
Перевіряє робочий простір вибраного агента та повідомляє, які готові Skills фактично видимі в підказці або інтерфейсі команд цього агента. |
list |
Стандартна дія, якщо підкоманду не вказано. |
Виведення list/info/check |
Відформатований результат надходить до stdout. З --json машинозчитувані дані залишаються в stdout для конвеєрів і скриптів. |
Під час установлення й оновлення спільнотних Skills із ClawHub рівень довіри перевіряється до завантаження. Версіоновані архівні випуски спільноти використовують метадані довіри конкретного випуску. Skills із GitHub, що використовують резолвер, покладаються на резолвер встановлення ClawHub для застосування політики сканування та примусового встановлення перед поверненням закріпленого коміту; використовуйте --force-install, щоб установити Skill на базі GitHub, який очікує перевірки, до завершення цього сканування. Шкідливі або заблоковані випуски спільноти відхиляються. Ризиковані випуски спільноти потребують перевірки та прапорця --acknowledge-clawhub-risk, якщо неінтерактивна команда має продовжити роботу після цієї перевірки. Для офіційних видавців Skills у ClawHub і вбудованих джерел Skills OpenClaw цей запит щодо довіри до випуску пропускається.
Майстерня Skills
openclaw skills workshop керує пропозиціями Skills, що очікують розгляду у вибраному робочому просторі. Пропозиції не є активними Skills, доки їх не застосовано. Докладніше про зберігання пропозицій, захист допоміжних файлів, методи Gateway і політику схвалення див. у розділі Майстерня Skills.
propose-create, propose-update і revise також приймають --goal <text>
і --evidence <text>, щоб записати мотивацію пропозиції та допоміжні
нотатки разом із вмістом --proposal/--proposal-dir.