メインコンテンツへ移動
AIチュートリアル

OpenClaw、Hermes、Claude Code、Cursorでgenspark-clawエージェントスキルをインストールして使う方法

genspark-clawのインストール方法、同梱スキルの確認方法、対応するエージェントランタイムへのデプロイ方法、MCPサーバーの使い方、カスタムスキルの検証方法、プログラムからプロジェクトを操作する方法を解説します。

約13分で読了
OpenClaw、Hermes、Claude Code、Cursorでgenspark-clawエージェントスキルをインストールして使う方法

genspark-clawとは？

genspark-clawは、Genspark Claw、OpenClaw、Hermes、Claude Code、Cursor向けの、コミュニティによって構築されたスキルパック兼コマンドラインインターフェースです。互換性のあるAIエージェントに実用的な機能を追加する、読みやすい5つのSKILL.mdワークフローを提供します。実行時の依存関係やビルド手順は必要ありません。

このプロジェクトは独立しており、Genspark、OpenClaw、Nous Researchとは提携していません。スキルはYAMLフロントマター付きのプレーンなMarkdownファイルなので、対応ランタイムにインストールする前に、内容の確認、検証、変更を行えます。

主な機能

  • 本番対応の5つのスキル：詳細調査、レポート生成、スライド計画、ブラウザー自動化、電話準備。
  • 複数ランタイムに対応：同じスキルをOpenClaw、Hermes、Claude Code、Cursor、またはローカルワークスペースにインストールできます。
  • 実行時依存関係ゼロ：CLIはNode.js標準ライブラリを使用し、Node.js 18以降が必要です。
  • セキュリティ検証：バリデーターがスキルの構造を確認し、パイプ経由のリモート実行、base64ペイロード、破壊的なコマンドなどのパターンを検出します。
  • MCP対応：Claude Desktop、Cursor、WindsurfなどのMCPクライアントにスキルパックを公開できます。
  • テストとCI：Node.js 18、20、22を対象に、Ubuntu、macOS、Windows上で自動テストとCIを実行します。

同梱スキルの概要

パッケージには5つのスキルが含まれており、それぞれ専用ディレクトリ内のSKILL.mdファイルに保存されています。

  • super-research：質問を分解し、並列検索を実行し、独立した情報源間で主張を相互検証して、出典付きレポートを作成します。
  • spark-report：調査結果、メモ、会話を、エグゼクティブサマリー、比較表、引用、次のステップを含む洗練されたレポートに変換します。
  • spark-slides：調査結果やアイデアを、主張を表すタイトル、発表者ノート、出典を備えた物語性のあるスライドデッキの構成案に変換します。
  • claw-browser-anchor：壊れやすい画面座標ではなくDOMセレクターとARIAロールを使用し、検証とずれからの復旧によってブラウザー自動化の堅牢性を高めます。
  • call-prep：通話相手を調査し、目的と代替案を定義し、分岐する台本を作成して、通話後の要約を構造化することで、AIによる電話を準備します。

CLIのインストールと確認

前提条件

Node.js 18以降をインストールしてください。公式のNode.jsダウンロード手順の利用を推奨します。macOSでは、まずAppleのコマンドラインツールをインストールしてください。

xcode-select --install

LinuxとWindowsのユーザーは、macOSのコマンドラインツールの手順を省略できます。パッケージはセルフホストのOpenClaw、Hermes、Claude Code、またはCursorで利用できるため、Gensparkのサブスクリプションは必要ありません。

GitHubからインストール

作業ディレクトリを作成し、GitHubからリポジトリを直接インストールして、ヘルスチェックを実行します。

mkdir -p 'gensparkclaw' && cd 'gensparkclaw'
npm install github:breakstageaxe61/genspark-claw
npx genspark-claw doctor
npx genspark-claw list

doctorコマンドは環境とランタイムを確認します。listコマンドは、同梱されている5つのスキルとその説明を表示します。

エージェントランタイムにスキルをインストール

OpenClawまたはGenspark Claw

同梱されているすべてのスキルを、OpenClawのデフォルトのスキルディレクトリにインストールします。

npx genspark-claw install all --target openclaw

スキルは~/.openclaw/skills/にコピーされます。セルフホストのOpenClawゲートウェイを使用している場合は、スキルを利用可能にするためにゲートウェイを再起動するか、新しいセッションを開始してください。Genspark Clawでは、スキルパネルからSKILL.mdファイルをインポートするか、node_modules/genspark-claw/skills/からコピーします。

Hermes

次のコマンドで、すべてのスキルをHermesにインストールします。

npx genspark-claw install all --target hermes

デフォルトの保存先は~/.hermes/skills/です。

Claude CodeとCursor

ランタイム固有のターゲットを使用して、それぞれの標準スキルディレクトリにファイルをインストールします。

npx genspark-claw install all --target claude
npx genspark-claw install all --target cursor

これらのコマンドは、それぞれ~/.claude/skills/と~/.cursor/skills/を対象にします。

プロジェクトのワークスペースにインストール

