Skill Coolify pour OpenClaw

Aperçu du Skill Coolify pour OpenClaw

Le skill Coolify connecte OpenClaw à votre instance Coolify via son API REST. Une fois installé, votre agent OpenClaw peut déployer des applications, gérer des bases de données, configurer des variables d'environnement et surveiller des services — le tout par de simples commandes en français.

Coolify est une alternative open source et auto-hébergeable à Vercel, Heroku et Netlify. Il vous permet de déployer des sites statiques, des applications full-stack, des bases de données et plus de 280 services en un clic sur vos propres serveurs. Avec le skill Coolify pour OpenClaw, vous bénéficiez de la commodité des plateformes gérées tout en gardant le contrôle total de votre infrastructure et de vos données.

Flux de travail typique :

1. Demandez à OpenClaw de déployer vos dernières modifications sur le serveur de staging.
2. L'agent appelle l'API Coolify pour déclencher un déploiement sur votre projet lié.
3. L'état du build et les journaux sont renvoyés sous forme de résumé lisible — pas besoin d'ouvrir le tableau de bord Coolify.

Prérequis pour le Skill Coolify

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

• OpenClaw installé et en cours d'exécution (v1.0+)
• Une instance Coolify fonctionnant sur votre serveur — guide d'installation
• Un jeton API Coolify généré depuis votre tableau de bord Coolify
• Au moins une application ou un service configuré dans Coolify
• clawhub CLI installé pour la gestion des skills

Vérifiez votre configuration :

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

# Vérifier que Coolify est accessible (remplacez par l'URL de votre instance)
curl -s https://your-coolify-instance.com/api/v1/healthcheck

# Vérifier le CLI clawhub
clawhub --version

Comment Installer le Skill Coolify

Installez le skill Coolify avec une seule commande :

npx clawhub@latest install coolify

Pour vérifier l'installation :

clawhub list

Vous devriez voir coolify dans la liste des skills installés. Le skill vous demandera votre point de terminaison API Coolify et votre jeton lors de la première utilisation.

Configuration du Skill Coolify

Le skill Coolify nécessite un jeton API et l'URL de votre instance. Générez un jeton depuis le tableau de bord Coolify sous Settings → API Tokens.

Permissions du Jeton

Les jetons API Coolify fournissent un accès complet à votre instance. Suivez le principe du moindre privilège :

| Cas d'utilisation | Recommandation | |-------------------|---------------| | Surveillance en lecture seule | Créez un jeton sur un compte membre de l'équipe avec le rôle lecteur | | Déploiement complet | Utilisez un jeton administrateur mais vérifiez toutes les actions avant de confirmer | | Multi-serveur | Créez des jetons séparés par serveur pour l'isolation |

Configuration de l'Environnement

# Définir l'URL de votre instance Coolify
export COOLIFY_BASE_URL=https://your-coolify-instance.com

# Définir votre jeton API Coolify
export COOLIFY_TOKEN=your_api_token_here

Important : Ne codez jamais les jetons en dur dans les fichiers de configuration. Utilisez des variables d'environnement ou un gestionnaire de secrets tel que 1Password ou Bitwarden. Gardez votre instance Coolify à jour avec la dernière version pour les correctifs de sécurité.

Vérification de la Connexion

Après avoir défini les variables d'environnement, vérifiez la connexion :

# Tester l'accès à l'API
curl -H "Authorization: Bearer $COOLIFY_TOKEN" \
  "$COOLIFY_BASE_URL/api/v1/teams"

Exemples d'Utilisation du Skill Coolify

1. Déployer une Application

Vous : "Déploie la dernière version de mon application web sur Coolify."

L'agent identifie votre application par son nom, déclenche un déploiement via l'API Coolify et diffuse l'état du build. Vous recevez un résumé avec l'URL de déploiement et la durée du build.

2. Gérer les Variables d'Environnement

Vous : "Ajoute DATABASE_URL à l'environnement de staging de mon service API."

