find-skills

find-skills

目的

このスキルを使うと、機能、カテゴリ、評価、互換性、キーワードなどの条件に基づいて、ClaWHub 内のスキルを検索し、見つけることができます。AI ワークフローに統合するために、関連するスキルを効率よく探せます。

使用する場面

ClaWHub で利用可能なスキルを見つけたいときに、このスキルを使用します。たとえば、特定のタスク（コード生成など）向けに評価の高いスキルを探す場合、カテゴリ（「生産性」など）別にスキルを調べる場合、キーワード（「画像処理」など）で一致するスキルを探す場合などです。プロジェクトのセットアップ時、スキルのプロトタイピング時、または AI の機能を拡張する際に使用してください。

主な機能

• 機能（「自然言語処理」など）でスキルを検索します。
• カテゴリ（「コミュニティ」や「エンタープライズ」など）で絞り込みます。
• 評価（星 4.0 以上など）で並べ替えます。
• 互換性（OpenClaw バージョン >=1.5 など）を確認します。
• スキル名、説明、タグを対象にキーワードを照合します。
• ID、名前、タグなどのメタデータとともに検索結果を返します。

使用パターン

素早く検索するには CLI 経由でこのスキルを呼び出し、自動でスキルを見つけるにはスクリプトに統合します。ループ内で使用して複数のスキルを取得、評価したり、ほかのスキルと組み合わせて動的なワークフロー（検索してから実行するなど）を作成したりできます。幅広い結果を避けるため、必ず検索パラメーターを指定してください。たとえば、キーワードと評価を組み合わせると、対象を絞った検索ができます。

主なコマンド／API

検索には ClaWHub CLI または API を使用します。認証するには、コマンドを実行する前に環境変数 $CLAWHUB_API_KEY を設定する必要があります。

• CLI コマンドの例：
  clawhub find-skills --query "AI coding" --category "community" --min-rating 4.0 --limit 10
  このコマンドは、クエリに一致し、評価が 4.0 以上のスキルを最大 10 件返します。

• API エンドポイントの例：
  JSON ボディを指定して https://api.clawhub.com/v1/skills/search に POST します：

  {  
    "query": "web scraping",  
    "category": "tools",  
    "minRating": 3.5,  
    "compatibility": "OpenClaw-v2"  
  }  
  

  レスポンスはスキルオブジェクトの JSON 配列です。

• Python 統合用コードスニペット：

  import requests  
  headers = {'Authorization': f'Bearer {os.environ.get("CLAWHUB_API_KEY")}'}  
  response = requests.post('https://api.clawhub.com/v1/skills/search', json={'query': 'data analysis'}, headers=headers)  
  

  これにより、「data analysis」に一致するスキルを取得します。

• 設定形式：
  検索設定を JSON 設定ファイル（例：search-config.json）に保存します：

  {  
    "defaultQuery": "AI tools",  
    "defaultCategory": "community"  
  }  
  

  --config search-config.json を指定して CLI に渡します。

統合に関する注意事項

API を AI エージェントのコードでラップして統合し、$CLAWHUB_API_KEY が安全に設定されていることを確認してください。OpenClaw では、結果に含まれるスキル ID を使って実行を連鎖させます（次に execute-skill を呼び出すなど）。API レスポンスの nextPageToken フィールドを確認して、ページネーションに対応してください。エージェントのバージョンとの互換性を検証するため、サンドボックス環境で統合をテストしてください。

エラー処理

よくあるエラーには、認証の失敗（HTTP 401：$CLAWHUB_API_KEY を確認）、無効なクエリ（HTTP 400：--query などのパラメーターを検証）、レート制限（HTTP 429：遅延を追加）があります。コードでは、API 呼び出しを try-except ブロックで囲みます：

try:  
    response = requests.post(...)  
    response.raise_for_status()  
except requests.exceptions.HTTPError as e:  
    print(f"Error: {e} - Retry after checking API key.")  

エラーコードなどの詳細とともにエラーを記録し、指数バックオフを使って最大 3 回再試行します。

グラフの関係

• 関連： 「discovery」（タグ）、「search」（タグ）、「clawhub」（クラスター）
• 依存： 「clawhub-api」（認証とエンドポイント用）
• 使用元： 「skill-execution」（実行前にスキルを見つけるため）
• 競合： 既知のものはありません
• 強化： 検索メカニズムを提供することで、「community」クラスターのスキルを強化します