jardin/skills/jardin-api-backend/consigne.md

Consigne d'installation du skill OpenClaw

Ce guide installe le skill jardin-api-backend pour l'utiliser dans OpenClaw.

1) Pré-requis

• Le backend Jardin est accessible en LAN, par exemple: http://192.168.1.50:8060
• Le dossier du skill existe localement:
  • skills/jardin-api-backend/
• Le skill contient:
  • SKILL.md
  • agents/openai.yaml
  • references/backend-api-recipes.md

2) Installation (machine locale)

Si OpenClaw lit les skills depuis un dossier local, copier le skill dans ce dossier.

Exemple (adapter le chemin cible):

mkdir -p <OPENCLAW_SKILLS_DIR>
cp -R skills/jardin-api-backend <OPENCLAW_SKILLS_DIR>/

Exemple fréquent:

mkdir -p ~/.codex/skills
cp -R skills/jardin-api-backend ~/.codex/skills/

3) Installation (OpenClaw en conteneur Docker)

Copier le dossier dans le conteneur OpenClaw (adapter nom conteneur et chemin):

docker cp skills/jardin-api-backend <OPENCLAW_CONTAINER>:/app/skills/jardin-api-backend

Puis redémarrer le service OpenClaw:

docker restart <OPENCLAW_CONTAINER>

4) Vérification

1. Ouvrir OpenClaw.
2. Vérifier que le skill Jardin API Backend apparaît dans la liste des skills.
3. Lancer un test avec une requête simple:
   • "Teste l'API backend et donne-moi les appels pour créer un jardin puis une plante."

Le skill doit proposer des appels API structurés avec:

• URL complète (http://<IP_HOTE>:8060/...)
• méthode HTTP
• headers
• payload JSON/multipart
• mapping des IDs à réutiliser

5) Test API rapide recommandé

Depuis la VM/OpenClaw, valider d'abord la connectivité:

curl http://<IP_HOTE>:8060/api/health

Réponse attendue:

{"status":"ok"}

6) Dépannage rapide

• Skill non visible:
  • vérifier la présence de SKILL.md et agents/openai.yaml
  • vérifier le chemin de scan des skills OpenClaw
  • redémarrer OpenClaw
• Erreur API:
  • vérifier IP/port backend (8060)
  • vérifier le pare-feu LAN
  • vérifier CORS seulement si appel depuis navigateur (pas nécessaire en serveur-à-serveur)