Onboarding d'un agent

Deployer un agent sans preparation = des erreurs garanties. Chaque nouvel agent passe par 4 phases avant d'etre autonome.

Phase 1 : Avant deploiement

Definir le SOUL.md

Chaque agent a un fichier SOUL.md qui definit :

Verifier les prerequis

• Le SOUL.md est redige et revu
• Les MCPs necessaires sont installes et fonctionnels
• Les API keys sont configurees
• L'agent a un espace de travail (~/.openclaw/workspace/agents/{nom}/)
• Le CEO connait l'existence de l'agent (enregistre dans l'org chart)

Phase 2 : Integration

Enregistrer l'agent

openclaw agent register social-manager --soul ./SOUL.md

Configurer les permissions

Chaque agent a des permissions explicites.

{
  "agent": "social-manager",
  "permissions": {
    "read": ["notion:social-calendar", "openmemory:preferences"],
    "write": ["twitter:post", "instagram:post"],
    "execute": ["schedule-post", "analyze-engagement"],
    "forbidden": ["trading:*", "deploy:*", "finance:*"]
  }
}

!!! warning "Principe du moindre privilege" Un agent n'a acces qu'a ce dont il a besoin. Rien de plus. Les permissions forbidden sont des garde-fous explicites.

Connecter au CEO

Le CEO doit pouvoir :

• Envoyer des taches a l'agent
• Recevoir les rapports de l'agent
• Interrompre l'agent si necessaire

openclaw agent link social-manager --manager ceo

Phase 3 : Periode de rodage

Duree recommandee : 5 a 10 jours.

Niveau d'autonomie reduit

Pendant le rodage, l'agent fonctionne au niveau 1-2. Il demande validation pour TOUT.

Observer les patterns

Pendant le rodage, noter :

• L'agent comprend-il bien les instructions ?
• Les outputs sont-ils de qualite ?
• Y a-t-il des erreurs recurrentes ?
• L'agent escalade-t-il correctement ?

Corriger et affiner

Chaque correction est enregistree dans OpenMemory.

Correction #1 : "Les tweets sont trop longs. Max 200 caracteres."
Correction #2 : "Ne pas poster le dimanche."
Correction #3 : "Toujours ajouter un emoji au debut du post."

Ces corrections deviennent des regles permanentes.

Phase 4 : Validation finale

Apres le rodage, l'utilisateur valide que l'agent est pret.

Checklist de validation

• L'agent produit des outputs de qualite constante
• Les corrections ont ete integrees (pas de regression)
• L'agent escalade correctement (ni trop, ni trop peu)
• Les MCPs fonctionnent sans erreur
• La consommation de tokens est dans l'estimation
• Le CEO recoit bien les rapports de l'agent

Montee en autonomie

Si tout est valide, monter le niveau d'autonomie progressivement.

openclaw agent autonomy social-manager --level 5

!!! tip "Monter par palier" Ne pas passer de 2 a 8 d'un coup. Monter de 1 a chaque fois. Observer le comportement pendant 3 jours avant de remonter.

Documenter

• Ajouter l'agent dans l'org chart
• Documenter les regles specifiques dans la KB
• Ajouter les crons associes dans la vue d'ensemble
• Logger l'onboarding dans le changelog

Les 40 agents du blueprint

Le blueprint V5 prevoit 40 agents. Chacun passera par ce processus. Priorite de deploiement :

Lecture liee

• Lancer un projet pour le contexte de creation
• Gestion des erreurs quand un agent echoue
• Niveaux d'autonomie pour comprendre l'echelle