Skip to main content

​
公開

公開すると、選択した所有者の配下にある ClawHub へ Skills フォルダーまたは Plugin パッケージが送信されます。ClawHub は、トークンにその所有者として公開する権限があることを確認し、メタデータ、名前、バージョン、ファイル、ソース情報を検証してから、リリースを保存して自動セキュリティチェックを開始します。 検証に失敗した場合、何も公開されません。また、新しいリリースは、レビューが完了するまで通常のインストールおよびダウンロード画面に表示されないことがあります。

​
Skills

最も簡単な公開方法は CLI です。サインインしてから、ローカルの Skills フォルダーを公開します。
組織の所有者として公開する場合は --owner <handle> を使用します。認証済みユーザーとして公開する場合は省略します。変更されていないコンテンツは公開時にスキップされます。新しい Skills は 1.0.0 から始まり、それ以降の変更では次のパッチバージョンが自動的に公開されます。明示的なバージョンが必要な場合にのみ --version を渡します。 カタログリポジトリでは、ClawHub の再利用可能な skill-publish.yml ワークフロー を使用します。このワークフローは、root（デフォルト: skills）直下の各 Skills フォルダー、または skill_path として指定されたフォルダーのみを対象に、skill publish を呼び出します。
公開せずに新規および変更済みの Skills をプレビューするには、dry_run: true を使用します。

​
Plugin

Plugin では npm 形式のパッケージ名を使用します。スコープ付きパッケージ名では、名前の先頭部分に所有者が含まれます。
スコープは、選択した公開所有者と一致する必要があります。パッケージ名が @openclaw/dronzer の場合、@openclaw としてのみ公開できます。@vintageayu として公開する場合は、パッケージ名を @vintageayu/dronzer に変更します。 これにより、公開者が管理していない組織の名前空間をパッケージが取得することを防ぎます。 ClawHub 上ですでに取得または予約されている組織、ブランド、パッケージスコープ、所有者ハンドル、名前空間の正当な所有者である場合は、公開可能な機密性のない証明を添えて 組織／名前空間の取得申請 Issue を作成してください。記載する内容と公開 Issue に含めない内容については、 組織と名前空間の取得申請を参照してください。

​
Plugin を公開する前に

  • パッケージスコープと一致する所有者を選択します。
  • openclaw.plugin.json を含めます。コード Plugin には、openclaw.compat.pluginApi および openclaw.build.openclawVersion を指定した package.json も必要です。
  • ホームページおよび Plugin 一覧ページにカスタムの 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 の信頼済み公開者を設定します。
設定後は、今後サポートされる 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 は公開を拒否します。
修正するには、パッケージスコープで指定された所有者を選択するか、公開に使用できる所有者とスコープが一致するようにパッケージ名を変更します。 パッケージ名のスコープがすでに正しくても、誤った公開者がパッケージを所有している場合は、代わりに所有権を移管します。
パッケージまたは Skills の移管は、現在の所有者と移管先の公開者の両方に対する管理者アクセス権がある場合にのみ使用してください。パッケージを移管しても、管理できないスコープへ公開できるようにはなりません。 現在の所有者へのアクセス権がないものの、自分の組織、プロジェクト、またはブランドが正当な名前空間の所有者であると考える場合は、スタッフによるレビューのため、公開可能な機密性のない証明を添えて 組織／名前空間の取得申請 Issue を作成してください。申請前に 組織と名前空間の取得申請を参照してください。 これにより、組織の名前空間が保護されます。@openclaw/dronzer という名前のパッケージは @openclaw 名前空間を取得するため、@openclaw 所有者へのアクセス権がある公開者だけが公開できます。