Vercel Skill für OpenClaw

OpenClaw Vercel Skill Überblick

Der Vercel Skill verbindet OpenClaw mit der Vercel-Plattform über die offizielle Vercel CLI. Nach der Installation kann Ihr OpenClaw-Agent Anwendungen deployen, Umgebungsvariablen verwalten, Domains konfigurieren und Build-Logs prüfen — alles durch einfache Befehle in natürlicher Sprache.

Vercel ist die führende Frontend-Cloud-Plattform und betreibt Millionen von Websites, die mit Next.js, React, Svelte und anderen modernen Frameworks erstellt wurden. Mit dem OpenClaw Vercel Skill entfällt der ständige Wechsel zwischen Editor, Terminal und dem Vercel-Dashboard. Beschreiben Sie einfach, was Sie benötigen, und OpenClaw erledigt den Rest.

Typischer Workflow:

1. Bitten Sie OpenClaw, Ihr aktuelles Projekt auf Vercel zu deployen.
2. Der Agent führt im Hintergrund vercel deploy aus und kümmert sich um die Projektverknüpfung und Build-Konfiguration.
3. Eine Preview-URL wird sofort zurückgegeben — kein Dashboard-Aufruf nötig.

Voraussetzungen für den Vercel Skill

Bevor Sie den Vercel Skill installieren, stellen Sie sicher, dass Sie Folgendes haben:

• OpenClaw installiert und ausgeführt (v1.0+)
• Vercel CLI installiert — offizielle Installationsanleitung
• Ein Vercel-Konto (kostenloser Tarif genügt) mit mindestens einem Projekt
• Node.js 18+ (erforderlich für die Vercel CLI)
• clawhub CLI installiert für die Skill-Verwaltung

Überprüfen Sie Ihre Einrichtung:

# OpenClaw-Version prüfen
openclaw --version

# Vercel CLI-Version prüfen
vercel --version

# Vercel-Authentifizierung verifizieren
vercel whoami

So Installieren Sie den Vercel Skill

Installieren Sie den Vercel Skill mit einem einzigen Befehl:

npx clawhub@latest install vercel

Um die Installation zu überprüfen:

clawhub list

Sie sollten vercel in der Liste der installierten Skills sehen. Wenn Sie noch kein Vercel-Projekt verknüpft haben, werden Sie beim ersten Einsatz dazu aufgefordert.

Vercel Skill Konfiguration

Der Vercel Skill erfordert eine Authentifizierung über ein Vercel Access Token oder den Vercel CLI-Login-Vorgang. Wir empfehlen die Verwendung von vercel login für die einfachste Einrichtung.

Token-basierte Authentifizierung

Wenn Sie ein Token bevorzugen, erstellen Sie eines unter vercel.com/account/tokens:

| Einstellung | Empfehlung | |-------------|------------| | Geltungsbereich | Gesamtes Konto oder bestimmtes Team | | Ablauf | 90 Tage (regelmäßig rotieren) | | Name | Verwenden Sie einen beschreibenden Namen wie openclaw-agent |

Umgebungseinrichtung

# Option 1: Vercel CLI-Login verwenden (empfohlen)
vercel login

# Option 2: Ein Vercel Access Token setzen
export VERCEL_TOKEN=your_vercel_token_here

# Optional: Standard-Team/Bereich festlegen
export VERCEL_ORG_ID=team_your_team_id
export VERCEL_PROJECT_ID=prj_your_project_id

Wichtig: Schreiben Sie Tokens niemals direkt in Konfigurationsdateien. Verwenden Sie Umgebungsvariablen oder einen Geheimnisverwaltungsdienst wie 1Password oder Bitwarden.

Projektverknüpfung

Verknüpfen Sie vor dem Deployment Ihr lokales Verzeichnis mit einem Vercel-Projekt:

vercel link

Dies erstellt ein .vercel-Verzeichnis mit der Projektkonfiguration. Der Skill nutzt diese Verknüpfung, um das zu deployende Projekt zu bestimmen.

Vercel Skill Anwendungsbeispiele

1. Als Preview deployen

Sie: „Deploye das aktuelle Projekt als Preview auf Vercel."

Der Agent führt vercel deploy aus und gibt die Preview-URL zurück. Sie können diese URL mit Teammitgliedern zur Überprüfung teilen, bevor Sie in die Produktion wechseln.

2. In die Produktion übernehmen

