CLI commands
Skills
openclaw skills
로컬 Skills를 검사하고, ClawHub를 검색하며, ClawHub/Git/로컬 디렉터리에서 Skills를 설치하고, ClawHub Skills를 검증하며, 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> --force-installopenclaw 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> --force-installopenclaw 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 Skill을 설치하고, install git:owner/repo[@ref]는 Git Skill을 복제하며, install ./path는 로컬 Skill 디렉터리를 복사합니다. 기본적으로 install, update, verify는 활성 작업 공간의 skills/ 디렉터리를 대상으로 하며, --global을 사용하면 공유 관리형 Skills 디렉터리를 대상으로 합니다. list/info/check는 계속해서 현재 작업 공간과 구성에서 볼 수 있는 로컬 Skills를 검사합니다. 작업 공간 기반 명령은 먼저 --agent <id>에서 대상 작업 공간을 결정하고, 그다음 현재 작업 디렉터리가 구성된 에이전트 작업 공간 안에 있으면 해당 디렉터리에서 결정하며, 마지막으로 기본 에이전트를 사용합니다.
Git 및 로컬 디렉터리 설치에서는 소스 루트에 SKILL.md가 있어야 합니다. 설치 슬러그는 유효한 경우 SKILL.md 프런트매터의 name에서 가져오고, 그렇지 않으면 소스 디렉터리 또는 저장소 이름에서 가져옵니다. 이를 재정의하려면 --as <slug>를 사용합니다. --version은 ClawHub에만 적용됩니다. Skill 설치는 npm 패키지 명세나 zip/아카이브 경로를 지원하지 않으며, openclaw skills update는 ClawHub에서 추적되는 설치만 업데이트합니다.
온보딩 또는 Skills 설정에서 트리거되는 Gateway 기반 Skill 종속성 설치는 별도의 skills.install 요청 경로를 사용합니다.
참고:
| 플래그/동작 | 설명 |
|---|---|
search [query...] |
선택적 쿼리입니다. 생략하면 기본 ClawHub 검색 피드를 탐색합니다. |
search --limit <n> |
반환되는 결과 수를 제한합니다. |
install git:owner/repo[@ref] |
Git Skill을 설치합니다. 브랜치 참조에는 git:owner/repo@feature/foo와 같이 슬래시가 포함될 수 있습니다. |
install ./path/to/skill |
루트에 SKILL.md가 있는 로컬 디렉터리를 설치합니다. |
install --as <slug> |
Git 및 로컬 디렉터리 설치에 대해 추론된 슬러그를 재정의합니다. |
install --version <version> |
ClawHub Skill 참조에만 적용됩니다. |
install --force |
동일한 슬러그의 기존 작업 공간 Skill 폴더를 덮어씁니다. |
install/update --force-install |
ClawHub의 검사가 완료되기 전에 대기 중인 GitHub 기반 ClawHub Skill을 설치합니다. |
--global |
공유 관리형 Skills 디렉터리를 대상으로 합니다. --agent <id>와 함께 사용할 수 없습니다. |
--agent <id> |
구성된 에이전트 작업 공간 하나를 대상으로 하며, 현재 작업 디렉터리를 통한 추론보다 우선합니다. |
update @owner/<slug> |
추적되는 Skill 하나를 업데이트합니다. 작업 공간 대신 공유 관리형 Skills 디렉터리를 대상으로 하려면 --global을 추가합니다. |
update --all |
선택한 작업 공간에서 추적되는 ClawHub 설치를 모두 업데이트하거나, --global을 사용하면 공유 관리형 Skills 디렉터리의 설치를 업데이트합니다. |
verify @owner/<slug> |
기본적으로 ClawHub의 clawhub.skill.verify.v1 JSON 봉투를 출력합니다. JSON이 이미 기본값이므로 --json 플래그는 없습니다. Skill이 이미 설치되어 있거나 모호하지 않은 경우 호환성을 위해 소유자 없는 슬러그도 허용되지만, 소유자가 지정된 참조를 사용하면 게시자 모호성을 피할 수 있습니다. |
verify 출처 |
ClawHub가 서버에서 확인된 소스 출처를 반환하면 검증 JSON에 커밋으로 고정된 openclaw.verifiedSourceUrl도 포함됩니다. 사용할 수 없거나 자체 선언된 소스 URL은 원시 출처 봉투에만 남으며 승격되지 않습니다. |
verify 버전 선택기 |
verify는 설치된 ClawHub Skills에 대해 .clawhub/origin.json을 사용하므로, 설치된 버전을 해당 Skill의 원래 레지스트리를 기준으로 검증합니다. --version과 --tag는 버전 선택기를 재정의하지만, 원본 메타데이터가 있으면 설치 당시 레지스트리를 계속 사용합니다. |
verify --card |
JSON 대신 생성된 Skill 카드 Markdown을 출력합니다. ClawHub가 ok: false 또는 decision: "fail"을 반환하면 0이 아닌 코드로 종료됩니다. 서명되지 않은 서명은 ClawHub 정책이 변경되지 않는 한 정보 제공용입니다. |
| Skill 카드 지문 | 설치된 ClawHub 번들에는 생성된 skill-card.md가 포함될 수 있습니다. OpenClaw는 검증을 ClawHub 서버의 결정으로 취급하며, 생성된 카드가 번들 지문을 변경했다는 이유만으로 설치된 Skill을 거부하지 않습니다. |
check --agent <id> |
선택한 에이전트의 작업 공간을 확인하고, 준비된 Skills 중 실제로 해당 에이전트의 프롬프트 또는 명령 표면에 표시되는 항목을 보고합니다. |
list |
하위 명령이 제공되지 않았을 때의 기본 동작입니다. |
list/info/check 출력 |
렌더링된 출력은 stdout으로 전송됩니다. --json을 사용하면 파이프와 스크립트를 위한 기계 판독 가능 페이로드가 stdout에 유지됩니다. |
커뮤니티 ClawHub Skill 설치 및 업데이트는 다운로드 전에 신뢰도를 확인합니다. 버전이 지정된 커뮤니티 아카이브 릴리스는 정확한 릴리스의 신뢰 메타데이터를 사용합니다. 리졸버 기반 GitHub Skills는 ClawHub의 설치 리졸버를 통해 검사 및 강제 설치 정책을 적용한 후 고정된 커밋을 반환합니다. 검사가 완료되기 전에 대기 중인 GitHub 기반 Skill을 설치하려면 --force-install을 사용합니다. 악성이거나 차단된 커뮤니티 릴리스는 거부됩니다. 위험한 커뮤니티 릴리스는 검토가 필요하며, 비대화형 명령이 검토 후 계속 진행해야 하는 경우 --acknowledge-clawhub-risk가 필요합니다. 공식 ClawHub Skill 게시자와 OpenClaw에 번들로 포함된 Skill 소스에는 이 릴리스 신뢰 확인 메시지가 표시되지 않습니다.
Skill 워크숍
openclaw skills workshop은 선택한 작업 공간에서 대기 중인 Skill 제안을 관리합니다. 제안은 적용되기 전까지 활성 Skills가 아닙니다. 제안 저장소, 지원 파일 보호 조치, Gateway 메서드 및 승인 정책에 대해서는 Skill 워크숍을 참조하세요.
openclaw skills workshop propose-create \ --name "qa-check" \ --description "반복 가능한 QA 체크리스트" \ --proposal ./PROPOSAL.mdopenclaw skills workshop propose-create \ --name "qa-check" \ --description "반복 가능한 QA 체크리스트" \ --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 "중복"openclaw skills workshop quarantine <proposal-id> --reason "보안 검토 필요"propose-create, propose-update, revise는 제안의 동기와 근거 메모를
--proposal/--proposal-dir 콘텐츠와 함께 기록할 수 있도록 --goal <text>와
--evidence <text>도 허용합니다.
