---
read_when:
    - Skills 또는 Plugin 게시하기
    - 소유자 또는 패키지 범위 오류 디버깅
    - 게시 UI, CLI 또는 백엔드 동작 추가
summary: Skills, Plugin, 소유자, 범위, 릴리스, 검토에 대한 ClawHub 게시 작동 방식.
x-i18n:
    generated_at: "2026-06-27T17:15:25Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 5c0270c0bc3316d970feddfc689c1125e1c90a62beeb40d8098dc6a6752cfa70
    source_path: clawhub/publishing.md
    workflow: 16
---

# 게시

게시하면 선택한 소유자 아래의 Skills 폴더 또는 Plugin 패키지가 ClawHub로 전송됩니다. ClawHub는 토큰이 해당 소유자로 게시할 수 있는지 확인하고, 메타데이터, 이름, 버전, 파일, 소스 정보를 검증한 다음 릴리스를 저장하고 자동 보안 검사를 시작합니다.

검증에 실패하면 아무것도 게시되지 않습니다. 새 릴리스는 검토가 완료될 때까지 일반 설치 및 다운로드 화면에 표시되지 않을 수도 있습니다.

## Skills

가장 간단한 게시 경로는 CLI입니다. 로그인한 다음 로컬 Skills 폴더를 게시합니다.

```bash
clawhub login
clawhub skill publish ./my-skill \
  --slug my-skill \
  --name "My Skill" \
  --owner <owner>
```

조직 소유자로 게시할 때는 `--owner <handle>`을 사용합니다. 인증된 사용자로 게시하려면 생략합니다. 게시 시 변경되지 않은 콘텐츠는 건너뜁니다. 새 Skills는 `1.0.0`에서 시작하며, 이후 변경 사항은 자동으로 다음 패치 버전으로 게시됩니다. 명시적 버전이 필요할 때만 `--version`을 전달합니다.

