Skill Vercel pour OpenClaw

Aperçu du Skill Vercel pour OpenClaw

Le skill Vercel connecte OpenClaw à la plateforme Vercel via le CLI Vercel officiel. Une fois installé, votre agent OpenClaw peut déployer des applications, gérer les variables d'environnement, configurer les domaines et inspecter les journaux de build — le tout grâce à des commandes en français courant.

Vercel est la principale plateforme cloud frontend, propulsant des millions de sites web construits avec Next.js, React, Svelte et d'autres frameworks modernes. Avec le skill Vercel pour OpenClaw, vous éliminez les changements de contexte entre votre éditeur, votre terminal et le tableau de bord Vercel. Décrivez simplement ce dont vous avez besoin, et OpenClaw s'occupe du reste.

Flux de travail typique :

1. Demandez à OpenClaw de déployer votre projet actuel sur Vercel.
2. L'agent exécute vercel deploy en arrière-plan, gérant la liaison du projet et la configuration du build.
3. Une URL de prévisualisation est renvoyée instantanément — pas besoin d'ouvrir le tableau de bord.

Prérequis pour le Skill Vercel

Avant d'installer le skill Vercel, assurez-vous de disposer de :

• OpenClaw installé et en fonctionnement (v1.0+)
• Vercel CLI installé — guide d'installation officiel
• Un compte Vercel (le plan gratuit convient) avec au moins un projet
• Node.js 18+ (requis par le Vercel CLI)
• clawhub CLI installé pour la gestion des skills

Vérifiez votre configuration :

# Vérifier la version d'OpenClaw
openclaw --version

# Vérifier la version du Vercel CLI
vercel --version

# Vérifier l'authentification Vercel
vercel whoami

Comment Installer le Skill Vercel

Installez le skill Vercel avec une seule commande :

npx clawhub@latest install vercel

Pour vérifier l'installation :

clawhub list

Vous devriez voir vercel dans la liste des skills installés. Si vous n'avez pas encore lié de projet Vercel, le skill vous invitera à le faire lors de la première utilisation.

Configuration du Skill Vercel

Le skill Vercel nécessite une authentification via un Vercel Access Token ou le flux de connexion du Vercel CLI. Nous recommandons d'utiliser vercel login pour la configuration la plus simple.

Authentification par Token

Si vous préférez un token, créez-en un sur vercel.com/account/tokens :

| Paramètre | Recommandation | |-----------|---------------| | Portée | Compte complet ou équipe spécifique | | Expiration | 90 jours (à renouveler régulièrement) | | Nom | Utilisez un nom descriptif comme openclaw-agent |

Configuration de l'Environnement

# Option 1 : Utiliser la connexion Vercel CLI (recommandé)
vercel login

# Option 2 : Définir un Vercel Access Token
export VERCEL_TOKEN=your_vercel_token_here

# Optionnel : Définir l'équipe/portée par défaut
export VERCEL_ORG_ID=team_your_team_id
export VERCEL_PROJECT_ID=prj_your_project_id

Important : Ne codez jamais les tokens en dur dans les fichiers de configuration. Utilisez des variables d'environnement ou un gestionnaire de secrets tel que 1Password ou Bitwarden.

Liaison de Projet

Avant de déployer, liez votre répertoire local à un projet Vercel :

vercel link

Cela crée un répertoire .vercel contenant la configuration du projet. Le skill utilise cette liaison pour déterminer quel projet déployer.

Exemples d'Utilisation du Skill Vercel

1. Déployer en Prévisualisation

Vous : « Déploie le projet actuel sur Vercel en prévisualisation. »

L'agent exécute vercel deploy et renvoie l'URL de prévisualisation. Vous pouvez partager cette URL avec vos coéquipiers pour révision avant de promouvoir en production.

2. Promouvoir en Production

Vous : « Promeus le dernier déploiement de prévisualisation en production. »

L'agent identifie le déploiement de prévisualisation le plus récent et exécute vercel promote, le rendant la version de production active. OpenClaw demande confirmation avant de procéder.

3. Gérer les Variables d'Environnement

Vous : « Ajoute une nouvelle variable d'environnement DATABASE_URL pour la production avec la valeur postgres://... »

L'agent exécute vercel env add DATABASE_URL production et stocke la valeur de manière sécurisée. Vous pouvez également demander à lister, mettre à jour ou supprimer des variables d'environnement dans les environnements de prévisualisation, développement et production.

4. Inspecter les Journaux de Build

Vous : « Montre-moi les journaux de build du dernier déploiement échoué. »

L'agent récupère les déploiements récents avec vercel ls, identifie celui qui a échoué et récupère la sortie du build avec vercel inspect. Il résume ensuite l'erreur et suggère une correction.

5. Configurer des Domaines Personnalisés

Vous : « Ajoute le domaine app.example.com à mon projet Vercel. »

L'agent exécute vercel domains add app.example.com et fournit les enregistrements DNS que vous devez configurer chez votre registrar. Il peut également vérifier l'état de la configuration du domaine.

Sécurité et Bonnes Pratiques

Le skill Vercel peut effectuer des opérations d'écriture sur vos déploiements et paramètres de projet. Suivez ces recommandations pour rester en sécurité :

• Utilisez le principe du moindre privilège. Si vous travaillez en équipe, limitez la portée des tokens à des projets spécifiques plutôt qu'à l'accès complet au compte.
• Vérifiez avant de déployer en production. Utilisez toujours les déploiements de prévisualisation en premier. OpenClaw demande confirmation avant les promotions en production.
• Protégez les variables d'environnement. Les valeurs sensibles comme les URL de base de données et les clés API doivent être définies via vercel env — jamais commitées dans le code source.
• Renouvelez régulièrement les tokens. Définissez une expiration de 90 jours sur votre Vercel Access Token et renouvelez-le de manière proactive.
• Auditez les déploiements. Consultez régulièrement l'onglet Activité du tableau de bord Vercel pour examiner les déploiements effectués via le CLI.
• Utilisez la portée d'équipe. Dans les configurations multi-équipes, définissez explicitement VERCEL_ORG_ID pour éviter de déployer vers la mauvaise équipe.

Résolution des Erreurs Courantes

"Error: No Project linked"

Vous n'avez pas encore lié votre répertoire local à un projet Vercel.

# Lier à un projet existant
vercel link

# Ou déployer et créer un nouveau projet
vercel deploy

Le skill vous guidera dans la sélection du projet si plusieurs projets existent sous votre compte.

"Error: Invalid token"

Votre Vercel Access Token est manquant, expiré ou révoqué.

1. Vérifiez votre token sur vercel.com/account/tokens.
2. S'il est expiré, générez un nouveau token et mettez à jour votre variable d'environnement.
3. Alternativement, réauthentifiez-vous avec vercel login.

# Se réauthentifier
vercel login

# Ou mettre à jour votre token
export VERCEL_TOKEN=your_new_token_here

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

La commande de build a échoué pendant le déploiement. Il s'agit généralement d'un problème de code, pas du skill.

1. Lancez d'abord le build en local : npm run build
2. Vérifiez les variables d'environnement manquantes — le skill peut les lister avec vercel env ls
3. Consultez le journal de build complet avec vercel inspect <deployment-url>
4. Assurez-vous que les scripts de votre package.json et les paramètres du framework correspondent à la configuration de build de Vercel