Ce qui se passe dans cette section

Vous allez enregistrer chaque agent auprès d'OpenClaw et leur donner leur première commande. À la fin, les 6 agents seront actifs — ils enverront des rapports sur leurs canaux Discord et seront prêts à recevoir vos instructions.

Deux façons de communiquer avec vos agents :

Méthode	Idéale pour	Comment ça fonctionne
OpenGoat UI	Débutants — interface visuelle	Tableau de bord dans le navigateur, cliquez pour sélectionner un agent, tapez votre message
Terminal VS Code	Recommandé — plus rapide, plus de contrôle	openclaw agent --agent [id] "votre message"

Les deux méthodes fonctionnent. Commencez par celle qui vous semble la plus accessible.

Approche recommandée — hybride avec l'IA : Lorsque vous débutez, gardez une fenêtre de chat Claude, ChatGPT ou Gemini ouverte en parallèle de vos agents. Si une commande ne fonctionne pas ou si vous ne savez pas quoi taper, décrivez simplement la situation à l'IA et demandez-lui de l'aide. C'est exactement ainsi que la plupart des gens — y compris l'équipe BALIA OS — ont commencé. Vous n'avez pas besoin de maîtriser le terminal dès le premier jour. La fenêtre de chat IA est toujours là comme co-pilote.

---

Comment fonctionne cette section

Collez l'invite ci-dessous dans Claude, ChatGPT ou Gemini. L'IA vous guidera pour enregistrer les 6 agents et envoyer votre première commande à chacun d'eux. Joignez votre Document de conception d'équipe afin que l'IA connaisse vos identifiants d'agents et vos chemins de workspace.

Si quelque chose ne va pas, décrivez l'erreur ou prenez une capture d'écran et partagez-la — l'IA vous aidera à résoudre le problème.

---

▶ Collez ceci dans votre IA pour commencer

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

You are helping me register and launch my BALIA OS multi-agent team 
on OpenClaw.

I have attached my Team Design Document. Read it to get my agent IDs,
names, and workspace paths before starting.

My balia-os path is set in my .env file as BALIA_OS_PATH.
Please ask me to open my .env file and read the value of BALIA_OS_PATH,
then use that path throughout this session.

Guide me step by step. One step at a time. If I hit an error,
help me fix it before moving on. If I get stuck, ask me to share
a screenshot or paste the error message.

Here is what we need to do:

STEP 1 — Start the gateway
Tell me: "We'll start the OpenClaw gateway with a command that filters 
out noisy background logs so the terminal stays readable."

Guide me to open a new VS Code terminal tab and run the correct command 
for my OS (ask me which OS I'm on if you don't know yet):

Windows:
  $env:DEBUG="-ciao*"; openclaw gateway --force

Mac:
  DEBUG="-ciao*" openclaw gateway --force

Explain what this does:
"The DEBUG='-ciao*' part hides background network discovery logs that 
would otherwise flood the terminal. The --force flag clears any 
previous gateway instance. Your terminal will stay clean and readable."

Ask me to confirm I see: "✓ Gateway running on port 18789"
Tell me to leave this terminal tab open — the gateway must keep running.
If there's an error, help me fix it before moving on.

STEP 2 — Register each agent with OpenClaw
For each of my 6 agents (read IDs from Team Design Document),
guide me to run this command in the VS Code terminal:

openclaw agents add [agentid] --workspace ~/.opengoat/workspace-[agentid]

Example: openclaw agents add marcus --workspace ~/.opengoat/workspace-marcus

Show me all 6 commands at once with my actual agent IDs filled in.
Ask me to run them one by one and confirm each succeeds before 
showing the next one.

After all 6 are registered, guide me to verify:
openclaw agents list
Ask me to confirm all 6 agents appear in the list.

STEP 3 — Restart the gateway
After registering agents, the gateway needs to restart to load them.
Guide me to run:
openclaw gateway restart
Ask me to confirm the gateway is running again before moving on.

