게시

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

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

Skills

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

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

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

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

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 스타일 패키지 이름을 사용합니다. 범위가 지정된 패키지 이름은 이름의 첫 부분에 소유자를 포함합니다.

@owner/package-name

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

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

ClawHub에서 이미 주장되었거나 예약된 조직, 브랜드, 패키지 스코프, 소유자 핸들 또는 네임스페이스의 정당한 소유자라면 공개 가능한 민감하지 않은 증거와 함께 조직 / 네임스페이스 클레임 이슈를 여세요. 무엇을 포함하고 공개 이슈에서 무엇을 제외해야 하는지는 조직 및 네임스페이스 클레임을 참고하세요.

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 검증 수정을 참고하세요.
• 릴리스를 만들기 전에 clawhub package publish <source> --dry-run을 실행합니다.
• 자동 보안 검사와 검증이 끝날 때까지 새 릴리스가 공개 설치 화면에 표시되지 않을 수 있음을 예상하세요.

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

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

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

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을 사용할 수 있도록 유지하세요.

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

clawhub package trusted-publisher get @owner/package-nameclawhub package trusted-publisher delete @owner/package-name

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

FAQ

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

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

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

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

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

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

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

현재 소유자에 대한 접근 권한은 없지만 조직, 프로젝트 또는 브랜드가 정당한 네임스페이스 소유자라고 판단한다면, 직원 검토를 위해 공개 가능한 민감하지 않은 증거와 함께 조직 / 네임스페이스 클레임 이슈를 여세요. 제출하기 전에 조직 및 네임스페이스 클레임을 참고하세요.

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