Section 4 : Création de vos fichiers d'agent

Ce que vous construisez

Chaque agent a besoin d'un ensemble de fichiers pour fonctionner correctement. OpenClaw lit les fichiers principaux automatiquement au démarrage de la session. Des fichiers d'espace de travail supplémentaires donnent à chaque agent son contexte, ses tâches planifiées et ses règles d'outils.

Configuration de l'agent — lue par OpenClaw :

Fichier	Emplacement	Rôle
`config.json`	`agents/[id]/config.json`	Définition de l'agent OpenClaw, invite système
`models.json`	`agents/[id]/models.json`	Paramètres du modèle IA

Fichiers d'espace de travail — chargés automatiquement par OpenClaw à chaque session :

Fichier	Rôle
`SOUL.md`	Personnalité, ton, limites absolues, mission — garder sous 400 mots
`AGENTS.md`	Règles de fonctionnement, procédures de rapport — garder sous 400 mots
`IDENTITY.md`	Nom, rôle, à qui ils rendent compte — faits uniquement, garder court
`HEARTBEAT.md`	Tâches permanentes, tâches planifiées, réponse aux anomalies
`TOOLS.md`	Outils autorisés, règles de compétences, actions interdites
`USER.md`	Préférences du Commandant, style de communication, fuseau horaire

Fichier de détail de rôle — lu une fois par session via l'instruction AGENTS.md :

Fichier	Rôle
`SPEC_[NOM].md`	Rôle détaillé, responsabilités, chemins clés

PDG uniquement — dossier d'identité :

Fichier	Rôle
`identity/COMPANY_PROFILE.md`	Contexte de l'entreprise, informations commerciales
`identity/PERSONAL_PROFILE.md`	Parcours du propriétaire, compétences, expérience
`identity/VALUES.md`	Style de pensée, valeurs, principes de décision

Structure complète de l'espace de travail — tous les agents :

INFO

$env:USERPROFILE/.opengoat/ ├── agents/ │ └── [agentid]/ │ ├── config.json ← OpenClaw lit ce fichier │ └── models.json └── workspaces/ └── [agentid]/ ├── SOUL.md ← chargé automatiquement ├── AGENTS.md ← chargé automatiquement ├── IDENTITY.md ← chargé automatiquement ├── HEARTBEAT.md ← chargé automatiquement ├── TOOLS.md ← chargé automatiquement ├── USER.md ← chargé automatiquement └── SPEC_[NOM].md ← lu via l'instruction AGENTS.md

Espace de travail PDG — dossier d'identité supplémentaire :

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ├── PERSONAL_PROFILE.md └── VALUES.md

Comment Fonctionne la Section 4

Dans cette section, vous travaillerez avec votre AI concierge pour concevoir chaque agent. Pour chaque agent, vous déciderez :

Nom et rôle
Personnalité et style de communication
Quels outils il peut utiliser

Une fois le design finalisé avec votre AI concierge, votre Security Guardian écrira automatiquement les fichiers de configuration. Vous n'avez pas besoin d'éditer les fichiers manuellement.

Comment fonctionne cette section — Deux parties

Cette section comporte deux parties. Complétez-les dans l'ordre :

Partie 1 — Configuration Discord (l'invite ci-dessous) Créez votre serveur Discord, vos canaux et obtenez les URLs Webhook pour chaque agent. Cela prend environ 10 minutes.

Partie 2 — Fichiers d'agent (l'invite suivante) Générez les fichiers d'agent réels à partir de votre Document de conception d'équipe. L'IA génère des commandes de terminal — collez-les dans VS Code pour créer les fichiers automatiquement.

Commencez par la Partie 1 maintenant.

URLs Webhook Discord — Obtenez-les en premier

Chaque agent rend compte à son propre canal Discord via une URL Webhook. Vous en avez besoin avant d'écrire les fichiers AGENTS.md.

▶ Collez ceci dans votre IA pour commencer

Joignez votre Document de conception d'équipe avant d'envoyer.

Vous m'aidez à configurer des canaux Discord et des URLs Webhook pour mon
équipe multi-agent BALIA OS.

Guidez-moi étape par étape. Posez une question à la fois.
Si je suis bloqué, demandez-moi de faire une capture d'écran et de décrire ce que je vois.

