CLI commands
Skills
openclaw skills
Проверяйте локальные навыки, ищите в ClawHub, устанавливайте навыки из ClawHub/Git/локальных каталогов, проверяйте навыки ClawHub и обновляйте установки, отслеживаемые ClawHub.
Связанные разделы:
- Система Skills: Skills
- Мастерская навыков: Мастерская навыков
- Конфигурация Skills: Конфигурация Skills
- Установки ClawHub: ClawHub
Команды
openclaw skills search "calendar"openclaw skills search --limit 20 --jsonopenclaw skills install @owner/<slug>openclaw skills install @owner/<slug> --version <version>openclaw skills install git:owner/repoopenclaw skills install git:owner/repo@mainopenclaw skills install ./path/to/skill --as custom-nameopenclaw skills install @owner/<slug> --forceopenclaw skills install @owner/<slug> --acknowledge-clawhub-riskopenclaw skills install @owner/<slug> --agent <id>openclaw skills install @owner/<slug> --globalopenclaw skills update @owner/<slug>openclaw skills update @owner/<slug> --acknowledge-clawhub-riskopenclaw skills update @owner/<slug> --globalopenclaw skills update --allopenclaw skills update --all --agent <id>openclaw skills update --all --globalopenclaw skills verify @owner/<slug>openclaw skills verify @owner/<slug> --version <version>openclaw skills verify @owner/<slug> --tag <tag>openclaw skills verify @owner/<slug> --cardopenclaw skills verify @owner/<slug> --globalopenclaw skills listopenclaw skills list --eligibleopenclaw skills list --jsonopenclaw skills list --verboseopenclaw skills list --agent <id>openclaw skills info <name>openclaw skills info <name> --jsonopenclaw skills info <name> --agent <id>openclaw skills checkopenclaw skills check --agent <id>openclaw skills check --jsonopenclaw skills workshop propose-create --name "qa-check" --description "QA checklist" --proposal ./PROPOSAL.mdopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Not reusable"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"search, update и verify используют ClawHub напрямую. install @owner/<slug>
устанавливает навык ClawHub, install git:owner/repo[@ref] клонирует навык из Git, а
install ./path копирует локальный каталог навыка. По умолчанию install, update
и verify нацелены на каталог skills/ активной рабочей области; с --global
они нацелены на общий управляемый каталог навыков. list/info/check по-прежнему
проверяют локальные навыки, видимые текущей рабочей области и конфигурации.
Команды, привязанные к рабочей области, определяют целевую рабочую область из
--agent <id>, затем из текущего рабочего каталога, если он находится внутри
настроенной рабочей области агента, затем из агента по умолчанию.
Установки из Git и локальных каталогов ожидают SKILL.md в корне источника. Slug
установки берется из frontmatter name в SKILL.md, если оно допустимо, затем из
имени исходного каталога или репозитория; используйте --as <slug>, чтобы
переопределить его. --version предназначен только для ClawHub. Установки навыков
не поддерживают спецификации пакетов npm или пути к zip/архивам, а
openclaw skills update обновляет только установки, отслеживаемые ClawHub.
Установки зависимостей навыков на базе Gateway, запускаемые из онбординга или
настроек Skills, вместо этого используют отдельный путь запроса skills.install.
Примечания:
search [query...]принимает необязательный запрос; опустите его, чтобы просматривать стандартную ленту поиска ClawHub.search --limit <n>ограничивает количество возвращаемых результатов.install git:owner/repo[@ref]устанавливает навык из Git. Ссылки на ветки могут содержать косые черты, напримерgit:owner/repo@feature/foo.install ./path/to/skillустанавливает локальный каталог, корень которого содержитSKILL.md.install --as <slug>переопределяет выведенный slug для установок из Git и локальных каталогов.install --version <version>применяется только к ссылкам на навыки ClawHub.install --forceперезаписывает существующую папку навыка рабочей области с тем же slug.- Установки и обновления навыков сообщества из ClawHub проверяют доверие перед
скачиванием. Версионированные архивные релизы сообщества используют метаданные
доверия точного релиза. Навыки GitHub на базе резолвера полагаются на
установочный резолвер ClawHub, который применяет политику сканирования и
принудительной установки перед возвратом закрепленного коммита. Вредоносные или
заблокированные релизы сообщества отклоняются. Рискованные релизы сообщества
требуют проверки и
--acknowledge-clawhub-risk, когда неинтерактивная команда должна продолжить работу после этой проверки. Официальные издатели навыков ClawHub и встроенные источники навыков OpenClaw обходят этот запрос доверия к релизу. --globalнацелен на общий управляемый каталог навыков и не может сочетаться с--agent <id>.--agent <id>нацелен на одну настроенную рабочую область агента и переопределяет вывод из текущего рабочего каталога.update @owner/<slug>обновляет один отслеживаемый навык. Добавьте--global, чтобы нацелиться на общий управляемый каталог навыков вместо рабочей области.update --allобновляет отслеживаемые установки ClawHub в выбранной рабочей области или в общем управляемом каталоге навыков при сочетании с--global.verify @owner/<slug>по умолчанию выводит JSON-конвертclawhub.skill.verify.v1от ClawHub. Флага--jsonнет, потому что JSON уже является форматом по умолчанию. Простые slug остаются допустимыми для совместимости, когда навык уже установлен или однозначен, но ссылки с указанием владельца устраняют неоднозначность издателя.- Когда ClawHub возвращает происхождение источника, определенное сервером, JSON
проверки также включает закрепленный на коммите
openclaw.verifiedSourceUrl. Недоступные или самостоятельно заявленные URL источника остаются только в сыром конверте происхождения и не продвигаются. verifyиспользует.clawhub/origin.jsonдля установленных навыков ClawHub, поэтому проверяет установленную версию по реестру, из которого она пришла.--versionи--tagпереопределяют селектор версии, но сохраняют этот установленный реестр, когда существуют метаданные происхождения.verify --cardвыводит сгенерированный Markdown карточки навыка вместо JSON. Команда завершается с ненулевым кодом, когда ClawHub возвращаетok: falseилиdecision: "fail"; неподписанные подписи являются информационными, если политика ClawHub не изменится.- Установленные пакеты ClawHub могут включать сгенерированный
skill-card.md. OpenClaw рассматривает проверку как серверное решение ClawHub и не отклоняет установленный навык только потому, что эта сгенерированная карточка меняет отпечаток пакета. check --agent <id>проверяет рабочую область выбранного агента и сообщает, какие готовые навыки фактически видны в prompt или командной поверхности этого агента.listявляется действием по умолчанию, когда подкоманда не указана.list,infoиcheckзаписывают отрендеренный вывод в stdout. С--jsonэто означает, что машиночитаемая полезная нагрузка остается в stdout для конвейеров и скриптов.
Мастерская навыков
openclaw skills workshop управляет ожидающими предложениями навыков в выбранной
рабочей области. Предложения не являются активными навыками, пока не применены.
Сведения о хранении предложений, защитах вспомогательных файлов, методах Gateway
и политике одобрения см. в разделе Мастерская навыков.
openclaw skills workshop propose-create \ --name "qa-check" \ --description "Repeatable QA checklist" \ --proposal ./PROPOSAL.mdopenclaw skills workshop propose-create \ --name "qa-check" \ --description "Repeatable QA checklist" \ --proposal-dir ./qa-check-proposalopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Duplicate"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"