게시

게시는 선택한 소유자 명의로 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를 사용합니다.

Plugin

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

@owner/package-name

범위는 선택한 게시 소유자와 일치해야 합니다. 패키지 이름이 @openclaw/dronzer이면 @openclaw 명의로만 게시할 수 있습니다. @vintageayu 명의로 게시하려면 패키지 이름을 @vintageayu/dronzer로 변경합니다.

이는 게시자가 관리하지 않는 조직 네임스페이스를 패키지가 점유하는 것을 방지합니다.

ClawHub에서 이미 점유되었거나 예약된 조직, 브랜드, 패키지 범위, 소유자 핸들 또는 네임스페이스의 정당한 소유자라면 공개 가능한 비민감 증빙 자료와 함께 조직/네임스페이스 소유권 주장 이슈를 개설하세요. 포함할 내용과 공개 이슈에 포함하지 말아야 할 내용은 조직 및 네임스페이스 소유권 주장을 참조하세요.

Plugin 게시 전 준비 사항

• 패키지 범위와 일치하는 소유자를 선택합니다.
• openclaw.plugin.json을 포함합니다. 코드 Plugin에는 openclaw.compat.pluginApi와 openclaw.build.openclawVersion이 있는 package.json도 필요합니다.
• 사용자 지정 Plugin 카드 아이콘을 표시하려면 임의의 HTTPS 이미지 URL을 값으로 하는 icon을 openclaw.plugin.json에 추가합니다.
• 소스 저장소와 정확한 커밋 메타데이터를 포함하거나, CLI가 이를 감지할 수 있도록 GitHub 기반 체크아웃에서 CLI를 사용합니다.
• 게시하기 전에 clawhub package validate <source>를 실행합니다. 패키지, 매니페스트, SDK 가져오기 또는 아티팩트 관련 문제는 Plugin 검증 문제 해결을 참조하세요.
• 릴리스를 생성하기 전에 clawhub package publish <source> --dry-run을 실행합니다.
• 자동 보안 검사와 검증이 끝날 때까지 새 릴리스가 공개 설치 화면에 표시되지 않을 수 있습니다.

패키지의 신뢰할 수 있는 게시

패키지의 신뢰할 수 있는 게시는 두 단계로 설정합니다.

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가 해당 저장소에 접근할 수 있어야 합니다.

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

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

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

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

자주 묻는 질문

패키지 범위는 선택한 소유자와 일치해야 함

패키지 범위와 선택한 소유자가 일치하지 않으면 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 소유자에 접근할 수 있는 게시자만 게시할 수 있습니다.