OpenClaw en bref

Ce que fait OpenClaw#

OpenClaw est un framework open-source d'agent IA pre-installe sur chaque bureau Le Bureau. Il relie vos messages de chat a un modele IA et permet au modele d'agir sur le bureau.

Quand vous envoyez un message via le panneau de chat :

1. Le message arrive au gateway OpenClaw (port 18789).
2. Le gateway l'envoie a votre modele IA configure (Claude, GPT, etc.) avec le contexte systeme.
3. Le modele repond avec du texte et/ou des appels d'outils.
4. OpenClaw execute les appels d'outils sur le bureau : lancer des commandes, cliquer sur des elements d'interface, editer des fichiers.
5. Le resultat est renvoye au modele pour l'etape suivante.

Cette boucle continue jusqu'a ce que la tache soit terminee ou que le modele decide de s'arreter.

Le gateway#

Le gateway est un serveur HTTP local qui tourne dans la VM. Il gere le protocole de chat, maintient l'historique des conversations et orchestre l'execution des outils. Le dashboard communique avec lui via le proxy WebSocket de Le Bureau.

Le soul file#

Chaque agent OpenClaw a un soul file (SOUL.md) qui definit sa personnalite, ses instructions et ses regles de comportement. Il est cree lors de la configuration du bureau et vous pouvez le modifier.

cat ~/.openclaw/workspace/SOUL.md

Le fichier agents#

Le fichier agents (AGENTS.md) definit les outils et actions que l'agent peut utiliser sur le bureau.

cat ~/.openclaw/workspace/AGENTS.md

Configuration#

OpenClaw est configure via openclaw.json dans le repertoire .openclaw :

cat ~/.openclaw/openclaw.json

Ce fichier contient le provider et la cle API, le choix du modele, la configuration memoire/embeddings et les parametres du gateway.

Comment OpenClaw demarre#

Pendant le demarrage du bureau, cloud-init :

1. Ecrit la configuration openclaw.json a partir de vos parametres provider.
2. Cree le repertoire workspace avec les fichiers soul et agents.
3. Demarre le service gateway OpenClaw.
4. Le gateway se lie au port 18789 et commence a accepter les connexions.

Le bureau est marque agentReady uniquement apres confirmation que le gateway ecoute. Voir Agent ready pour les details.

Personnaliser votre agent#

Vous pouvez modifier le soul file et le fichier agents pour changer le comportement de votre agent :

# Editer le soul file
nano ~/.openclaw/workspace/SOUL.md

# Editer le fichier agents
nano ~/.openclaw/workspace/AGENTS.md

Les changements prennent effet a la prochaine conversation. Pas besoin de redemarrer le gateway.

Conseils#

• OpenClaw est open-source. Le code est disponible publiquement si vous voulez voir comment ca marche sous le capot.
• Le soul file est le levier de personnalisation le plus utile. Un bon soul file change vraiment la qualite des reponses de l'agent.
• Si l'agent ne se comporte pas comme prevu, verifiez d'abord le soul file. Il peut contenir des instructions qui entrent en conflit avec votre demande.