STEP 4 — Send first command via VS Code terminal (recommended)
Explain this first:
"The VS Code terminal is the recommended way to talk to your agents.
The command is:
openclaw agent --agent [agentid] 'your message here'

This sends a message directly to that specific agent."

Guide me to send a test command to the first agent:
openclaw agent --agent [first-agentid] 'Please introduce yourself and 
confirm you have read your SOUL.md, AGENTS.md, and IDENTITY.md. 
Then report to your Discord channel that you are online.'

Ask me: "What did the agent respond? 
Did you see a message appear in its Discord channel?"
If yes: great — move to next agent.
If no: help me troubleshoot.

Repeat for all 6 agents.

STEP 5 — (Optional) OpenGoat UI setup
After all agents are confirmed working via terminal, offer:
"You can also talk to your agents through the OpenGoat UI — 
a visual browser dashboard.
Would you like to set that up as well?
It gives you a clickable interface to select agents and send messages
without typing terminal commands."
If yes: guide me to:
1. Open a new VS Code terminal tab
2. Run: opengoat start
3. The browser will open automatically with the OpenGoat UI
Walk me through the interface — how to select an agent and send a message.
(If the browser doesn't open automatically, go to http://localhost:18789)
If no: skip and move to Step 6.

STEP 6 — Final confirmation
Run through this checklist with me:
□ All 6 agents registered (openclaw agents list shows all 6)
□ Gateway running (port 18789)
□ Each agent responded to first command
□ Each agent posted to their Discord channel
□ (Optional) OpenGoat UI accessible at localhost:18789

When all boxes are checked, say:
"Your BALIA OS team is live. All 6 agents are running and reporting 
to Discord. You're ready for Section 6 — Building Your First 
Skill Cassette."

Start now. Ask me the first question.

---

Communiquer avec vos agents au quotidien

Une fois tout configuré, voici comment donner des commandes :

Démarrer la passerelle (à faire en premier, à chaque session) :

Windows :

$env:DEBUG="-ciao*"; openclaw gateway --force

Mac :

DEBUG="-ciao*" openclaw gateway --force

Laissez cet onglet de terminal ouvert. Ouvrez un nouvel onglet pour les autres commandes.

Via le terminal VS Code :

# Talk to a specific agent
openclaw agent --agent marcus "Summarize what you worked on today"

# Check agent list
openclaw agents list

# Restart gateway if needed
openclaw gateway restart

Via OpenGoat UI :

1. Ouvrez un nouvel onglet de terminal VS Code
2. Exécutez : opengoat start
3. Le navigateur s'ouvre automatiquement avec l'interface OpenGoat UI
4. Sélectionnez un agent dans le panneau de gauche
5. Tapez votre message et appuyez sur Entrée (Si le navigateur ne s'ouvre pas automatiquement : rendez-vous sur http://localhost:18789)

Via Discord (rapports uniquement — pas pour les commandes) : Discord est l'endroit où vos agents publient leurs rapports. Vous y consultez leurs mises à jour. Envoyer des commandes aux agents via Discord nécessite un Discord Bot — il s'agit d'une configuration avancée non couverte dans T1. Utilisez le terminal VS Code ou OpenGoat UI pour donner des commandes pour l'instant.

---

Si un agent ne répond pas

Vérifiez ces points dans l'ordre :

1. La passerelle est-elle en cours d'exécution ?

   openclaw gateway restart

2. L'agent est-il enregistré ?

   openclaw agents list

   Si votre agent n'est pas dans la liste, relancez la commande agents add de l'étape 2.

3. Les fichiers du workspace sont-ils au bon endroit ? Vérifiez que SOUL.md, AGENTS.md et IDENTITY.md existent dans : ~/.opengoat/workspace-[agentid]/

4. La clé API est-elle correctement définie ? Ouvrez .env et confirmez que ANTHROPIC_API_KEY est renseignée.

Si vous êtes toujours bloqué, collez le message d'erreur dans Claude, ChatGPT ou Gemini et demandez de l'aide.