Ajouter un outil

Chaque outil ajoute de la complexite. Avant d'en ajouter un, prouver qu'il est necessaire.

Arbre de decision

Le besoin existe ?
    |
    ├── Non → Ne rien faire
    |
    └── Oui → Un outil existant couvre le besoin ?
                |
                ├── Oui → Utiliser l'existant
                |
                └── Non → Un MCP existe pour ce service ?
                            |
                            ├── Oui → Installer le MCP
                            |
                            └── Non → Developper un MCP custom
                                       ou ajouter un outil CLI

Regle : MCP > outil CLI > code custom. Un MCP est preferable car il s'integre nativement avec les agents.

Checklist avant ajout

1. Justification

• Le besoin est documente (quel probleme, quel agent, quelle frequence)
• Aucun outil existant ne couvre le besoin (verifie dans le catalogue MCPs)
• Le cout de maintenance est acceptable
• L'outil est self-hostable ou open-source

2. Technique

• L'outil fonctionne en Docker ou CLI
• Les credentials sont stockees dans le Vault (jamais en clair)
• L'outil a une healthcheck
• L'outil a des logs exploitables
• Le rate limiting est gere (si API externe)

3. Integration

• L'outil est monte dans OpenClaw pour les agents concernes
• Les permissions sont minimales (un agent ne voit que ce dont il a besoin)
• Le fallback est defini (que faire si l'outil est down)
• Les tests d'integration passent

4. Documentation

• Page MDX dans /docs/tools/
• Ajout dans le tableau de la page Overview
• Ajout dans le catalogue MCPs (si MCP)
• Exemples d'utilisation documentes

Format de documentation

Chaque outil a sa page MDX. Structure standard :

---
title: Nom de l'outil
description: "Une phrase qui dit ce que fait l'outil."
---

# Nom de l'outil

Phrase d'intro : ce que fait l'outil, pourquoi il existe.

## Role
Bullet points : ce que l'outil fait dans le systeme.

## Installation / Config
Comment le deployer et le configurer.

## Utilisation
Commandes, exemples, cas d'usage.

## Limites
Ce que l'outil ne fait pas. Contraintes connues.

Securite

Credentials

Toutes les credentials passent par le Vault (Vaultwarden).

Agent → MCP → Vault → credential → Service externe

Jamais de token en dur dans :

• Les fichiers de config commits
• Les variables d'environnement non-chiffrees
• Les prompts agents

Permissions

Principe du moindre privilege :

Audit

Chaque nouvel outil doit repondre a ces questions :

1. Quelles donnees transitent ? (sensibles, personnelles, financieres)
2. Qui a acces ? (quels agents, quels humains)
3. Que se passe-t-il si l'outil est compromis ? (blast radius)
4. Les logs sont-ils suffisants pour investiguer un incident ?

Processus complet

1. Identifier le besoin
2. Verifier le catalogue existant
3. Choisir : MCP existant / MCP custom / outil CLI
4. Developper ou installer
5. Configurer dans OpenClaw
6. Stocker les credentials dans Vault
7. Tester (unit + integration)
8. Documenter (page MDX + catalogue)
9. Deployer en production
10. Monitorer les premieres 48h

Anti-patterns

Lecture liee

• MCPs disponibles -- catalogue existant a verifier avant d'ajouter
• Vue d'ensemble des outils -- architecture et principes
• OpenClaw -- ou monter le nouvel outil pour les agents