- Contexte
- Checklist des 11 points
- 1. Docker fonctionne
- 2. Vault est unseal et accessible
- 3. Les secrets sont lisibles
- 4. PostgreSQL repond
- 5. Tailscale est connecte
- 6. Node.js est la bonne version
- 7. OpenClaw est installe
- 8. La gateway tourne
- 9. Le health check passe
- 10. Tester le modele IA
- 11. openclaw doctor
- Script de verification rapide
- Diagnostic par symptome
- Si tout est vert
- Si un point reste rouge
- Temps estime
Verification post-installation
Contexte
Toutes les briques sont en place. Avant de passer au chapitre suivant, on verifie TOUT d'un coup. Si un point est rouge, le diagnostic par symptome vous dira quoi faire.
Checklist des 11 points
Executez chaque commande. Tout doit reussir.
1. Docker fonctionne
$ docker ps
Attendu : au moins 2 conteneurs (vault, postgres) en etat "Up".
2. Vault est unseal et accessible
$ docker exec vault vault status | grep Sealed
Attendu : Sealed false
3. Les secrets sont lisibles
$ docker exec vault vault kv get secret/openrouter
$ docker exec vault vault kv get secret/telegram
$ docker exec vault vault kv get secret/database
Attendu : chaque commande retourne les champs stockes.
4. PostgreSQL repond
$ docker exec postgres psql -U oa_admin -d oa_system -c "SELECT 'pg_ok';"
Attendu : pg_ok
5. Tailscale est connecte
$ tailscale status
Attendu : votre machine apparait comme connectee.
6. Node.js est la bonne version
$ node --version
Attendu : v22.x ou superieur.
7. OpenClaw est installe
$ openclaw --version
Attendu : numero de version affiche.
8. La gateway tourne
$ sudo systemctl status openclaw-gateway | grep Active
Attendu : active (running)
9. Le health check passe
$ ~/scripts/health-check.sh
Attendu : 0 echec.
10. Tester le modele IA
Verifiez que la connexion au provider IA fonctionne avec un appel simple :
$ openclaw model test
Si openclaw model test n'est pas disponible, testez directement via OpenRouter :
$ OPENROUTER_KEY=$(docker exec -e VAULT_ADDR=http://127.0.0.1:8200 vault vault kv get -field=api_key secret/openrouter)
$ curl -s https://openrouter.ai/api/v1/chat/completions \
-H "Authorization: Bearer ${OPENROUTER_KEY}" \
-H "Content-Type: application/json" \
-d '{"model":"anthropic/claude-haiku-4-5","messages":[{"role":"user","content":"Reponds juste OK"}],"max_tokens":10}' \
| python3 -m json.tool
Attendu : une reponse JSON contenant le texte "OK" (ou similaire) dans choices[0].message.content.
11. openclaw doctor
$ openclaw doctor
Attendu : tous les checks verts.
Script de verification rapide
Pour tout verifier en une commande :
$ check() { echo -n "$1: "; if eval "$2" > /dev/null 2>&1; then echo "OK"; else echo "ECHEC"; fi; }
$ echo "=== VERIFICATION COMPLETE ==="
$ check "1. Docker" "docker ps"
$ check "2. Vault unseal" "docker exec vault vault status 2>/dev/null | grep 'Sealed.*false'"
$ check "3. Vault secret" "docker exec vault vault kv get -field=api_key secret/openrouter"
$ check "4. PostgreSQL" "docker exec postgres psql -U oa_admin -d oa_system -c 'SELECT 1;'"
$ check "5. Tailscale" "tailscale status"
$ echo -n "6. Node: " && node --version
$ check "7. OpenClaw" "openclaw --version"
$ check "8. Gateway" "sudo systemctl is-active openclaw-gateway"
$ echo "=== FIN ==="
Diagnostic par symptome
Si un point echoue, voici quoi faire :
| Point | Symptome | Diagnostic |
|---|---|---|
| 1 | Docker ps erreur | sudo systemctl start docker. Si erreur persistante : journalctl -u docker -n 50. |
| 2 | Vault sealed | Normal apres redemarrage. Unseal avec 3 cles (section 07, etape 7). |
| 3 | Secret illisible | Token expire ? docker exec vault vault token lookup. Recreez si necessaire. |
| 4 | PostgreSQL ne repond pas | docker logs postgres pour voir l'erreur. Souvent un probleme de permissions sur data/. |
| 5 | Tailscale deconnecte | sudo tailscale up. Si erreur : sudo systemctl restart tailscaled. |
| 6 | Node version trop vieille | nvm install --lts && nvm alias default lts/*. |
| 7 | OpenClaw pas installe | npm install -g @anthropic-ai/claude-code. Verifiez le PATH nvm. |
| 8 | Gateway inactive | journalctl -u openclaw-gateway -n 50. Souvent un chemin incorrect dans le fichier service. |
| 9 | Health check echoue | Le script indique quel point echoue. Corrigez ce point specifique. |
| 10 | Doctor echoue | Suivez les instructions affichees par openclaw doctor. |
Si tout est vert
Felicitations. Votre infrastructure est operationnelle. Passez aux sections suivantes (17, 18, 19) pour finaliser le workflow de developpement, puis au chapitre 3.
Si un point reste rouge
Ne passez pas au chapitre suivant avec un point rouge. Chaque brique depend des precedentes. Un probleme non resolu ici deviendra un probleme plus gros plus tard.
Temps estime
10 minutes (verification seule, sans correction).
Proposer une modification sur GitHub