85 lines
2.0 KiB
Markdown
85 lines
2.0 KiB
Markdown
# 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)
|