Anatomie d'une configuration Openclaw parfaite

Un guide complet sur les fichiers de l'espace de travail, les compétences, les canaux, les autorisations et la façon de les configurer correctement.

La plupart des utilisateurs d'OpenClaw l'installent, connectent un canal et n'ouvrent jamais le dossier de l'espace de travail.

C'est une erreur.

Votre espace de travail est le centre de contrôle du comportement de votre assistant IA. Il contient votre identité, vos compétences personnalisées, vos connexions aux canaux et votre mémoire. Une fois que vous comprenez ce qui se trouve où, vous pouvez configurer OpenClaw exactement comme vous en avez besoin.

Ce guide passe en revue l'anatomie d'une configuration parfaite.

PS : OpenClaw n'est que le début.

Au sein de notre communauté Build With AI, nous vous apprendrons à créer des agents, des applications et des automatisations personnalisés que vous pourrez utiliser vous-même ou vendre à des clients. Lancement prochain.

Rejoignez la liste d'attente ici : https://return-my-time.kit.com/1bd2720397

-----------------------------------------

Deux couches de configuration, pas une

Avant d'entrer dans le vif du sujet, une chose à savoir d'emblée : OpenClaw utilise deux couches de configuration.

La première est votre dossier d'espace de travail (généralement ~/clawd/ ou l'endroit où vous avez initialisé). Il contient votre configuration personnelle, vos compétences, votre mémoire et vos secrets.

La seconde est l'installation globale dans opt/homebrew/lib/node_modules/clawdbot/ (ou l'équivalent sur votre système). Elle contient les documents de base, les compétences intégrées et les comportements par défaut.

Votre espace de travail est l'endroit où vous personnalisez. L'installation globale est ce que vous mettez à jour.

AGENTS.md : Vos instructions de fonctionnement

C'est le fichier le plus important de toute votre configuration. Lorsqu'OpenClaw démarre une session, la première chose qu'il lit est AGENTS.md. Il le charge directement dans l'invite système et le garde en mémoire pour toute la conversation.

En termes simples : tout ce que vous écrivez dans AGENTS.md, votre agent le suivra.

Si vous lui dites de toujours vérifier votre calendrier avant de suggérer des heures de réunion, il le fera. Si vous dites « n'envoyez jamais d'e-mails sans mon approbation explicite », il respectera cela à chaque fois.

Ce qui doit réellement figurer dans AGENTS.md :

Écrire :

