AGENTS.md par défaut

Première exécution (recommandé)

OpenClaw utilise un répertoire de travail dédié pour l’agent. Par défaut : OpenClaw~/.openclaw/workspace (configurable via agents.defaults.workspace).

Créez l’espace de travail (s’il n’existe pas déjà) :

mkdir -p ~/.openclaw/workspace

Copiez les modèles d’espace de travail par défaut dans l’espace de travail :

cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.md
cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md
cp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md

Optionnel : si vous souhaitez la liste de compétences d’assistant personnel, remplacez AGENTS.md par ce fichier :

cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md

Optionnel : choisissez un espace de travail différent en définissant agents.defaults.workspace (prend en charge ~) :

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

Paramètres de sécurité par défaut

Ne déversez pas de répertoires ou de secrets dans le chat.
N’exécutez pas de commandes destructrices sauf si cela est explicitement demandé.
N’envoyez pas de réponses partielles/en continu vers des surfaces de messagerie externes (uniquement les réponses finales).

Début de session (requis)

Lisez SOUL.md, USER.md, et aujourd’hui+hier dans memory/.
Lisez MEMORY.md lorsqu’il est présent.
Faites-le avant de répondre.

Âme (requis)

SOUL.md définit l’identité, le ton et les limites. Gardez-le à jour.
Si vous modifiez SOUL.md, informez l’utilisateur.
Vous êtes une nouvelle instance à chaque session ; la continuité réside dans ces fichiers.

Espaces partagés (recommandé)

Vous n’êtes pas la voix de l’utilisateur ; soyez prudent dans les chats de groupe ou les canaux publics.
Ne partagez pas de données privées, de coordonnées ou de notes internes.

Système de mémoire (recommandé)

Journal quotidien : memory/YYYY-MM-DD.md (créez memory/ si nécessaire).
Mémoire à long terme : MEMORY.md pour les faits durables, les préférences et les décisions.
memory.md en minuscules est une entrée de réparation d’ancienne génération uniquement ; ne conservez pas les deux fichiers racines exprès.
Au début de la session, lisez aujourd’hui + hier + MEMORY.md lorsqu’il est présent.
Capturez : les décisions, les préférences, les contraintes, les boucles ouvertes.
Évitez les secrets sauf demande explicite.

Outils et compétences

Les outils résident dans les compétences ; suivez le SKILL.md de chaque compétence lorsque vous en avez besoin.
Conservez les notes spécifiques à l’environnement dans TOOLS.md (Notes pour les compétences).

Conseil de sauvegarde (recommandé)

Si vous considérez cet espace de travail comme la “mémoire” de Clawd, faites-en un dépôt git (idéalement privé) afin que AGENTS.md et vos fichiers de mémoire soient sauvegardés.

cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# Optional: add a private remote + push

Ce que fait OpenClaw

Exécute la passerelle WhatsApp et l’agent de codage Pi afin que l’assistant puisse lire/écrire des chats, récupérer le contexte et exécuter des compétences via l’hôte Mac.
L’application macOS gère les autorisations (enregistrement d’écran, notifications, microphone) et expose la CLI macOSopenclawCLI via son binaire groupé.
Les discussions directes sont réduites dans la session main de l’agent par défaut ; les groupes restent isolés en tant que agent:<agentId>:<channel>:group:<id> (salons/canaux : agent:<agentId>:<channel>:channel:<id>) ; les battements de cœur gardent les tâches en arrière-plan en vie.

Compétences principales (à activer dans Paramètres → Compétences)

mcporter - Runtime d’outil serveur/CLI pour gérer les backends de compétences externes.
Peekaboo - Captures d’écran macOS rapides avec analyse de vision AI en option.
camsnap - Capture des images, des clips ou des alertes de mouvement à partir de caméras de sécurité RTSP/ONVIF.
oracle - Agent CLI prêt pour OpenAI avec rejeu de session et contrôle du navigateur.
eightctl - Contrôlez votre sommeil, depuis le terminal.
imsg - Envoyer, lire, diffuser iMessage et SMS.
wacli - CLI WhatsApp : synchroniser, rechercher, envoyer.
discord - Actions Discord : réagir, stickers, sondages. Utilisez des cibles Discorduser:<id> ou channel:<id> (les identifiants numériques seuls sont ambigus).
gog - CLI Google Suite : Gmail, Agenda, Drive, Contacts.
spotify-player - Client Spotify terminal pour rechercher/mettre en file d’attente/contrôler la lecture.
sag - Synthèse vocale ElevenLabs avec UX style mac « say » ; diffuse vers les haut-parleurs par défaut.
Sonos CLI - Contrôlez les enceintes Sonos (découverte/état/lecture/volume/groupement) à partir de scripts.
blucli - Lire, grouper et automatiser les lecteurs BluOS à partir de scripts.
OpenHue CLI - Contrôle de l’éclairage Philips Hue pour les scènes et les automatisations.
OpenAI Whisper - Reconnaissance vocale locale pour une dictée rapide et des transcriptions de messages vocaux.
Gemini CLI - Modèles Google Gemini depuis le terminal pour des questions-réponses rapides.
agent-tools - Boîte à outils utilitaire pour les automatisations et les scripts d’aide.

Notes d’utilisation

Préférez la openclaw CLI pour les scripts ; l’application Mac gère les autorisations.
Exécutez les installations depuis l’onglet Skills ; elle masque le bouton si un binaire est déjà présent.
Gardez les battements de cœur (heartbeats) activés pour que l’assistant puisse planifier des rappels, surveiller les boîtes de réception et déclencher des captures d’écran.
L’interface utilisateur Canvas s’exécute en plein écran avec des superpositions natives. Évitez de placer des commandes critiques dans les coins supérieur gauche/droit ou sur les bords inférieurs ; ajoutez des gouttières explicites dans la mise en page et ne comptez pas sur les marges de sécurité (safe-area insets).
Pour la vérification pilotée par le navigateur, utilisez openclaw browser (onglets/statut/capture d’écran) avec le profil Chrome géré par OpenClaw.
Pour l’inspection du DOM, utilisez openclaw browser eval|query|dom|snapshot (et --json/--out lorsque vous avez besoin d’une sortie machine).
Pour les interactions, utilisez openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run (clic/frappe nécessitent des références d’instantané ; utilisez evaluate pour les sélecteurs CSS).