ClawHub

ClawHub는 게시된 Skills와 Plugin 릴리스에 대해 자동 보안 검사를 실행합니다. 공개 상세 페이지는 현재 결과를 요약하고, 스캐너 행은 VirusTotal, ClawScan, 정적 분석 전용 상세 페이지로 연결됩니다.

스캔 보류 또는 차단된 릴리스는 공개 카탈로그와 설치 화면에서 사용할 수 없을 수 있지만, 소유자는 /dashboard에서 계속 볼 수 있습니다.

• 로그인한 모든 사용자는 Skill을 보고할 수 있습니다.
• 보고 사유는 필수이며 기록됩니다.
• 각 사용자는 한 번에 최대 20개의 활성 보고를 가질 수 있습니다.
• 고유 보고가 3개를 초과하는 Skills는 기본적으로 자동 숨김 처리됩니다.

• 모더레이터는 숨겨진 Skills를 보고, 숨김을 해제하고, 삭제하거나 사용자를 차단할 수 있습니다.
• 보고 기능을 악용하면 계정 차단으로 이어질 수 있습니다.
• 모더레이터가 되는 데 관심이 있나요? OpenClaw Discord에서 문의하고 모더레이터 또는 유지관리자에게 연락하세요.

clawhub login              # browser flow
clawhub login --token <token>
clawhub logout
clawhub whoami

로그인 옵션:

• --token <token> - API 토큰을 붙여넣습니다.
• --label <label> - 브라우저 로그인 토큰에 저장되는 레이블(기본값: CLI token).
• --no-browser - 브라우저를 열지 않습니다(--token 필요).

clawhub search "query"

Skills를 검색합니다. Plugin/패키지 발견에는 clawhub package explore를 사용하세요.

• --limit <n> - 최대 결과 수.

clawhub package explore --family code-plugin
clawhub package explore "episodic-claw" --family code-plugin
clawhub package inspect episodic-claw

package explore와 package inspect는 Plugin/패키지 발견 및 메타데이터 검사를 위한 ClawHub CLI 화면입니다. 네이티브 OpenClaw 설치는 계속 openclaw plugins install clawhub:<package>를 사용합니다.

옵션:

• --family skill|code-plugin|bundle-plugin - 패키지 패밀리를 필터링합니다.
• --official - 공식 패키지만 표시합니다.
• --executes-code - 코드를 실행하는 패키지만 표시합니다.
• --version <version> / --tag <tag> - 특정 패키지 버전을 검사합니다.
• --versions, --files, --file <path> - 패키지 기록과 파일을 검사합니다.
• --json - 기계 판독 가능 출력.

clawhub install <slug>
clawhub update <slug>
clawhub update --all
clawhub list

옵션:

• --version <version> - 특정 버전으로 설치 또는 업데이트합니다(update에서는 단일 slug만).
• --force - 폴더가 이미 있거나 로컬 파일이 게시된 어떤 버전과도 일치하지 않을 때 덮어씁니다.
• clawhub list는 .clawhub/lock.json을 읽습니다.

clawhub skill publish <path>

옵션:

• --slug <slug> - Skill slug.
• --name <name> - 표시 이름.
• --version <version> - semver 버전.
• --changelog <text> - 변경 로그 텍스트(비워 둘 수 있음).
• --tags <tags> - 쉼표로 구분된 태그(기본값: latest).

clawhub package publish <source>

<source>는 로컬 폴더, owner/repo, owner/repo@ref 또는 GitHub URL일 수 있습니다.

옵션:

• --dry-run - 아무것도 업로드하지 않고 정확한 게시 계획을 빌드합니다.
• --json - CI용 기계 판독 가능 출력을 내보냅니다.
• --source-repo, --source-commit, --source-ref - 자동 감지가 충분하지 않을 때 사용하는 선택적 재정의.

clawhub skill rescan <slug>
clawhub skill rescan <slug> --yes --json

clawhub package rescan <name>
clawhub package rescan <name> --yes --json

재스캔 명령에는 로그인한 소유자 토큰이 필요하며 최신 게시된 Skill 버전 또는 Plugin 릴리스를 대상으로 합니다. 비대화형 실행에서는 --yes를 전달하세요.

JSON 응답에는 대상 종류, 이름, 버전, 재스캔 상태, 해당 버전 또는 릴리스의 남은/최대 요청 수가 포함됩니다.

clawhub delete <slug> --yes
clawhub undelete <slug> --yes

clawhub sync

옵션:

• --root <dir...> - 추가 스캔 루트.
• --all - 프롬프트 없이 모든 항목을 업로드합니다.
• --dry-run - 업로드될 내용을 표시합니다.
• --bump <type> - 업데이트에 사용할 patch|minor|major(기본값: patch).
• --changelog <text> - 비대화형 업데이트용 변경 로그.
• --tags <tags> - 쉼표로 구분된 태그(기본값: latest).
• --concurrency <n> - 레지스트리 검사(기본값: 4).

• 게시할 때마다 새 semver SkillVersion이 생성됩니다.
• 태그(예: latest)는 버전을 가리킵니다. 태그를 이동하면 롤백할 수 있습니다.
• 변경 로그는 버전별로 첨부되며, 업데이트를 동기화하거나 게시할 때 비어 있을 수 있습니다.

업데이트는 콘텐츠 해시를 사용해 로컬 skill 콘텐츠를 registry 버전과 비교합니다. 로컬 파일이 게시된 어떤 버전과도 일치하지 않으면 CLI는 덮어쓰기 전에 확인을 요청합니다(또는 비대화형 실행에서는 --force가 필요합니다).

clawhub sync는 먼저 현재 작업 디렉터리를 스캔합니다. skill을 찾지 못하면 알려진 레거시 위치(예: ~/openclaw/skills 및 ~/.openclaw/skills)로 폴백합니다. 이는 추가 플래그 없이 이전 skill 설치를 찾도록 설계되었습니다.

• 설치된 skill은 작업 디렉터리 아래 .clawhub/lock.json에 기록됩니다.
• 인증 토큰은 ClawHub CLI 설정 파일에 저장됩니다(CLAWHUB_CONFIG_PATH로 재정의).

로그인한 상태에서 clawhub sync를 실행하면 CLI는 설치 횟수를 계산하기 위해 최소한의 스냅샷을 보냅니다. 이를 완전히 비활성화할 수 있습니다.

export CLAWHUB_DISABLE_TELEMETRY=1