before gemiin

2026-02-22 22:18:32 +01:00
parent fb33540bb0
commit 9db5cbf236
147 changed files with 7948 additions and 531 deletions
@@ -0,0 +1,84 @@
+# 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):
+
+```bash
+mkdir -p <OPENCLAW_SKILLS_DIR>
+cp -R skills/jardin-api-backend <OPENCLAW_SKILLS_DIR>/
+```
+
+Exemple fréquent:
+
+```bash
+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):
+
+```bash
+docker cp skills/jardin-api-backend <OPENCLAW_CONTAINER>:/app/skills/jardin-api-backend
+```
+
+Puis redémarrer le service OpenClaw:
+
+```bash
+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é:
+
+```bash
+curl http://<IP_HOTE>:8060/api/health
+```
+
+Réponse attendue:
+
+```json
+{"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)