ClawHub: OpenClaw 에이전트 기능 확장 및 스킬 설치 가이드

에이전트를 개발하다 보면 새로운 기능을 추가하거나 관리하는 게 꽤 번거로울 때가 많죠. 매번 코드를 직접 짜거나 복사해서 붙여넣는 대신, 누군가 만들어 놓은 유용한 기능을 바로 가져다 쓸 수 있다면 얼마나 편할까요?

ClawHub은 바로 이런 고민을 해결해 주는 공간이에요. OpenClaw 에이전트의 능력을 확장하고 관리하는 과정을 훨씬 단순하게 만들어 줍니다.

ClawHub

ClawHub은 OpenClaw skills 및 plugins를 위한 공개 registry예요.

• openclaw 기본 명령어를 사용해서 ClawHub에 있는 skills를 검색, 설치, 업데이트하거나 plugins를 설치할 수 있어요.
• registry 인증, publish, delete, undelete 또는 sync 워크플로우가 필요할 때는 별도의 clawhub CLI를 사용하면 돼요.

사이트: clawhub.ai

OpenClaw 기본 워크플로우

Skills:

openclaw skills search "calendar"
openclaw skills install <skill-slug>
openclaw skills update --all

Plugins:

openclaw plugins install clawhub:<package>
openclaw plugins update --all

npm 전용 plugin 사양도 npm보다 ClawHub에서 먼저 확인을 시도해요:

openclaw plugins install openclaw-codex-app-server

기본 openclaw 명령어는 현재 활성화된 workspace에 설치하며, 소스 metadata를 유지하기 때문에 나중에 update를 실행해도 ClawHub 상태를 유지할 수 있어요.

ClawHub이란 무엇인가요?

• OpenClaw skills 및 plugins를 위한 공개 registry예요.
• skill bundle과 metadata를 버전별로 저장하는 저장소예요.
• 검색, tags, 사용량 신호 등을 통해 새로운 기능을 발견하는 공간이에요.

작동 방식

1. 사용자가 skill bundle(파일 + metadata)을 publish 해요.
2. ClawHub이 bundle을 저장하고, metadata를 분석한 뒤 버전을 할당해요.
3. registry가 검색과 발견이 가능하도록 해당 skill의 색인을 생성해요.
4. 사용자는 OpenClaw에서 skills를 찾아보고, 다운로드하고, 설치해요.

할 수 있는 일

• 새로운 skills나 기존 skill의 새 버전을 publish 할 수 있어요.
• 이름, tags, 검색을 통해 skills를 찾을 수 있어요.
• skill bundle을 다운로드하고 내부 파일을 확인할 수 있어요.
• 악성이거나 안전하지 않은 skills를 신고할 수 있어요.
• 관리자라면 숨기기, 숨기기 해제, 삭제 또는 차단 기능을 사용할 수 있어요.

대상 (초보자 친화적)

OpenClaw 에이전트에 새로운 기능을 추가하고 싶다면, ClawHub이 skills를 찾고 설치하는 가장 쉬운 방법이에요. 백엔드가 어떻게 돌아가는지 몰라도 괜찮아요. 다음과 같은 일을 할 수 있거든요:

• 일상적인 언어로 skills를 검색해요.
• workspace에 skill을 설치해요.
• 나중에 명령어 하나로 skills를 업데이트해요.
• 직접 만든 skills를 publish 해서 백업해요.

빠른 시작 (비기술자용)

1. 필요한 기능을 검색해 보세요:
   • openclaw skills search "calendar"
2. skill을 설치하세요:
   • openclaw skills install <skill-slug>
3. 새로운 skill을 적용하기 위해 OpenClaw 세션을 새로 시작하세요.
4. 만약 publish를 하거나 registry 인증을 관리하고 싶다면, 별도의 clawhub CLI도 설치해 보세요.

ClawHub CLI 설치하기

publish나 sync처럼 registry 인증이 필요한 워크플로우에서만 이 CLI가 필요해요:

npm i -g clawhub

pnpm add -g clawhub

OpenClaw와의 연동 방식

기본 openclaw skills install은 활성화된 workspace의 skills/ 디렉토리에 설치돼요. openclaw plugins install clawhub:...은 일반적인 관리형 plugin 설치와 함께 업데이트를 위한 ClawHub 소스 metadata를 기록해요.

