# 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)