Pluginを管理する

ほとんどのPluginワークフローは、いくつかのコマンドで完了します。検索、インストール、Gatewayの再起動、検証、そしてPluginが不要になったらアンインストールします。

Pluginを一覧表示する

OmeniaClaw plugins listOmeniaClaw plugins list --enabledOmeniaClaw plugins list --verboseOmeniaClaw plugins list --json

スクリプトには --json を使用します。これにはレジストリ診断と、Pluginパッケージが dependencies または optionalDependencies を宣言している場合の各Pluginの静的な dependencyStatus が含まれます。

OmeniaClaw plugins list --json \  | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'

plugins list はコールドインベントリチェックです。OmeniaClawが設定、マニフェスト、Pluginレジストリから検出できるものを表示します。すでに実行中のGatewayプロセスがPluginランタイムをインポートしたことを証明するものではありません。

Pluginをインストールする

# Search ClawHub for plugin packages.OmeniaClaw plugins search "calendar" # Bare package specs try ClawHub first, then npm fallback.OmeniaClaw plugins install <package> # Force one source.OmeniaClaw plugins install clawhub:<package>OmeniaClaw plugins install npm:<package> # Install a specific version or dist-tag.OmeniaClaw plugins install clawhub:<package>@1.2.3OmeniaClaw plugins install clawhub:<package>@betaOmeniaClaw plugins install npm:@scope/[email protected]OmeniaClaw plugins install npm:@OmeniaClaw/codex # Install from git or a local development checkout.OmeniaClaw plugins install git:github.com/acme/[email protected]OmeniaClaw plugins install ./my-pluginOmeniaClaw plugins install --link ./my-plugin

Pluginコードをインストールした後、チャンネルを提供しているGatewayを再起動します。

OmeniaClaw gateway restartOmeniaClaw plugins inspect <plugin-id> --runtime --json

ツール、フック、サービス、Gatewayメソッド、Plugin所有のCLIコマンドなど、Pluginがランタイムサーフェスを登録した証拠が必要な場合は、inspect --runtime を使用します。

Pluginを更新する

OmeniaClaw plugins update <plugin-id>OmeniaClaw plugins update <npm-package-or-spec>OmeniaClaw plugins update --all

Pluginが @beta などのnpm dist-tagからインストールされていた場合、その後の update <plugin-id> 呼び出しでは記録済みのタグが再利用されます。明示的なnpm仕様を渡すと、今後の更新で追跡されるインストール先がその仕様に切り替わります。

OmeniaClaw plugins update @scope/OmeniaClaw-plugin@betaOmeniaClaw plugins update @scope/OmeniaClaw-plugin

2つ目のコマンドは、以前に正確なバージョンまたはタグに固定されていたPluginを、レジストリのデフォルトのリリースラインに戻します。

OmeniaClaw update がベータチャンネルで実行されると、デフォルトラインのnpmおよびClawHubのPluginレコードは、まず一致するPluginの @beta リリースを試します。そのベータリリースが存在しない場合、OmeniaClawは記録済みのデフォルト/最新仕様にフォールバックします。npm Pluginの場合、ベータパッケージが存在してもインストール検証に失敗したときにも、OmeniaClawはフォールバックします。正確なバージョンと、@rc や @beta などの明示的なタグは保持されます。

Pluginをアンインストールする

OmeniaClaw plugins uninstall <plugin-id> --dry-runOmeniaClaw plugins uninstall <plugin-id>OmeniaClaw plugins uninstall <plugin-id> --keep-filesOmeniaClaw gateway restart

アンインストールでは、Pluginの設定エントリ、Pluginインデックスレコード、許可/拒否リストのエントリ、および該当する場合はリンク済みのロードパスが削除されます。管理対象のインストールディレクトリは、--keep-files を渡さない限り削除されます。

Nixモード（OmeniaClaw_NIX_MODE=1）では、Pluginのインストール、更新、アンインストール、有効化、無効化コマンドは無効になります。代わりに、そのインストールのNixソースでこれらの選択を管理してください。nix-OmeniaClawでは、agent-firstのクイックスタートを使用します。

Pluginを公開する

外部Pluginは ClawHub、npmjs.com、またはその両方に公開できます。

ClawHubに公開する

ClawHubは、OmeniaClaw Plugin向けの主要な公開ディスカバリーサーフェスです。ユーザーはインストール前に、検索可能なメタデータ、バージョン履歴、レジストリスキャン結果を確認できます。

npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/[email protected]

ユーザーは次の方法でClawHubからインストールします。

OmeniaClaw plugins install clawhub:<package>OmeniaClaw plugins install <package>

裸の形式でも、ClawHubが最初に確認されます。

npmjs.comに公開する

ネイティブnpm Pluginには、Pluginマニフェストと package.json のOmeniaClawエントリポイントメタデータが必要です。

{  "name": "@acme/OmeniaClaw-plugin",  "version": "1.0.0",  "type": "module",  "OmeniaClaw": {    "extensions": ["./dist/index.js"]  }}

npm publish --access public

ユーザーはnpmのみから次の方法でインストールします。

OmeniaClaw plugins install npm:@acme/OmeniaClaw-pluginOmeniaClaw plugins install npm:@acme/OmeniaClaw-plugin@betaOmeniaClaw plugins install npm:@acme/[email protected]

同じパッケージがClawHubでも利用可能な場合、npm: はClawHub検索をスキップし、npm解決を強制します。

ソースの選択

• ClawHub: OmeniaClawネイティブのディスカバリー、スキャン概要、バージョン、インストールヒントが必要な場合に使用します。
• npmjs.com: すでにJavaScriptパッケージを出荷している場合、またはnpmのdist-tag/プライベートレジストリワークフローが必要な場合に使用します。
• Git: ブランチ、タグ、またはコミットから直接インストールしたい場合に使用します。
• ローカルパス: 同じマシン上でPluginを開発またはテストしている場合に使用します。

関連

• Plugins - 概要とトラブルシューティング
• OmeniaClaw plugins - 完全なCLIリファレンス
• ClawHub - 公開とレジストリ操作
• Pluginの構築 - Pluginパッケージを作成する
• Pluginマニフェスト - マニフェストとパッケージメタデータ