L'agent appelle l'API Coolify pour créer la variable d'environnement sur l'application spécifiée. Vous pouvez également demander de lister, mettre à jour ou modifier en masse les variables entre les environnements. Le skill s'assure que les valeurs sensibles sont masquées dans la sortie.

3. Consulter les Journaux de l'Application

Vous : "Montre-moi les 100 dernières lignes de journaux du service de paiement."

L'agent récupère les journaux du conteneur via l'API Coolify et les présente dans un format lisible. Il peut également mettre en évidence les erreurs et suggérer des correctifs basés sur des modèles courants.

4. Redémarrer un Service

Vous : "Redémarre la base de données PostgreSQL sur mon serveur de production."

L'agent envoie une commande de redémarrage au service spécifié. OpenClaw demande une confirmation avant d'exécuter toute opération de redémarrage ou d'arrêt sur les services de production.

5. Vérifier l'Utilisation des Ressources

Vous : "Combien de CPU et de mémoire mon serveur de staging utilise-t-il ?"

L'agent interroge l'API Coolify pour obtenir les métriques du serveur et présente un résumé de l'utilisation du CPU, de la mémoire et du disque. Il peut vous alerter si une ressource approche de sa limite.

Sécurité et Bonnes Pratiques

Le skill Coolify peut effectuer des opérations d'écriture sur vos serveurs et applications. Suivez ces recommandations pour rester en sécurité :

• Utilisez le moindre privilège. Créez des jetons API dédiés avec des permissions minimales. Évitez d'utiliser votre jeton administrateur principal pour les opérations automatisées.
• Vérifiez avant de déployer en production. Testez toujours les déploiements sur le staging en premier. OpenClaw demande une confirmation avant les déploiements en production.
• Gardez Coolify à jour. Mettez régulièrement à jour votre instance Coolify pour obtenir les derniers correctifs de sécurité — lancez la mise à jour depuis le tableau de bord Coolify ou utilisez le guide officiel de mise à jour.
• Sécurisez votre instance. Placez Coolify derrière un pare-feu ou un VPN. Utilisez des mots de passe forts et activez l'authentification à deux facteurs.
• Renouvelez les jetons API. Régénérez les jetons périodiquement et révoquez ceux qui ne sont plus utilisés depuis le tableau de bord.
• Sauvegardez régulièrement. Utilisez la fonctionnalité de sauvegarde S3 intégrée à Coolify pour protéger votre configuration et vos données de base de données.

Résolution des Erreurs Courantes

"Connection refused" ou "ECONNREFUSED"

Le skill ne peut pas atteindre votre instance Coolify.

1. Vérifiez que COOLIFY_BASE_URL est correct et inclut le protocole (https://).
2. Vérifiez que votre instance Coolify est en cours d'exécution : systemctl status coolify sur votre serveur.
3. Assurez-vous que votre pare-feu autorise le trafic sur le port Coolify (par défaut : 8000).
4. Si vous utilisez un VPN ou Tailscale, confirmez que le tunnel est actif.

"Unauthorized" ou "Erreur 401"

Votre jeton API est invalide ou expiré.

1. Vérifiez votre jeton dans Coolify Dashboard → Settings → API Tokens.
2. Régénérez le jeton s'il a été révoqué.
3. Vérifiez que la variable d'environnement COOLIFY_TOKEN est correctement définie.

# Vérifier que le jeton est défini
echo $COOLIFY_TOKEN

# Tester l'authentification
curl -H "Authorization: Bearer $COOLIFY_TOKEN" \
  "$COOLIFY_BASE_URL/api/v1/teams"

"Application not found"

Le skill ne peut pas trouver l'application que vous avez référencée.

1. Listez toutes les applications : demandez à OpenClaw "Liste toutes mes applications Coolify."
2. Vérifiez que le nom ou l'UUID de l'application correspond à ce qui figure dans votre tableau de bord Coolify.
3. Assurez-vous que votre jeton API a accès à l'équipe propriétaire de l'application.