카탈로그 저장소의 경우 ClawHub의 재사용 가능한 [`skill-publish.yml` 워크플로](https://github.com/openclaw/clawhub/blob/main/.github/workflows/skill-publish.yml)를 사용합니다. 이 워크플로는 `root` 아래의 각 직계 Skills 폴더(기본값: `skills`) 또는 `skill_path`로 제공된 폴더에 대해서만 `skill publish`를 호출합니다.

```yaml
jobs:
  publish:
    uses: openclaw/clawhub/.github/workflows/skill-publish.yml@main
    with:
      owner: <owner>
      dry_run: false
    secrets:
      clawhub_token: ${{ secrets.CLAWHUB_TOKEN }}
```

게시하지 않고 새 Skills와 변경된 Skills를 미리 보려면 `dry_run: true`를 사용합니다.

## Plugins

Plugins는 npm 스타일 패키지 이름을 사용합니다. 범위가 지정된 패키지 이름은 이름의 첫 부분에 소유자를 포함합니다.

```text
@owner/package-name
```

스코프는 선택한 게시 소유자와 일치해야 합니다. 패키지 이름이 `@openclaw/dronzer`이면 `@openclaw`로만 게시할 수 있습니다. `@vintageayu`로 게시하려면 패키지 이름을 `@vintageayu/dronzer`로 바꾸세요.

이렇게 하면 게시자가 제어하지 않는 조직 네임스페이스를 패키지가 주장하지 못하게 됩니다.

ClawHub에서 이미 주장되었거나 예약된 조직, 브랜드, 패키지 스코프, 소유자 핸들 또는 네임스페이스의 정당한 소유자라면 공개 가능한 민감하지 않은 증거와 함께 [조직 / 네임스페이스 클레임 이슈](https://github.com/openclaw/clawhub/issues/new?template=org-namespace-claim.yml)를 여세요. 무엇을 포함하고 공개 이슈에서 무엇을 제외해야 하는지는 [조직 및 네임스페이스 클레임](/ko/clawhub/namespace-claims)을 참고하세요.

### Plugin 게시 전

- 패키지 스코프와 일치하는 소유자를 선택합니다.
- `openclaw.plugin.json`을 포함합니다. 코드 Plugins에는 `openclaw.compat.pluginApi`와 `openclaw.build.openclawVersion`이 포함된 `package.json`도 필요합니다.
- 사용자 지정 Plugin 카드 아이콘을 표시하려면 HTTPS 이미지 URL을 `icon`으로 `openclaw.plugin.json`에 추가합니다.
- 소스 저장소와 정확한 커밋 메타데이터를 포함하거나, GitHub 기반 체크아웃에서 CLI를 사용해 자동 감지할 수 있게 합니다.
- 게시하기 전에 `clawhub package validate <source>`를 실행합니다. 패키지, 매니페스트, SDK 가져오기 또는 아티팩트 관련 발견 사항은 [Plugin 검증 수정](/ko/clawhub/plugin-validation-fixes)을 참고하세요.
- 릴리스를 만들기 전에 `clawhub package publish <source> --dry-run`을 실행합니다.
- 자동 보안 검사와 검증이 끝날 때까지 새 릴리스가 공개 설치 화면에 표시되지 않을 수 있음을 예상하세요.

### 패키지에 대한 신뢰할 수 있는 게시

패키지 신뢰할 수 있는 게시는 2단계 설정입니다.

1. 일반 수동 또는 토큰 인증 `clawhub package publish`를 통해 패키지를 한 번 게시합니다. 이렇게 하면 패키지 행이 생성되고, 신뢰할 수 있는 게시자 구성을 변경할 수 있는 패키지 관리자가 설정됩니다.
2. 패키지 관리자가 GitHub Actions 신뢰할 수 있는 게시자 구성을 설정합니다.

```bash
clawhub package trusted-publisher set @owner/package-name \
  --repository owner/repo \
  --workflow-filename package-publish.yml
```

구성이 설정되면, 향후 지원되는 GitHub Actions 게시에서는 저장소에 장기 ClawHub 토큰을 저장하지 않고 OIDC/신뢰할 수 있는 게시를 사용할 수 있습니다. 구성된 저장소와 워크플로 파일 이름은 GitHub Actions OIDC 클레임과 일치해야 합니다. `--environment <name>`도 전달하면 GitHub Actions 환경 클레임이 해당 이름과 정확히 일치해야 합니다.

ClawHub는 신뢰할 수 있는 게시자 구성이 설정될 때 구성된 GitHub 저장소를 검증합니다. 공개 저장소는 공개 GitHub 메타데이터를 통해 검증할 수 있습니다. 비공개 저장소는 향후 ClawHub GitHub App 설치 또는 다른 승인된 GitHub 통합 등을 통해 ClawHub가 해당 저장소에 대한 GitHub 접근 권한을 가져야 합니다.

현재 재사용 가능한 패키지 게시 워크플로는 `id-token: write`를 사용할 수 있을 때 `workflow_dispatch` 게시에 대해 시크릿 없는 신뢰할 수 있는 게시를 지원합니다. 태그 푸시 실제 게시에는 여전히 `clawhub_token`이 필요하므로, 태그 릴리스, 최초 게시, 신뢰할 수 없는 패키지 또는 비상 게시를 위해 `CLAWHUB_TOKEN`을 사용할 수 있도록 유지하세요.

다음으로 구성을 확인하거나 제거합니다.

```bash
clawhub package trusted-publisher get @owner/package-name
clawhub package trusted-publisher delete @owner/package-name
```

신뢰할 수 있는 게시자 구성을 삭제하는 것이 롤백 경로입니다. 패키지 관리자가 구성을 다시 설정할 때까지 향후 신뢰할 수 있는 게시 토큰 발급이 비활성화됩니다.

## FAQ

### 패키지 스코프는 선택한 소유자와 일치해야 합니다

패키지 스코프와 선택한 소유자가 일치하지 않으면 ClawHub가 게시를 거부합니다.

```text
Package scope "@openclaw" must match selected owner "@vintageayu".
Publish as "@openclaw" or rename this package to "@vintageayu/dronzer".
```

수정하려면 패키지 스코프가 가리키는 소유자를 선택하거나, 게시할 수 있는 소유자와 스코프가 일치하도록 패키지 이름을 바꾸세요.

패키지 이름에 이미 올바른 스코프가 있지만 패키지를 잘못된 게시자가 소유하고 있다면 대신 소유권을 이전하세요.

```sh
clawhub package transfer @opik/opik-openclaw --to opik
```

현재 소유자와 대상 게시자 모두에 대한 관리자 접근 권한이 있을 때만 패키지 또는 Skills 이전을 사용하세요. 패키지 이전으로는 관리할 수 없는 스코프에 게시할 수 없습니다.

현재 소유자에 대한 접근 권한은 없지만 조직, 프로젝트 또는 브랜드가 정당한 네임스페이스 소유자라고 판단한다면, 직원 검토를 위해 공개 가능한 민감하지 않은 증거와 함께 [조직 / 네임스페이스 클레임 이슈](https://github.com/openclaw/clawhub/issues/new?template=org-namespace-claim.yml)를 여세요. 제출하기 전에 [조직 및 네임스페이스 클레임](/ko/clawhub/namespace-claims)을 참고하세요.

이는 조직 네임스페이스를 보호합니다. `@openclaw/dronzer`라는 패키지는 `@openclaw` 네임스페이스를 주장하므로, `@openclaw` 소유자에 접근할 수 있는 게시자만 게시할 수 있습니다.