별도의 clawhub CLI도 현재 작업 디렉토리 아래의 ./skills에 skills를 설치해요. 만약 OpenClaw workspace가 설정되어 있다면, --workdir(또는 CLAWHUB_WORKDIR)로 덮어쓰지 않는 한 clawhub은 해당 workspace를 우선적으로 사용해요. OpenClaw는 <workspace>/skills에서 workspace skills를 로드하며, 다음 세션부터 이를 인식해요. 이미 ~/.openclaw/skills나 내장된 skills를 사용 중이라면, workspace skills가 우선순위를 가져요.

skills가 어떻게 로드되고 공유되며 제어되는지에 대한 자세한 내용은 Skills 문서를 참고해 주세요.

스킬 시스템 개요

skill은 OpenClaw에게 특정 작업을 수행하는 방법을 가르치는 파일들의 버전 관리된 bundle이에요. publish 할 때마다 새로운 버전이 생성되며, registry는 사용자가 변경 사항을 감사할 수 있도록 버전 기록을 유지해요.

일반적인 skill에는 다음이 포함돼요:

• 주요 설명과 사용법이 담긴 SKILL.md 파일.
• skill에서 사용하는 선택적인 configs, scripts 또는 지원 파일들.
• tags, 요약, 설치 요구 사항과 같은 metadata.

ClawHub은 metadata를 활용해 검색 기능을 강화하고 skill의 기능을 안전하게 노출해요. 또한 registry는 별점이나 다운로드 같은 사용량 신호를 추적해서 랭킹과 가시성을 개선해요.

제공 서비스 (기능)

• skills와 SKILL.md 내용의 공개 브라우징.
• 키워드뿐만 아니라 embedding(vector search) 기반의 검색.
• semver, changelogs, tags(latest 포함)를 통한 버전 관리.
• 버전별 zip 파일 다운로드.
• 커뮤니티 피드백을 위한 별점 및 댓글.
• 승인 및 감사를 위한 운영(Moderation) 훅.
• 자동화와 스크립팅을 위한 CLI 친화적인 API.

보안 및 운영 정책

ClawHub은 기본적으로 개방되어 있어요. 누구나 skills를 업로드할 수 있지만, publish를 하려면 GitHub 계정이 생성된 지 최소 일주일이 지나야 해요. 이는 정상적인 기여자를 막지 않으면서도 악용 사례를 늦추는 데 도움이 돼요.

신고 및 운영:

• 로그인한 사용자라면 누구나 skill을 신고할 수 있어요.
• 신고 사유는 필수이며 기록으로 남아요.
• 각 사용자는 한 번에 최대 20개의 활성 신고를 가질 수 있어요.
• 서로 다른 사용자로부터 3개 이상의 신고를 받은 skill은 기본적으로 자동 숨김 처리돼요.
• 관리자는 숨겨진 skills를 확인하고, 숨김 해제, 삭제 또는 사용자를 차단할 수 있어요.
• 신고 기능을 악용하면 계정이 차단될 수 있어요.

운영자가 되고 싶으신가요? OpenClaw Discord에서 관리자나 유지보수 담당자에게 문의해 주세요.

CLI 명령어 및 파라미터

전역 옵션 (모든 명령어에 적용):

• --workdir <dir>: 작업 디렉토리 (기본값: 현재 디렉토리, OpenClaw workspace로 대체 가능).
• --dir <dir>: workdir 기준 skills 디렉토리 (기본값: skills).
• --site <url>: 사이트 기본 URL (브라우저 로그인용).
• --registry <url>: Registry API 기본 URL.
• --no-input: 프롬프트 비활성화 (비대화형 모드).
• -V, --cli-version: CLI 버전 출력.

인증:

• clawhub login (브라우저 흐름) 또는 clawhub login --token <token>
• clawhub logout
• clawhub whoami

옵션:

• --token <token>: API 토큰 입력.
• --label <label>: 브라우저 로그인 토큰에 저장될 라벨 (기본값: CLI token).
• --no-browser: 브라우저를 열지 않음 (--token 필요).

검색:

• clawhub search "query"
• --limit <n>: 최대 결과 수.

설치:

• clawhub install <slug>
• --version <version>: 특정 버전 설치.
• --force: 폴더가 이미 존재할 경우 덮어쓰기.

업데이트:

• clawhub update <slug>
• clawhub update --all
• --version <version>: 특정 버전으로 업데이트 (단일 slug만 가능).
• --force: 로컬 파일이 publish 된 어떤 버전과도 일치하지 않을 때 덮어쓰기.

목록 확인:

• clawhub list (.clawhub/lock.json 읽기)

Skills Publish:

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

Plugins Publish:

