Führen Sie sofort einen lokalen HTTP-Mock-Server aus jeder OpenAPI 3.x- oder Swagger 2.0-Spezifikationsdatei oder URL aus, ohne Backend-Code zu schreiben.
Installieren & Herunterladen
1. ClawHub CLI
Der schnellste Weg, einen Skill direkt aus der Registry zu installieren.
npx clawhub@latest install phy-openapi-mock-server
2. Manuelle Installation
Kopiere den Skill-Ordner an einen dieser Orte
~/.openclaw/skills/ <project>/skills/ Priorität: Workspace > Lokal > Integriert (Bundled)
3. Prompt-Installation
Kopiere diesen Prompt in OpenClaw, um ihn automatisch zu installieren.
Hilf mir, phy-openapi-mock-server über Clawhub zu installieren. Falls Clawhub nicht installiert ist, installiere es bitte zuerst (npm i -g clawhub).
Lieber herunterladen?
Hole dir die rohen Skill-Dateien in einem ZIP-Archiv.
Was ist OpenAPI Mock Server?
OpenAPI Mock Server ist ein robustes Entwicklungstool, das jede OpenAPI 3.x- oder Swagger 2.0-Spezifikation sofort in einen voll funktionsfähigen lokalen HTTP-Server umwandelt. Indem Sie das Tool auf Ihr YAML- oder JSON-Schema verweisen, startet es einen lokalen Mock-Server, der sofort schema-konforme Mock-Daten ausgibt. Dies eliminiert Engpässe durch Backend-Abhängigkeiten und ermöglicht es Softwareteams, Contract-First-Workflows einzuführen, bei denen die Backend- und Frontend-Konstruktion gleichzeitig erfolgen können.
Die Verwendung dieser Einrichtung innerhalb des Openclaw Skills-Ökosystems stellt sicher, dass Entwicklungsteams zuverlässige, Offline- und automatisierte Mock-APIs lokal ausführen können. Entwickler erhalten Mock-Endpunkte, die Payloads validieren und anpassbare Antworten zurückgeben, ohne Mock-Routing-Logik schreiben oder containerisierte Stubs bereitstellen zu müssen.
OpenAPI Mock Server Anwendungsfälle
- Frontend-Entwickler, die durch unvollständige Backend-Endpunkte oder APIs in der Entwurfsphase blockiert sind.
- QA-Ingenieure, die wiederholbare, Offline-Test-APIs für Verifizierungsroutinen oder Leistungstests benötigen.
- Architekten, die strukturelle Schemaänderungen und Payload-Einschränkungen in aktiven Integrations-Branches testen.
- Lokale Softwareumgebungen, die dynamische Sandbox-Endpunkte benötigen, ohne externe Ratenbegrenzungen zu erreichen.
So funktioniert OpenAPI Mock Server
- Syntaxprüfung: Das Tool validiert Ihren Dateipfad oder Ihre URL und prüft, ob die OpenAPI-Spezifikation syntaktisch korrektes YAML oder JSON ist.
- Prism CLI Orchestrierung: Es prüft das lokale Vorhandensein der Stoplight Prism CLI (Ausführung über npx oder globale Installation) oder nutzt einen lokalen Docker-Fallback.
- Schemaextraktion: Es liest interne Pfade und Definitionen und inventarisiert dann jedes Anforderungs- und Antwort-Schema-Mapping.
- Ausführungseinrichtung: Es startet den Server lokal auf Port 4010 (oder einem angegebenen benutzerdefinierten Port) entweder im Passthrough-Modus oder im Validierungsmodus.
- Endpunkt-Diagnose: Es generiert sofortige curl-Beispiele mit korrekten Pfaden, Request-Body-Hinweisen und Pfadvariablen, die mit Mock-Werten gefüllt sind.
- Antwortgenerierung: Clients, die den Mock-Server abfragen, erhalten automatische Mock-Payloads, die direkt aus den in der Spezifikation deklarierten Beispielen oder Schemas generiert werden.
OpenAPI Mock Server Einrichtung
Stellen Sie zunächst sicher, dass Node.js 16+ oder Docker auf Ihrem Host-System installiert ist. Um den Mock-Server mit dieser Skill auszuführen, führen Sie einen der folgenden Befehle in Ihrer CLI aus:
# Standard-Mock-Server-Ausführung aus einer lokalen Datei
/openapi-mock openapi.yaml
# Mock-Server-Ausführung aus einer Remote-URL-Spezifikation
/openapi-mock https://petstore.swagger.io/v2/swagger.json
# Mock-Server auf einem benutzerdefinierten Port ausführen
/openapi-mock openapi.yaml --port 4015
# Ausführung mit strikter Validierung (gibt 422 für nicht konforme Payloads zurück)
/openapi-mock openapi.yaml --validate
Wenn Node.js nicht verfügbar ist, verwenden Sie den alternativen Docker-Befehl in Ihrer Shell:
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 Datenschema & Taxonomie
Diese Skill organisiert und betreibt Mock-Server-Workflows unter Verwendung der folgenden Systemkomponenten:
| Attribut | Beschreibung |
|---|---|
| Eingabe-Spezifikationsdatei | Lokaler Pfad zur .yaml-, .yml- oder .json-Datei oder eine direkte HTTP/S-URL zu einer Schemadatei |
| Port-Option | Numerischer Parameter (Standard 4010), der die Host-Adresse für HTTP-Datenverkehr festlegt |
| Validierungs-Flag | Das Argument --validate ordnet API-Einschränkungen eingehenden HTTP-Anfragen zu und lehnt ungültige Aufrufe mit einem 422-Fehler ab |
| Dynamik-Flag | Das Argument --dynamic weist den Server an, zufällige passende Schemawerts anstelle statischer Standardwerte auszugeben |
| Endpunkt-Bericht | Markdown-Aufschlüsselung, die Pfade, Methoden, Zusammenfassungen und erwartete HTTP-Statuscodes hervorhebt |
OpenAPI Mock Server Erweiterte Funktionen
- Antwort-Code-Überschreibungen: Erzwingen Sie spezifische HTTP-Antwortszenarien (wie
404 Not Foundoder500 Internal Server Error), indem Sie denPrefer: code=XXX-Header in Client-Anfragen bereitstellen. - Dynamische Wertumschaltung: Stellen Sie den
Prefer: dynamic=true-Header bei isolierten curl-Abfragen bereit, um statische Beispieldefinitionen zu umgehen und eine schema-basierte Wertgenerierung auszulösen. - Nahtlose Authentifizierungsumgehung: Entwicklungs-Clients können auf gesicherte Ressourcen zugreifen, ohne echte Anmeldeinformationen auszutauschen, indem sie einfach Stub-Header wie
Authorization: Bearer fake-tokensenden. - Benutzerdefinierte Zielfilter: Zielen Sie gezielt auf bestimmte Namespaces oder Tag-Gruppierungen ab und reduzieren Sie so das Start-Log-Rauschen bei massiven Spezifikationen.
SKILL.md
Laden
Verwandte Openclaw-Skills
TypeScript Any Auditor
Ein lokales, abhängigkeitsfreies Tool zur Durchsetzung der Typabdeckung und zum Auditieren der TypeScript-Strenge, das implizite und explizite any-Lecks beseitigt.
Bundle Size Audit
Ein lokaler Bundle-Größen-Auditor ohne API, der Build-Artefakte analysiert, um Größenbudgets durchzusetzen und die Aufblähung von Abhängigkeiten zu eliminieren.
GraphQL Schema Audit
Ein lokaler statischer Analysator für GraphQL SDL oder introspection JSON, der Performance-Schwachstellen, Sicherheitsmängel und architektonische Risiken aufdeckt.
Regex Audit
Ein statischer Sicherheitslücken-Scanner ohne API, der Codebasen über mehrere Programmiersprachen hinweg analysiert, um ReDoS- und regex-Qualitätsmängel zu erkennen und zu beheben.
Dotenv Inheritance Mapper
Ein lokaler Analyse-Skill für Umgebungsvariablen, der die komplexe .env-Datei-Überschreibungshierarchie Ihres Frameworks auflöst, Konfigurationsrisiken kennzeichnet und die Verwendung mit Ihrem Quellcode abgleicht.
Pipeline Contract Enforcer
Ein lokaler, Agenten-nativer Datenvertrags-Durchsetzer, der unbemerkte Pipeline-Fehler verhindert, indem er Schemata validiert und Abweichungen zwischen Pipeline-Stufen erkennt.
Hervorgehoben*
