バックエンドコードを書くことなく、OpenAPI 3.x または Swagger 2.0 の仕様ファイルや URL からローカル HTTP Mock Server を即座に実行します。
インストール＆ダウンロード
1. ClawHub CLI
レジストリから直接スキルをインストールする最速の方法です。
npx clawhub@latest install phy-openapi-mock-server
2. 手動インストール
スキルフォルダを以下のいずれかの場所にコピーしてください
~/.openclaw/skills/ <project>/skills/ 優先順位：ワークスペース > ローカル > バンドル
3. プロンプトのインストール
このプロンプトをOpenClawにコピーするだけで、自動的にインストールされます。
Clawhubを使って phy-openapi-mock-server をインストールして。Clawhubがインストールされていない場合は、先にインストールしてください（npm i -g clawhub）。
ダウンロードをご希望ですか？
ZIPアーカイブで生のスキルファイルを取得します。
OpenAPI Mock Server とは？
OpenAPI Mock Server は、あらゆる OpenAPI 3.x または Swagger 2.0 仕様を即座に完全に動作するローカル HTTP サーバーに変換するように設計された強力な開発ユーティリティです。YAML または JSON スキーマを指定すると、ツールはスキーマ準拠の Mock データをオンザフライで出力するローカル Mock Server を起動します。これにより、バックエンドの依存関係によるボトルネックが解消され、ソフトウェアチームはコントラクトファースト（contract-first）のワークフローを採用して、バックエンドとフロントエンドの構築を同時に進めることができます。
Openclaw Skills エコシステム内でこのセットアップを使用することで、開発チームはローカルで信頼性が高く、オフラインで動作する自動化された Mock API を維持できます。開発者は、Mock ルーティングロジックを記述したり、コンテナ化されたスタブ（stubs）をデプロイしたりすることなく、ペイロードを検証し、カスタマイズ可能なレスポンスを返す Mock エンドポイントを利用できます。
OpenAPI Mock Server のユースケース
- 未完成のバックエンドエンドポイントや設計中の API によって作業がブロックされているフロントエンド開発者。
- 検証ルーチンやパフォーマンス試行のために、繰り返し可能でオフラインのテスト API を必要とする QA エンジニア。
- アクティブな統合ブランチ内で構造的なスキーマ変更とペイロード制約をテストするアーキテクト。
- 外部のレート制限に抵触することなく、動的なサンドボックスエンドポイントを必要とするローカルソフトウェア環境。
OpenAPI Mock Server の仕組み
- 構文チェック: このツールはファイルパスまたは URL を検証し、OpenAPI 仕様が構文的に正しい YAML または JSON であるかを確認します。
- Prism CLI オーケストレーション: ローカルに Stoplight Prism CLI が存在するかを確認し（npx またはグローバルインストール経由で実行）、またはローカル Docker を代替として利用します。
- スキーマ抽出: 内部パスと定義を読み取り、すべてのリクエストとレスポンスのスキーマのマッピングをインベントリ化します。
- 実行セットアップ: 4010 ポート（または指定されたカスタムポート）で、パススルーモードまたは検証モードのいずれかでサーバーをローカルで起動します。
- エンドポイント診断: 正しいパス、リクエストボディのヒント、および Mock 値で埋められたパス変数を含む、即時の curl 例を生成します。
- レスポンス生成: Mock Server にクエリを実行するクライアントは、仕様で宣言された例やスキーマから直接生成された自動 Mock ペイロードを受信します。
OpenAPI Mock Server のセットアップ
まず、ホストシステムに Node.js 16+ または Docker がインストールされていることを確認してください。このスキルを使用して Mock Server を実行するには、CLI で以下のいずれかのコマンドを実行します。
# ローカルファイルからの標準 Mock Server 実行
/openapi-mock openapi.yaml
# リモート URL 仕様からの Mock Server 実行
/openapi-mock https://petstore.swagger.io/v2/swagger.json
# カスタムポートでの Mock Server 実行
/openapi-mock openapi.yaml --port 4015
# 厳格な検証での実行（準拠していないペイロードに対して 422 を返す）
/openapi-mock openapi.yaml --validate
Node.js が利用できない場合は、シェルで代替の Docker コマンドを使用してください。
docker run --rm -p 4010:4010 \
-v "$(pwd):/tmp/spec" \
stoplight/prism:latest \
mock /tmp/spec/openapi.yaml -h 0.0.0.0
OpenAPI Mock Server のデータスキーマとタクソノミー
このスキルは、次のシステムコンポーネントを使用して Mock Server ワークフローを整理および操作します。
| 属性 | 説明 |
|---|---|
| 入力仕様ファイル | .yaml、.yml、または .json ファイルのローカルパス、またはスキーマファイルへの直接的な HTTP/S URL |
| ポートオプション | HTTP トラフィックのホストアドレスを指定する数値パラメータ（デフォルトは 4010） |
| 検証フラグ | --validate 引数は API 制約を受信 HTTP リクエストにマッピングし、無効な呼び出しを 422 エラーで拒否します |
| 動的フラグ | --dynamic 引数は、静的なデフォルト値ではなく、ランダムに一致するスキーマ値を出力するようにサーバーに指示します |
| エンドポイントレポート | パス、メソッド、概要、および期待される HTTP ステータスコードを強調する Markdown 分解 |
OpenAPI Mock Server の高度な機能
- レスポンスコードのオーバーライド: クライアントリクエストに
Prefer: code=XXXヘッダーを提供することで、特定の HTTP レスポンスシナリオ（404 Not Foundや500 Internal Server Errorなど）を強制します。 - 動的値の切り替え: 分離された curl クエリ中に
Prefer: dynamic=trueヘッダーを提供し、静的な例の定義をバイパスしてスキーマベースの値生成をトリガーします。 - シームレスな認証バイパス: 開発クライアントは、
Authorization: Bearer fake-tokenのようなスタブヘッダーを送信するだけで、実際の資格情報の交換なしで保護されたリソースにアクセスできます。 - カスタムターゲットフィルター: 特定のネームスペースやタググループのみをターゲットにしてサービスを提供し、大規模な仕様における起動ログのノイズを軽減します。
SKILL.md
ローディング
関連するOpenclawのスキル
TypeScript Any Auditor
ローカルかつ依存関係ゼロの型カバレッジ強制ツールであり、暗黙的および明示的な any のリークを排除する TypeScript 厳格モード監査ツールです。
Bundle Size Audit
ビルド成果物を解析してサイズ予算を適用し、依存関係の肥大化を排除する、API 不要のローカル bundle サイズ監査ツールです。
GraphQL Schema Audit
GraphQL SDLまたはintrospection JSON用のローカル静的解析ツール。パフォーマンスの脆弱性、セキュリティ上の欠陥、アーキテクチャ上のリスクを検出します。
Regex Audit
複数のプログラミング言語にわたるコードベースを分析し、ReDoS および regex の品質欠陥を検出して修復する、API 不要の静的脆弱性スキャナーです。
Dotenv Inheritance Mapper
フレームワークの複雑な .env ファイルの上書き階層を解決し、構成リスクをフラグ立てし、ソースコードの使用状況とクロスリファレンスするローカル環境変数分析スキルです。
Pipeline Contract Enforcer
スキーマの検証とパイプラインステージ間のドリフト検出により、サイレントなパイプライン障害を防ぐ、ローカルの、エージェントネイティブなデータ契約執行ツールです。
特徴*
