カスタム OpenClaw スキルの構築方法

はじめに

OpenClaw スキルは、エージェントにツールを公開する MCP（Model Context Protocol）サーバーです。スキルを構築すると、API へのアクセスからハードウェアの制御、ファイルの処理まで、エージェントに新しい機能が与えられます。スキルは、OpenClaw エージェントが会話を超えて物事を行うための主要な方法です。

前提条件

• Node.js 18+ または Python 3.10+ がインストールされている
• 基本的なプログラミングの知識（TypeScript または Python を推奨）
• テスト用の有効なエージェントを持つ KiwiClaw アカウント
• OpenClaw アーキテクチャに関する知識

ステップごとの手順

ステップ 1：スキル形式を理解する

OpenClaw スキルは、1 つ以上のツールを公開する MCP サーバーです。各ツールには、名前、説明、入力スキーマ、およびハンドラー関数があります。エージェントは利用可能なツールを検出し、会話コンテキストに基づいていつそれらを呼び出すかを決定します。

ステップ 2：開発環境をセットアップする

新しいプロジェクトディレクトリを作成します。TypeScript を使用している場合は、npm init で初期化し、MCP SDK をインストールします。Python を使用している場合は、仮想環境をセットアップし、MCP Python パッケージをインストールします。

ステップ 3：スキルマニフェストを作成する

スキルのメタデータを定義します：名前、バージョン、説明、作成者、および提供するツールのリスト。このマニフェストは、OpenClaw にスキルの実行可能内容を伝えます。

ステップ 4：ツールハンドラーを作成する

各ツールの関数を実装します。ツールハンドラーは入力パラメーターを受け取り、結果を返します。たとえば、天気スキルは都市名を受け入れ、天気 API を呼び出すことによって現在の予報を返す場合があります。

ステップ 5：ローカルでテストする

スキルをローカルで実行し、KiwiClaw エージェントに対してテストします。ローカルサーバーを指すことで、ダッシュボードの [スキル] ページを使用してスキルをインストールします。各ツールが正しく動作することを確認します。

ステップ 6：マーケットプレイスに公開する

スキルが準備できたら、KiwiClaw Skills Marketplace に送信します。私たちのチームは、セキュリティと品質のために送信をレビューします。承認されると、他のユーザーがあなたのスキルをインストールできます。無料または有料として設定できます。

プロのヒント

• スキルクリエーターから始める -- このメタスキルは、エージェントが他のスキルを構築するのに役立ち、ボイラープレートコードを生成します。
• ツールに焦点を当てる -- 各ツールは 1 つのことをうまく行う必要があります。複数の小さなツールは、1 つの複雑なツールよりも優れています。
• エラーを適切に処理する -- エージェントが何が間違っていたのかをユーザーに説明できるように、有益なエラーメッセージを返します。
• 良い説明を追加する -- エージェントはツール説明を使用して、いつそれらを呼び出すかを決定します。明確で具体的な説明は、より良いツール選択につながります。

よくある質問

OpenClaw スキルにはどのプログラミング言語を使用できますか？

OpenClaw スキルは MCP サーバーであるため、MCP プロトコルをサポートする任意の言語を使用できます。ほとんどのスキルは TypeScript または Python で記述されていますが、Go、Rust、およびその他の言語も使用できます。

OpenClaw スキルを収益化できますか？

はい。KiwiClaw マーケットプレイスにスキルを公開して、価格を設定します。KiwiClaw は、支払い、配信、レビューを処理します。誰かが有料スキルをインストールするたびに収益が得られます。詳細については、公開ガイドを参照してください。

スキルはセキュリティのためにどのようにレビューされますか？

すべてのマーケットプレイスの送信は、KiwiClaw の審査プロセスを経ます。ソースコードを確認し、悪意のある動作をチェックし、権限を確認し、マーケットプレイスのスキルの承認前に機能をテストします。