J'ai joint mon Document de conception d'équipe.

ÉTAPE 1 — Vérifier Discord
Demandez : « Avez-vous Discord installé et un compte configuré ? »
Si non : guidez-moi vers discord.com pour télécharger et créer un compte.
Si oui : passez à l'Étape 2.

ÉTAPE 2 — Créer un serveur Discord
Guidez-moi pour créer un nouveau serveur :
- Cliquez sur le bouton + dans la barre latérale gauche
- Sélectionnez « Créer le mien » -> « Pour moi et mes amis »
- Nommez-le « BALIA OS Team »
Confirmez que je peux le voir avant de continuer.

ÉTAPE 3 — Créer des canaux pour chaque agent
Lisez mon Document de conception d'équipe pour les noms de canaux.
Pour chaque agent, créez un canal textuel :
- Clic droit sur « Canaux textuels » -> Ajouter un canal -> Texte
- Utilisez le nom de canal de mon Document de conception d'équipe
Répétez pour les 6 agents. Confirmez que tous les canaux existent avant de continuer.

ÉTAPE 4 — Obtenir une URL Webhook pour chaque canal
Un canal à la fois :
1. Clic droit sur le canal -> Modifier le canal
2. Intégrations -> Webhooks -> Nouveau Webhook
3. Nommez-le d'après l'agent (ex. « Marcus »)
4. Copiez l'URL Webhook
5. Demandez-moi de la coller quelque part en sécurité
Répétez pour les 6. Confirmez que les 6 URLs sont sauvegardées avant de continuer.

