На этой странице
На этой странице
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 в корне источника. Слаг
установки берётся из SKILL.md во frontmatter name, если значение допустимо, а затем
из имени исходного каталога или репозитория; используйте --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 в выбранной рабочей области или, с --global, в общем каталоге управляемых Skills. |
verify @owner/<slug> |
По умолчанию выводит JSON-конверт clawhub.skill.verify.v1 от ClawHub. Флаг --json отсутствует, поскольку JSON уже используется по умолчанию. Слаги без владельца принимаются для совместимости, если Skill уже установлен или однозначно определяется; ссылки с указанием владельца устраняют неоднозначность издателя. |
Происхождение verify |
Когда ClawHub возвращает определённые сервером сведения о происхождении исходного кода, JSON проверки также включает привязанный к коммиту openclaw.verifiedSourceUrl. Недоступные или самостоятельно заявленные URL исходного кода остаются только в необработанном конверте происхождения и не продвигаются. |
Селектор версии verify |
verify использует .clawhub/origin.json для установленных Skills из ClawHub, поэтому проверяет установленную версию по реестру, из которого она получена. --version и --tag переопределяют селектор версии, но при наличии метаданных происхождения сохраняют установленный реестр. |
verify --card |
Выводит сгенерированную карточку Skill в формате Markdown вместо 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 управляет ожидающими предложениями навыков в выбранном
рабочем пространстве. Предложения не становятся активными навыками, пока их
не применят. Сведения о хранении предложений, защите вспомогательных файлов,
методах Gateway и политике утверждения см. в разделе
Мастерская навыков.
propose-create, propose-update и revise также принимают --goal <text>
и --evidence <text>, чтобы сохранить мотивацию предложения и сопроводительные
примечания вместе с содержимым --proposal/--proposal-dir.