プロジェクト固有のインストールでは、1つのスキルまたはスキルパック全体をカスタムディレクトリにインストールできます。

npx genspark-claw install super-research
npx genspark-claw install all --dir ~/my-agent/skills

ファイルを書き込まずにインストーラーの動作を確認したい場合は、--dry-runを使用します。

npx genspark-claw install all --target openclaw --dry-run

CLIコマンドを使用

CLIは、スキルの一覧表示、インストール、検証、診断、MCPの起動に対応しています。

genspark-claw <command> [options]
  • listは、同梱されているすべてのスキルを一覧表示します。
  • info <skill>は、スキルの詳細と完全な手順を表示します。
  • install [skill]は、1つのスキルまたはすべてのスキルをインストールします。
  • validate [path]は、SKILL.mdファイルを検証します。デフォルトでは同梱スキルを対象にします。
  • doctorは、ローカル環境と検出されたランタイムを確認します。
  • runtimesは、検出されたエージェントランタイムを一覧表示します。
  • mcpは、MCP標準入出力サーバーを起動します。
  • versionは、インストールされているバージョンを表示します。

たとえば、インストールする前にスキルを確認します。

npx genspark-claw info super-research

まずスキルの指示を読むことは、特にサードパーティ製のエージェントスキルを扱う際に、セキュリティと互換性を確保するための有効な習慣です。

MCPサーバーに接続する

genspark-clawには、依存関係なしで動作するModel Context Protocolサーバーが含まれています。list_skills、get_skill、validate_skillの3つのツールを公開します。

インストールしたサーバーへの絶対パスを使用して、Claude DesktopのMCP設定にサーバーを追加します。

{
  "mcpServers": {
    "genspark-claw": {
      "command": "node",
      "args": ["/absolute/path/to/gensparkclaw/node_modules/genspark-claw/mcp/mcp-server.js"]
    }
  }
}

組み込みのセルフテストを実行して、初期化、ツール検出、ツール実行を確認します。

node node_modules/genspark-claw/mcp/mcp-server.js --test

MCPセルフテストに合格しました: initialize、tools/list、tools/callはすべて正常です。

スキルを安全に検証する

使用する前に、同梱ファイルに対して検証を実行します。

npx genspark-claw validate

カスタムディレクトリを検証することもできます。

npx genspark-claw validate ./my-skills

検証ツールは、想定されるスキーマを確認し、セキュリティ監査を実行します。curl | bash、Base64ペイロード、破壊的なコマンドなどのパターンを検出します。検証によってリスクは軽減できますが、それでも完全なSKILL.mdを読み、エージェント独自の監査ツールやdoctorツールを使用してください。

カスタムスキルを作成して貢献する

カスタムスキルは、SKILL.mdファイルを含むディレクトリです。フロントマターには、name、description、version、triggers、compatibility、および1行形式のメタデータJSONなどのフィールドを定義します。本文には、番号付きの手順、ルール、エラー処理、出力形式を記述します。

  1. ディレクトリとファイルを作成します。
  2. リポジトリの貢献ガイドに記載されているスキルの構成に従います。
  3. npm run validateを実行して、スキーマとセキュリティルールを確認します。
  4. npm testを実行して、自動テストスイートを実行します。
  5. スキルを共有する場合は、プルリクエストを作成します。

このリポジトリでは、clawhub publishを使って互換性のあるスキルをClawHubに公開することもできます。同じプレーンファイル形式は、Hermesおよびagentskills.io互換ツールで動作するように設計されています。

プログラムからAPIを使用する

別のNode.jsアプリケーションにgenspark-clawを統合する場合は、パッケージをrequireして公開APIを呼び出します。

const gclaw = require('genspark-claw');

gclaw.listBundledSkills();
gclaw.findSkill('super-research');
gclaw.installSkills({ skill: 'all', target: 'hermes' });
gclaw.validateTarget('./my-skills/');
gclaw.runDoctor();

各メソッドは、独自のツールで利用できるスキルレコード、検証結果、または環境チェックデータを返します。

ローカルで開発する

プロジェクト自体を開発するには、リポジトリをクローンしてテストおよび検証コマンドを実行します。

git clone https://github.com/breakstageaxe61/genspark-claw.git
cd genspark-claw
npm test
npm run validate
node examples/quickstart.js
node mcp/mcp-server.js --test

このプロジェクトは意図的に依存関係をゼロにしているため、開発にnpm installは必要ありません。主な領域は、bin/のCLIエントリーポイント、src/index.jsの公開API、skills/のスキル、mcp/のMCPサーバー、test/のテストです。

まとめ

genspark-clawは、複数のAIエージェント環境に再利用可能で確認可能なワークフローを追加するための、シンプルな方法を提供します。GitHubからインストールし、doctorとlistで設定を確認し、ランタイムターゲットを指定してスキルをデプロイし、カスタムまたはサードパーティ製の指示を導入する前にvalidateを使用してください。統合用途では、組み込みのMCPサーバーとNode.js APIによって、同じスキルパックをツールやアプリケーションから利用できます。