• clawhub package publish <source>
• <source>는 로컬 폴더, owner/repo, owner/repo@ref 또는 GitHub URL이 될 수 있어요.
• --dry-run: 아무것도 업로드하지 않고 정확한 publish 계획만 생성해요.
• --json: CI를 위해 기계 읽기 가능한 출력 생성.
• --source-repo, --source-commit, --source-ref: 자동 감지가 충분하지 않을 때 사용하는 선택적 덮어쓰기 옵션.

삭제/삭제 취소 (소유자/관리자 전용):

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

Sync (로컬 skills 스캔 + 신규/업데이트 publish):

• clawhub sync
• --root <dir...>: 추가 스캔 루트.
• --all: 프롬프트 없이 모두 업로드.
• --dry-run: 업로드될 내용을 미리 확인.
• --bump <type>: 업데이트 시 patch|minor|major 선택 (기본값: patch).
• --changelog <text>: 비대화형 업데이트를 위한 변경 로그.
• --tags <tags>: 쉼표로 구분된 tags (기본값: latest).
• --concurrency <n>: Registry 확인 동시성 (기본값: 4).

에이전트를 위한 일반적인 워크플로우

Skills 검색

clawhub search "postgres backups"

새로운 Skills 다운로드

clawhub install my-skill-pack

설치된 Skills 업데이트

clawhub update --all

Skills 백업 (publish 또는 sync)

단일 skill 폴더의 경우:

clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest

여러 skills를 한 번에 스캔하고 백업하려면:

clawhub sync --all

GitHub에서 Plugin Publish 하기

clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
clawhub package publish your-org/your-plugin@v1.0.0
clawhub package publish https://github.com/your-org/your-plugin

코드 plugins는 package.json에 필수 OpenClaw metadata를 포함해야 해요:

{
  "name": "@myorg/openclaw-my-plugin",
  "version": "1.0.0",
  "type": "module",
  "openclaw": {
    "extensions": ["./index.ts"],
    "compat": {
      "pluginApi": ">=2026.3.24-beta.2",
      "minGatewayVersion": "2026.3.24-beta.2"
    },
    "build": {
      "openclawVersion": "2026.3.24-beta.2",
      "pluginSdkVersion": "2026.3.24-beta.2"
    }
  }
}

고급 상세 정보 (기술적 내용)

버전 관리와 Tags

• publish 할 때마다 새로운 semver SkillVersion이 생성돼요.
• Tags(latest 등)는 특정 버전을 가리키며, tags를 이동시켜서 롤백을 할 수도 있어요.
• 변경 로그는 버전별로 첨부되며, sync나 업데이트 publish 시에는 비워둘 수 있어요.

로컬 변경 사항 vs Registry 버전

업데이트 시에는 content hash를 사용해서 로컬 skill 내용과 registry 버전을 비교해요. 로컬 파일이 publish 된 어떤 버전과도 일치하지 않으면, CLI는 덮어쓰기 전에 확인을 요청해요(비대화형 실행 시에는 --force 필요).

Sync 스캔 및 Fallback 루트

clawhub sync는 현재 workdir을 먼저 스캔해요. 만약 skills를 찾지 못하면 알려진 레거시 위치(예: ~/openclaw/skills 및 ~/.openclaw/skills)를 확인해요. 이는 추가 flags 없이도 오래된 skill 설치본을 찾을 수 있도록 설계되었어요.

저장소 및 Lockfile

• 설치된 skills는 workdir 아래의 .clawhub/lock.json에 기록돼요.
• 인증 토큰은 ClawHub CLI 설정 파일에 저장돼요 (CLAWHUB_CONFIG_PATH로 변경 가능).

Telemetry (설치 횟수)

로그인 상태에서 clawhub sync를 실행하면, CLI는 설치 횟수 집계를 위해 최소한의 스냅샷을 전송해요. 이 기능은 완전히 끌 수 있어요:

export CLAWHUB_DISABLE_TELEMETRY=1

환경 변수

• CLAWHUB_SITE: 사이트 URL을 덮어씁니다.
• CLAWHUB_REGISTRY: registry API URL을 덮어씁니다.
• CLAWHUB_CONFIG_PATH: CLI가 토큰/설정을 저장하는 위치를 변경합니다.
• CLAWHUB_WORKDIR: 기본 작업 디렉토리를 변경합니다.
• CLAWHUB_DISABLE_TELEMETRY=1: sync 실행 시 telemetry를 비활성화합니다.

---

다음 단계:

• Skills 상세 가이드에서 스킬 로딩 방식 알아보기
• AI Setup Assistant를 통해 설정 도움받기