ÉTAPE 5 — Ajouter au fichier .env
Guidez-moi pour ouvrir le fichier .env dans VS Code.
Le fichier se trouve à :
- Windows : $env:USERPROFILE\.opengoat\.env
- Mac : ~/.opengoat/.env
Ajoutez chaque webhook :
DISCORD_WEBHOOK_[NOMAGENT]=https://discord.com/api/webhooks/xxxxx/xxxxx
(Noms d'agents en MAJUSCULES)
Dites-moi : « Ne partagez jamais ce fichier. Ne le commitez jamais sur GitHub. »

Quand tous les webhooks sont sauvegardés : « Configuration Discord terminée. »

Commencez maintenant. Posez-moi la première question.

Utilisation de l'invite IA

Collez l'invite ci-dessous dans votre IA de chat et joignez :

Votre Document de conception d'équipe de la Section 2

L'IA génère des commandes de terminal pour chaque agent une à la fois. Collez les commandes dans votre terminal VS Code pour créer les fichiers automatiquement.

▶ Collez ceci dans votre IA pour commencer

Vous m'aidez à créer des fichiers d'agent pour BALIA OS,
un OS IA multi-agent construit sur OpenClaw.

Joints :
1. Mon Document de conception d'équipe (de la Section 2)

Lisez-le avant de générer quoi que ce soit.
Extrayez tous les noms d'agents, IDs et noms de canaux Discord de ce document.

ARCHITECTURE :

1. Je suis le Commandant. Je commande chaque agent directement. Pas d'orchestrateur.

2. Chaque agent a deux emplacements :
   - agents/[id]/ — configuration OpenClaw (config.json + models.json)
   - workspaces/[id]/ — fichiers d'espace de travail (SOUL, AGENTS, IDENTITY, HEARTBEAT, TOOLS, USER, SPEC)
   Tous les chemins sont sous $env:USERPROFILE/.opengoat/

3. OpenClaw injecte automatiquement SOUL.md, AGENTS.md, IDENTITY.md, HEARTBEAT.md,
TOOLS.md, USER.md à chaque début de session. Ne pas y écrire d'instructions du type "lis-toi toi-même".

4. SPEC_[NOM].md n'est PAS injecté automatiquement. Ajouter dans AGENTS.md sous Début de session :
   "Lire SPEC_[NOMAGENT].md pour le détail complet du rôle"

5. Le PDG dispose uniquement d'un dossier identity/ dans workspaces/ceo/ :
   identity/COMPANY_PROFILE.md
   identity/PERSONAL_PROFILE.md
   identity/VALUES.md
   Générer ces fichiers uniquement pour l'agent PDG.

6. SOUL.md et AGENTS.md : moins de 400 mots chacun (injectés à chaque session).
   SPEC : peut être détaillé (lu une fois par session).

AVANT DE GÉNÉRER — me demander :
"Quel est votre nom d'utilisateur Windows ? (Le nom dans C:\Users\[nom_utilisateur])"
Attendre ma réponse, puis utiliser ce nom d'utilisateur dans tous les chemins de fichiers.

GÉNÉRER POUR CHAQUE AGENT :

====================================
FICHIER 1 : SOUL.md
Chemin : $env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md
Injecté automatiquement à chaque session. Moins de 400 mots.
====================================

# SOUL.md — [Nom de l'agent]

## Qui Vous Êtes
[2-3 phrases : identité, personnalité, approche du travail]

## Ton
- [Règle 1]
- [Règle 2]
- [Règle 3]
- [Style interdit]

## Limites Absolues
- Ne jamais agir en dehors du rôle défini
- Ne jamais déclarer une tâche terminée sans en avoir vérifié le résultat
- Ne jamais effectuer une action destructrice sans l'approbation du Commandant
- [1-2 limites spécifiques au rôle]

## Mission Actuelle
[1-2 phrases sur l'objectif en cours]

====================================
FICHIER 2 : AGENTS.md
Chemin : $env:USERPROFILE/.opengoat/workspaces/[agentid]/AGENTS.md
Injecté automatiquement à chaque session. Moins de 400 mots.
====================================

# AGENTS.md — Procédures opérationnelles de [Nom de l'agent]

## Début de session (Chaque session — dans cet ordre)
1. Confirmer l'identité depuis SOUL.md
2. Lire SPEC_[NOMAGENT].md pour le détail du rôle
3. Lire HEARTBEAT.md — noter les tâches planifiées
4. Lire TOOLS.md — noter les outils autorisés et les restrictions
5. Lire USER.md — noter les préférences du Commandant
6. Signaler sur Discord : "🔷 [Nom] prêt(e). [tâche en cours ou statut]"

(PDG uniquement — après l'étape 2, lire également :
  identity/COMPANY_PROFILE.md
  identity/PERSONAL_PROFILE.md
  identity/VALUES.md)

## Fin de session (Chaque session)
1. Signaler sur Discord : "✅ Session [Nom] terminée. [résumé]"
2. Noter les tâches non terminées pour la prochaine session

## Rapports
- Canal : #[canal-discord]
- Commande : python $env:USERPROFILE/.opengoat/scripts/discord_send.py
  DISCORD_WEBHOOK_[NOM] "message"
  (discord_send.py est déployé automatiquement dans la section Gardien de sécurité ci-dessous)
- HTTP 204 = succès. Sinon = signaler l'échec immédiatement.
- Format : Conclusion -> Détail -> Prochaine action recommandée
- Signaler à : début de session / tâche terminée / erreur / fin de session

## Gestion des erreurs
1. Consulter SPEC_[NOM].md pour les schémas d'erreurs connus
2. Non résolu -> signaler tous les détails au Commandant
3. Pas de nouvelles tentatives destructrices sans l'approbation du Commandant

## Règles Absolues
- Vérifier avant de déclarer une tâche terminée
- Aucune action en dehors du rôle défini
- Aucune opération destructrice sans l'approbation du Commandant

====================================
FICHIER 3 : IDENTITY.md
Chemin : $env:USERPROFILE/.opengoat/workspaces/[agentid]/IDENTITY.md
Injecté automatiquement. Faits uniquement, rester concis.
====================================

# IDENTITY.md

Nom : [Nom de l'agent]
ID agent : [agentid-minuscules]
Rôle : [Intitulé du rôle]
Département : Équipe BALIA OS
Responsable : Commandant (directement)
Discord : #[nom du canal]

====================================
FICHIER 4 : HEARTBEAT.md
Chemin : $env:USERPROFILE/.opengoat/workspaces/[agentid]/HEARTBEAT.md
Injecté automatiquement. Tâches planifiées et réponse aux anomalies.
====================================

# HEARTBEAT.md — [Nom de l'agent]

## Toujours Actif
[Ce que cet agent surveille ou maintient en continu]

## Tâches Planifiées
[Tâches récurrentes — quotidiennes, hebdomadaires ou déclenchées]

## Au Début de Session
- Lire SOUL.md et AGENTS.md
- Signaler : "🔷 [Nom] prêt(e)"

## En Cas d'Erreur ou d'Anomalie
- Signaler immédiatement au Commandant via Discord
- Ne jamais se corriger soi-même sans l'approbation du Commandant

====================================
FICHIER 5 : TOOLS.md
Chemin : $env:USERPROFILE/.opengoat/workspaces/[agentid]/TOOLS.md
Injecté automatiquement. Règles et restrictions des outils.
====================================

# TOOLS.md — Règles d'outils de [Nom de l'agent]

## Principe Fondamental
- Consulter SPEC_[NOM].md avant chaque tâche pour les outils autorisés
- Charger uniquement ce que la tâche requiert

## Outils Autorisés
[Liste des outils pertinents pour le rôle de cet agent]

## Rapports Discord
Toujours utiliser discord_send.py directement :
python $env:USERPROFILE/.opengoat/scripts/discord_send.py DISCORD_WEBHOOK_[NOM] "message"
Confirmer HTTP 204 après l'envoi.

## Interdit
- Coder en dur les clés API ou les Webhooks (toujours lire depuis .env)
- Actions en dehors du rôle défini
- Communications externes non nécessaires

====================================
FICHIER 6 : USER.md
Chemin : $env:USERPROFILE/.opengoat/workspaces/[agentid]/USER.md
Injecté automatiquement. Préférences du Commandant.
====================================

# USER.md — Profil du Commandant

## Nom
[Nom préféré du Commandant]

## Fuseau Horaire
[Fuseau horaire — me demander si absent du Document de conception d'équipe]

## Style de Communication
- [Préférence 1]
- [Préférence 2]

## Phase Actuelle
[Ce sur quoi nous nous concentrons actuellement]

====================================
FICHIER 7 : SPEC_[NOMAGENT].md
Chemin : $env:USERPROFILE/.opengoat/workspaces/[agentid]/SPEC_[NOMAGENT].md
Non injecté automatiquement. Lu une fois par session via AGENTS.md.
====================================

# SPEC_[NOMAGENT] v1.0 — [Nom de l'agent] ([Rôle])
Dernière mise à jour : [aujourd'hui]

## 1. Rôle
[2-3 phrases]

## 2. Responsabilités
[Liste à puces tirée du Document de conception d'équipe]

## 3. Ce que Cet Agent Ne Fait PAS
[Limites clairement définies]

## 4. Mission de la Phase Actuelle
[Objectif en cours]

## 5. Chemins Clés
- Espace de travail : $env:USERPROFILE/.opengoat/workspaces/[agentid]/
- Webhook Discord : DISCORD_WEBHOOK_[NOM] (lire depuis .env)

## 6. Journal des modifications
| Version | Date | Modifications |
|---------|------|---------------|
| v1.0 | [aujourd'hui] | Création initiale |

====================================
PDG UNIQUEMENT — FICHIERS 8, 9, 10 : dossier identity/
Poser ces 3 questions une à la fois avant de générer.
====================================
Q1: "Parlez-moi de votre entreprise — ce qu'elle fait, depuis combien de temps elle existe, quels marchés elle sert."

Q2: "Parlez-moi de vous — votre parcours, vos compétences, votre expérience pertinente pour cette entreprise."

Q3: "Comment prenez-vous vos décisions ? Quelles valeurs vous guident ? Quels styles de pensée ou perspectives aimeriez-vous avoir davantage ?"

Après les 3 réponses, générez :

COMPANY_PROFILE.md — contenu de Q1, structuré
PERSONAL_PROFILE.md — contenu de Q2, structuré
VALUES.md — contenu de Q3, structuré

Chemin : $env:USERPROFILE/.opengoat/workspaces/ceo/identity/

Plus les détails fournis sont précis, plus le PDG pense et
décide comme le propriétaire.

====================================

COMMENT LIVRER LES FICHIERS :

Après avoir généré le contenu de chaque fichier, produisez les commandes
python exactes pour créer le fichier. Format :

--- COLLER DANS LE TERMINAL (Windows) ---
python -c "
content = '''[contenu complet du fichier ici]'''
import os
path = r'$env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md'
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

--- COLLER DANS LE TERMINAL (Mac) ---
python3 -c "
content = '''[contenu complet du fichier ici]'''
import os
path = os.path.expanduser('~/.opengoat/workspaces/[agentid]/SOUL.md')
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

Attendez que je colle la commande et confirme son exécution avant de
passer au fichier suivant. Demandez : "Avez-vous vu 'Created: [chemin]' ?"

COMMENT PROCÉDER :
- Commencez par l'Agent n°1 (pas le PDG)
- Générez un fichier à la fois, un agent à la fois
- Attendez toujours la confirmation du terminal avant le fichier suivant
- Lorsque vous arrivez au PDG : posez d'abord les 3 questions d'identité,
  puis générez 7 fichiers principaux + 3 fichiers d'identité
- Terminez par un tableau récapitulatif de tous les fichiers créés

Une fois que votre AI concierge a confirmé le design, demandez au Security Guardian d'écrire les fichiers :

Windows:

openclaw agent --agent security-guardian "Write the confirmed agent config to the correct path and verify the file was created."

Guardian confirmera quand les fichiers seront correctement écrits.

Étape 2 — Confirmer que les fichiers ont été créés

Une fois que l'IA vous a guidé à travers tous les fichiers, confirmez l'espace de travail de chaque agent :

Windows :

dir $env:USERPROFILE\.opengoat\workspaces\[agentid]

Mac :

ls ~/.opengoat/workspaces/[agentid]

Vous devriez voir :

SOUL.md
AGENTS.md
IDENTITY.md
HEARTBEAT.md
TOOLS.md
USER.md
SPEC_[NAME].md

Le PDG dispose en plus de :

identity/
├── COMPANY_PROFILE.md
├── PERSONAL_PROFILE.md
└── VALUES.md

Étape 3 — Vérifier avant de passer à l'agent suivant

Ouvrez AGENTS.md. La section Démarrage de session liste-t-elle toutes les étapes, y compris HEARTBEAT.md, TOOLS.md et USER.md ?

Oui → passez à la suite. Non → demandez à l'IA de le corriger d'abord.

Lorsque cette section est terminée

Espace de travail de chaque agent :

INFO

workspaces/[agentid]/ ├── SOUL.md ✅ ├── AGENTS.md ✅ ├── IDENTITY.md ✅ ├── HEARTBEAT.md ✅ ├── TOOLS.md ✅ ├── USER.md ✅ └── SPEC_[NAME].md ✅

Le PDG dispose en plus de :

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ✅ ├── PERSONAL_PROFILE.md ✅ └── VALUES.md ✅

Remarque : Le Gardien de Sécurité a été déployé dans la Section 3. Si tu as sauté la Section 3, reviens et complète-la avant de passer à la Section 5.

Vérifier Ta Configuration

Une fois que tu as terminé tous les fichiers des agents, exécute :

Windows :

node $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\verify_setup.js --section 4

Mac :

node ~/.opengoat/workspaces/security-guardian/scripts/verify_setup.js --section 4

Cela confirme que tous les fichiers des agents sont en place avant de lancer ton équipe dans la Section 5.

Ce que vous construisez ​

Comment Fonctionne la Section 4 ​

Comment fonctionne cette section — Deux parties ​

URLs Webhook Discord — Obtenez-les en premier ​

▶ Collez ceci dans votre IA pour commencer

Utilisation de l'invite IA ​

▶ Collez ceci dans votre IA pour commencer

Étape 2 — Confirmer que les fichiers ont été créés ​

Étape 3 — Vérifier avant de passer à l'agent suivant ​

Lorsque cette section est terminée ​

Vérifier Ta Configuration ​

Ce que vous construisez

Comment Fonctionne la Section 4

Comment fonctionne cette section — Deux parties

URLs Webhook Discord — Obtenez-les en premier

Utilisation de l'invite IA

Étape 2 — Confirmer que les fichiers ont été créés

Étape 3 — Vérifier avant de passer à l'agent suivant

Lorsque cette section est terminée

Vérifier Ta Configuration