Sie: „Übernimm das neueste Preview-Deployment in die Produktion."

Der Agent identifiziert das aktuellste Preview-Deployment und führt vercel promote aus, um es zur Live-Produktionsversion zu machen. OpenClaw bestätigt die Aktion vor der Ausführung.

3. Umgebungsvariablen verwalten

Sie: „Füge eine neue Umgebungsvariable DATABASE_URL für die Produktion mit dem Wert postgres://... hinzu."

Der Agent führt vercel env add DATABASE_URL production aus und speichert den Wert sicher. Sie können auch Umgebungsvariablen für Preview-, Entwicklungs- und Produktionsumgebungen auflisten, aktualisieren oder entfernen lassen.

4. Build-Logs prüfen

Sie: „Zeig mir die Build-Logs des letzten fehlgeschlagenen Deployments."

Der Agent ruft die aktuellen Deployments mit vercel ls ab, identifiziert das fehlgeschlagene und ruft die Build-Ausgabe mit vercel inspect ab. Anschließend fasst er den Fehler zusammen und schlägt eine Lösung vor.

5. Benutzerdefinierte Domains konfigurieren

Sie: „Füge die Domain app.example.com zu meinem Vercel-Projekt hinzu."

Der Agent führt vercel domains add app.example.com aus und liefert die DNS-Einträge, die Sie bei Ihrem Domain-Registrar konfigurieren müssen. Er kann auch den Status der Domain-Konfiguration überprüfen.

Sicherheit und Best Practices

Der Vercel Skill kann Schreiboperationen an Ihren Deployments und Projekteinstellungen durchführen. Befolgen Sie diese Richtlinien für einen sicheren Umgang:

• Verwenden Sie minimale Berechtigungen. Wenn Sie in einem Team arbeiten, beschränken Sie Tokens auf bestimmte Projekte, anstatt vollen Kontozugriff zu gewähren.
• Überprüfen Sie vor dem Produktions-Deployment. Nutzen Sie immer zuerst Preview-Deployments. OpenClaw fragt vor Produktionsübernahmen um Bestätigung.
• Schützen Sie Umgebungsvariablen. Sensible Werte wie Datenbank-URLs und API-Schlüssel sollten über vercel env gesetzt werden — niemals im Quellcode committet.
• Rotieren Sie Tokens regelmäßig. Setzen Sie eine 90-Tage-Ablaufzeit für Ihr Vercel Access Token und rotieren Sie es proaktiv.
• Prüfen Sie Deployments. Überprüfen Sie regelmäßig den Aktivitäts-Tab im Vercel-Dashboard, um über die CLI durchgeführte Deployments zu kontrollieren.
• Verwenden Sie Team-Scoping. Setzen Sie in Multi-Team-Setups explizit VERCEL_ORG_ID, um Deployments an das falsche Team zu vermeiden.

Fehlerbehebung Häufiger Probleme

„Error: No Project linked"

Sie haben Ihr lokales Verzeichnis noch nicht mit einem Vercel-Projekt verknüpft.

# Mit einem bestehenden Projekt verknüpfen
vercel link

# Oder deployen und ein neues Projekt erstellen
vercel deploy

Der Skill führt Sie durch die Projektauswahl, wenn mehrere Projekte unter Ihrem Konto vorhanden sind.

„Error: Invalid token"

Ihr Vercel Access Token fehlt, ist abgelaufen oder wurde widerrufen.

1. Überprüfen Sie Ihr Token unter vercel.com/account/tokens.
2. Falls abgelaufen, generieren Sie ein neues Token und aktualisieren Sie Ihre Umgebungsvariable.
3. Alternativ authentifizieren Sie sich erneut mit vercel login.

# Erneut authentifizieren
vercel login

# Oder Token aktualisieren
export VERCEL_TOKEN=your_new_token_here

„Build Failed: Command 'npm run build' exited with 1"

Der Build-Befehl ist während des Deployments fehlgeschlagen. Dies ist in der Regel ein Code-Problem, kein Skill-Problem.

1. Führen Sie den Build zuerst lokal aus: npm run build
2. Prüfen Sie auf fehlende Umgebungsvariablen — der Skill kann diese mit vercel env ls auflisten
3. Überprüfen Sie das vollständige Build-Log mit vercel inspect <deployment-url>
4. Stellen Sie sicher, dass Ihre package.json-Skripte und Framework-Einstellungen mit der Build-Konfiguration von Vercel übereinstimmen