CLI commands
Skills
openclaw skills
로컬 스킬을 검사하고, ClawHub를 검색하고, ClawHub/Git/로컬 디렉터리에서 스킬을 설치하고, 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가 있어야 합니다. 설치 슬러그는
유효한 경우 SKILL.md 프런트매터의 name에서 가져오고, 그다음 소스 디렉터리 또는
리포지터리 이름에서 가져옵니다. 이를 재정의하려면 --as <slug>를 사용하세요. --version은
ClawHub 전용입니다. 스킬 설치는 npm 패키지 사양이나 zip/아카이브
경로를 지원하지 않으며, openclaw skills update는 ClawHub에서 추적하는 설치만 업데이트합니다.
온보딩 또는 Skills 설정에서 트리거되는 Gateway 기반 스킬 의존성 설치는
별도의 skills.install 요청 경로를 대신 사용합니다.
참고:
search [query...]는 선택적 쿼리를 받습니다. 기본 ClawHub 검색 피드를 탐색하려면 생략하세요.search --limit <n>은 반환되는 결과 수를 제한합니다.install git:owner/repo[@ref]는 Git 스킬을 설치합니다. 브랜치 ref에는git:owner/repo@feature/foo처럼 슬래시가 포함될 수 있습니다.install ./path/to/skill은 루트에SKILL.md가 포함된 로컬 디렉터리를 설치합니다.install --as <slug>는 Git 및 로컬 디렉터리 설치에서 추론된 슬러그를 재정의합니다.install --version <version>은 ClawHub 스킬 ref에만 적용됩니다.install --force는 같은 슬러그에 대한 기존 워크스페이스 스킬 폴더를 덮어씁니다.- 커뮤니티 ClawHub 스킬 설치 및 업데이트는 다운로드하기 전에 신뢰를 확인합니다.
버전이 지정된 커뮤니티 아카이브 릴리스는 정확한 릴리스 신뢰 메타데이터를 사용합니다.
리졸버 기반 GitHub 스킬은 ClawHub의 설치 리졸버에 의존하여
고정된 커밋을 반환하기 전에 스캔 및 강제 설치 정책을 적용합니다. 악성 또는
차단된 커뮤니티 릴리스는 거부됩니다. 위험한 커뮤니티 릴리스는
검토가 필요하며, 비대화형 명령이 그 검토 후 계속되어야 하는 경우
--acknowledge-clawhub-risk가 필요합니다. 공식 ClawHub 스킬 게시자와 번들된 OpenClaw 스킬 소스는 이 릴리스 신뢰 프롬프트를 건너뜁니다. --global은 공유 관리형 스킬 디렉터리를 대상으로 하며--agent <id>와 함께 사용할 수 없습니다.--agent <id>는 하나의 구성된 에이전트 워크스페이스를 대상으로 하며 현재 작업 디렉터리 추론을 재정의합니다.update @owner/<slug>는 추적되는 단일 스킬을 업데이트합니다. 워크스페이스 대신 공유 관리형 스킬 디렉터리를 대상으로 하려면--global을 추가하세요.update --all은 선택한 워크스페이스에서 추적되는 ClawHub 설치를 업데이트하거나,--global과 함께 사용하면 공유 관리형 스킬 디렉터리에서 업데이트합니다.verify @owner/<slug>는 기본적으로 ClawHub의clawhub.skill.verify.v1JSON 엔벌로프를 출력합니다. JSON이 이미 기본값이므로--json플래그는 없습니다. 스킬이 이미 설치되어 있거나 모호하지 않은 경우 호환성을 위해 bare 슬러그도 계속 허용되지만, 소유자가 포함된 ref는 게시자 모호성을 피합니다.- ClawHub가 서버에서 확인한 소스 출처를 반환하면, 검증 JSON에는
커밋에 고정된
openclaw.verifiedSourceUrl도 포함됩니다. 사용할 수 없거나 자체 선언된 소스 URL은 원시 출처 엔벌로프에만 남고 승격되지 않습니다. verify는 설치된 ClawHub 스킬에 대해.clawhub/origin.json을 사용하므로 설치된 버전을 해당 스킬이 온 레지스트리에 대해 검증합니다.--version과--tag는 버전 선택기를 재정의하지만, origin 메타데이터가 있으면 해당 설치 레지스트리를 유지합니다.verify --card는 JSON 대신 생성된 스킬 카드 Markdown을 출력합니다. 이 명령은 ClawHub가ok: false또는decision: "fail"을 반환하면 0이 아닌 값으로 종료합니다. 서명되지 않은 서명은 ClawHub 정책이 변경되지 않는 한 정보용입니다.- 설치된 ClawHub 번들에는 생성된
skill-card.md가 포함될 수 있습니다. OpenClaw는 검증을 ClawHub 서버 결정으로 취급하며, 생성된 카드가 번들 지문을 변경한다는 이유만으로 설치된 스킬을 거부하지 않습니다. check --agent <id>는 선택한 에이전트의 워크스페이스를 확인하고 준비된 스킬 중 실제로 해당 에이전트의 프롬프트 또는 명령 표면에 보이는 스킬을 보고합니다.- 하위 명령이 제공되지 않으면
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"관련
Was this useful?
