how-it-works
기준일: 2026-07-26
공식 기준: how-it-works
how-it-works 문서는 OpenClaw 공식 문서(clawhub/how-it-works)를 한국어로 정리한 가이드입니다. How ClawHub listings, versions, installs, publishing, scans, and updates work. 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.
핵심 요약
How ClawHub listings, versions, installs, publishing, scans, and updates work.
한국어 가이드 범위: clawhub/how-it-works 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.
문서 구성
공식 문서의 주요 섹션은 다음과 같습니다.
- How ClawHub Works
- Registry records
- Skills
- 플러그인
- Publishing
- Installs and updates
- Security state
- API access
상세 내용
How ClawHub Works
ClawHub is the registry layer for OpenClaw skills and plugins. It gives users a place to discover packages, gives publishers a place to release versions, and gives OpenClaw enough metadata to install and update those packages safely.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
Registry records
Each public listing is a registry record with:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
주요 항목:
- an owner and slug or package name
- one or more published versions
- metadata, summary, files, and source attribution
- changelog and tag information such as
latest - download, install, and star signals
- security scan and moderation status
Skills
A skill is a versioned text bundle centered on SKILL.md. It can include supporting files, examples, templates, and scripts.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
플러그인
Plugins are packaged OpenClaw extensions. ClawHub stores package metadata, compatibility information, source links, artifacts, and version records.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw plugins install clawhub:<package>
Publishing
Publishing creates a new immutable version record. Publishers use the clawhub CLI for authenticated registry workflows:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
clawhub skill publish ./my-skill
clawhub package publish <source> --family code-plugin --dry-run
clawhub package publish <source> --family code-plugin
Installs and updates
OpenClaw install commands use ClawHub as a package source:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw skills install @openclaw/demo
openclaw plugins install clawhub:<package>
Security state
ClawHub is open to publishing, but releases are still subject to upload gates, automated checks, user reports, and moderator action.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
API access
ClawHub exposes public read APIs for discovery, search, package details, and downloads. Third-party catalogs may use these APIs when they link back to the canonical ClawHub listing, respect rate limits, and avoid implying endorsement.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
실습 체크리스트
- 공식 문서와 로컬 버전을 대조합니다:
https://docs.openclaw.ai/clawhub/how-it-works - 관련 CLI는
openclaw --help및 하위 명령--help로 옵션을 확인합니다. - 설정 변경 시
openclaw config/openclaw doctor로 유효성을 검사합니다. - Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.
자주 쓰는 명령·설정 예시
openclaw plugins install clawhub:<package>
clawhub skill publish ./my-skill
clawhub package publish <source> --family code-plugin --dry-run
clawhub package publish <source> --family code-plugin
openclaw skills install @openclaw/demo
openclaw plugins install clawhub:<package>
관련 링크
이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.