• Votre directive de fonctionnement principale (quel est le rôle de l'agent ?)
• Les outils clés et comment les utiliser (CLI e-mail, workflows de gestion des tâches)
• Les règles strictes à ne jamais enfreindre
• Les liens vers des ressources importantes (doc API, emplacements des compétences)
• Les déclencheurs de workflow (ce qui doit se produire automatiquement)

Ne pas écrire :

• Une documentation complète que vous pouvez plutôt lier
• De longs paragraphes expliquant la théorie
• Des informations qui changent fréquemment

Gardez AGENTS.md sous 300 lignes. Les fichiers plus longs commencent à consommer trop de contexte, et le respect des instructions diminue réellement.

Voici un exemple minimal mais efficace :

1# AGENTS.md - Espace de travail Clawdbot
2
3## Directive de fonctionnement principale
4Mon assistant agit comme un aide proactif pour mon entreprise.
5
6**Le mandat :**
7- Enlever le plus possible de ma charge de travail
8- Être proactif - ne pas attendre d'être sollicité
9
10## Outils clés
11- **E-mail :** Vérifier la boîte de réception quotidiennement, signaler les éléments urgents
12- **Calendrier :** Vérifier l'absence de conflits avant de planifier
13- **Gestionnaire de tâches :** Synchroniser le travail terminé vers le tableau de bord
14
15## Règles strictes
16- NE JAMAIS redémarrer les services sans autorisation explicite
17- Toujours vérifier les dates avec la commande `date` avant de planifier
18- Enregistrer tout le travail terminé dans le système de suivi

C'est environ 20 lignes de directives essentielles. Cela donne à votre agent tout ce dont il a besoin pour travailler de manière productive sans clarifications constantes.

SOUL.md : Persona et limites

SOUL.md définit qui est votre agent et comment il doit communiquer. C'est là que vit la personnalité.

1# SOUL.md - Persona et limites
2
3- Garder les réponses concises et directes.
4- Poser des questions de clarification si nécessaire.
5- Ne jamais envoyer de réponses partielles/streaming vers les surfaces de messagerie externes.

Si AGENTS.md est le manuel d'instructions, SOUL.md est le profil de personnalité. Certains utilisateurs écrivent ici des personas élaborés. D'autres le gardent minimal. Les deux fonctionnent, cela dépend du degré de personnalisation de la personnalité que vous souhaitez.

IDENTITY.md et USER.md : Qui est qui

Ces deux fichiers établissent la relation entre votre agent et vous.

IDENTITY.md définit votre agent :

1# IDENTITY.md - Identité de l'agent
2
3- Nom : [Nom de votre agent]
4- Créature : [Facultatif : description amusante]
5- Ambiance : Astucieux, serviable, fiable, résolveur de problèmes tenace
6- Emoji : [Votre emoji choisi]

USER.md vous définit :

1# USER.md - Profil utilisateur
2
3- Nom : [Votre nom]
4- Appellation préférée : [Surnom]
5- Fuseau horaire : [Votre fuseau horaire]
6- Téléphone : [Votre numéro]
7- Calendrier : [Plateforme de calendrier et e-mail]

Pourquoi des fichiers séparés ? Parce qu'ils servent à des fins différentes. IDENTITY.md change rarement une fois défini. USER.md se met à jour au fur et à mesure que vos préférences évoluent. Les garder séparés facilite la maintenance.

HEARTBEAT.md : Points de contrôle programmés

Ce fichier contrôle ce que fait votre agent lors des sondages heartbeat — des moments programmés où le système vérifie si quelque chose nécessite une attention.

1# HEARTBEAT.md
2
3**Si le message contient «⚠️ EXECUTION CRON » :**
4- Ce n'est PAS un check heartbeat - c'est du travail à faire
5- Lire les instructions complètes dans le message
6- Exécuter toutes les étapes requises
7- Ne jamais retourner HEARTBEAT_OK
8
9**Sinon :**
10- Si rien ne nécessite d'attention, retourner HEARTBEAT_OK
11- Rester minimal

Les heartbeats sont puissants pour créer des agents proactifs. Votre agent peut vérifier votre calendrier, analyser votre boîte de réception ou exécuter n'importe quel workflow automatisé selon un planning, le tout déclenché par des sondages heartbeat.

TOOLS.md : Documentation des outils externes

Ce fichier contient vos notes sur les outils externes et les conventions. Il ne définit pas quels outils existent (OpenClaw gère cela en interne), mais c'est là que vous documentez la façon dont VOUS les utilisez.

1# TOOLS.md - Notes utilisateur sur les outils
2
3## CLI E-mail
4- Compte : [email protected]
5- Courant : `cli email search`, `cli calendar create`
6
7## API de gestion des tâches
8- Emplacement du token : ~/.secrets/task-api-token.txt
9- Toujours utiliser `limit=100` pour éviter les problèmes de pagination
10- Conversion de statut : [documentez votre workflow spécifique]
11
12## Outil de scraping web (lorsque les sites bloquent les requêtes normales)
13- Emplacement : ~/clawd/.venv/scraper
14- Utiliser le mode furtif pour les sites protégés

Cela devient votre guide de référence personnel. Lorsque votre agent a besoin d'utiliser un outil, il consulte TOOLS.md pour vos conventions spécifiques.

Le dossier skills/ : Workflows réutilisables

Les compétences (skills) sont ce qui rend OpenClaw puissant. Chaque compétence est un workflow autonome que votre agent peut invoquer lorsque la tâche correspond à la description de la compétence.

Chaque compétence vit dans son propre sous-dossier avec un fichier SKILL.md :

1skills/
2├── meeting-prep/
3│   └── SKILL.md
4├── social-post-writer/
5│   ├── SKILL.md
6│   └── references/
7│       └── templates.md
8└── podcast-show-notes/
9    └── SKILL.md

Un SKILL.md utilise un frontmatter YAML pour décrire quand l'utiliser :

1---
2name: meeting-prep
3description: Recherche et briefing pré-appel automatisés. Utiliser lorsque l'utilisateur demande à vérifier les réunions à venir ou à préparer une réunion.
4---
5
6# Compétence Préparation de réunion
7
8## Quand déclencher :
9- L'utilisateur demande à vérifier les réunions à venir
10- Programmé pour s'exécuter toutes les 10 minutes via cron
11- Ne préparer un briefing que pour les PREMIERS APPELS
12
13## Processus :
141. Vérifier le calendrier pour les réunions dans les 15 à 45 minutes à venir
152. Rechercher les participants (LinkedIn, site web de l'entreprise)
163. Créer un document de briefing
174. Joindre le lien à l'événement du calendrier

La différence clé par rapport aux instructions statiques : les compétences peuvent regrouper des fichiers de support à côté d'elles. Le fichier references/templates.md peut contenir des exemples de sorties, des formats éprouvés ou un contexte supplémentaire qui ne se charge que lorsque la compétence est active.

Le dossier memory/ : Contexte persistant

C'est la mémoire à long terme de votre agent. Les transcriptions de session, les préférences apprises et les journaux quotidiens y sont tous stockés.

1memory/
2├── 2026-03-22.md
3├── 2026-03-21.md
4├── email-style.md
5├── business-context-2026-02.md
6└── workflow-playbook.md

Bonnes pratiques :

• Conserver les journaux quotidiens dans memory/YYYY-MM-DD.md
• Au début d'une session, votre agent lit aujourd'hui + hier si présent
• Capturer les faits durables, les préférences et les décisions
• Éviter de stocker des secrets

Les fichiers mémoire sont ce qui donne à votre agent un contexte entre les sessions. Sans eux, chaque conversation repart de zéro.

Le dossier .secrets/ : Identifiants

Les tokens API, mots de passe et configurations sensibles sont stockés ici. Ce dossier doit être dans .gitignore et jamais commité.

1.secrets/
2├── task-api-token.txt
3├── openai-api-key.txt
4├── anthropic-api-key.txt
5└── service-credentials.txt

Votre AGENTS.md ou TOOLS.md peut référencer ces chemins sans exposer les valeurs réelles.

Configuration des canaux : Où parler à votre agent

OpenClaw prend en charge plusieurs canaux de messagerie : Discord, Telegram, Signal, WhatsApp, etc. La configuration des canaux se trouve dans votre configuration de passerelle (gérée via les commandes clawdbot gateway).

Concepts clés :

• Chaque canal a son propre comportement de session
• Vous pouvez avoir plusieurs canaux actifs simultanément
• Les règles spécifiques au canal (comme « ne pas répondre sauf si @mention sur Discord ») vont dans AGENTS.md

Le tableau complet

Voici comment tout s'assemble :

1~/clawd/
2├── AGENTS.md           # Instructions de fonctionnement (utilisation quotidienne)
3├── SOUL.md             # Persona et limites
4├── IDENTITY.md         # Identité de l'agent
5├── USER.md             # Votre profil
6├── HEARTBEAT.md        # Comportement des points de contrôle programmés
7├── TOOLS.md            # Documentation des outils externes
8├── BOOTSTRAP.md        # Rituel de première exécution (supprimer après)
9│
10├── skills/             # Workflows personnalisés
11│   ├── meeting-prep/
12│   ├── podcast-show-notes/
13│   └── social-post-writer/
14│
15├── memory/             # Contexte persistant
16│   ├── 2026-03-22.md
17│   └── key-context.md
18│
19├── .secrets/           # Clés API et identifiants (gitignorés)
20│   ├── task-api-token.txt
21│   └── anthropic-api-key.txt
22│
23└── output/             # Fichiers générés et exports

Une configuration pratique pour démarrer

Si vous partez de zéro, voici une progression qui fonctionne bien.

Étape 1. Exécutez openclaw onboard et terminez la configuration initiale. Choisissez votre fournisseur de modèle et connectez au moins un canal.

Étape 2. Créez votre dossier d'espace de travail et ajoutez AGENTS.md avec vos directives principales. Commencez par 10 à 20 lignes couvrant vos principaux cas d'utilisation.

Étape 3. Ajoutez IDENTITY.md, USER.md et SOUL.md. Ceux-ci établissent la relation et la personnalité.

Étape 4. Créez votre première compétence pour un workflow que vous effectuez de manière répétée. La préparation de réunion, les brouillons d'e-mails ou la création de contenu sont de bons points de départ.

Étape 5. Mettez en place le dossier memory/ avec un modèle de journal quotidien. Votre agent commencera à construire un contexte au fil du temps.

Étape 6. Ajoutez TOOLS.md à mesure que vous découvrez des modèles spécifiques aux outils qui méritent d'être documentés.

C'est vraiment tout ce dont vous avez besoin pour 95 % des cas d'utilisation. Les fonctionnalités avancées comme les tâches cron, les configurations multi-agents et les plugins de canal personnalisés arrivent lorsque vous avez des workflows spécifiques qui méritent d'être automatisés.

Le point clé

Votre espace de travail OpenClaw est en réalité un protocole pour dire à votre assistant IA qui vous êtes, ce que vous avez besoin de faire accomplir et quelles règles il doit suivre. Plus vous définissez cela clairement, moins vous passez de temps à corriger votre agent et plus il passe de temps à faire un travail utile.

AGENTS.md est votre fichier à plus fort effet de levier. Obtenez-le d'abord correctement. Tout le reste n'est que de l'optimisation.

Commencez petit, affinez au fur et à mesure, et traitez-le comme n'importe quelle autre pièce d'infrastructure dans votre workflow : quelque chose qui rapporte des dividendes chaque jour une fois correctement configuré.

PS : OpenClaw n'est que le début.

Au sein de notre communauté Build With AI, je vous apprendrai à créer des agents, des applications et des automatisations personnalisés que vous pourrez utiliser vous-même ou vendre à des clients. Lancement prochain.

Rejoignez la liste d'attente ici :

https://return-my-time.kit.com/1bd2720397