L’espace de travail d’un agent OpenClaw

Chaque agent OpenClaw a un espace de travail : le répertoire de travail qu’utilisent ses outils de fichiers et la source de son contexte d’espace de travail. La documentation le décrit en une ligne, le foyer de l’agent, et donne une consigne, le garder privé et le traiter comme de la mémoire. Il est distinct du répertoire d’état qui contient la configuration, les identifiants et les sessions. Voici où il vit, la carte des fichiers, les limites sur ce qui est injecté, ce qui doit en rester exclu, la sauvegarde que recommande la documentation, et le déplacement vers une autre machine.

Où il vit

• La valeur par défaut est un dossier d’espace de travail dans le répertoire d’état ; un profil nommé le déplace dans un répertoire propre au profil, une variable d’environnement remplace les deux, et un répertoire d’état non standard garde l’espace de travail à côté de lui.
• Un seul agent configuré hérite de la valeur par défaut ; dans un effectif multi-agents explicite, les entrées sans espace de travail propre reçoivent un sous-dossier de la racine configurée ou un dossier par agent à côté du répertoire d’état, et nommer une racine partagée ne l’attribue pas à un agent.
• L’assistant de démarrage, la configuration et l’installation créent l’espace de travail et y placent les fichiers d’amorçage s’ils manquent ; une option de saut d’amorçage existe pour ceux qui gèrent les fichiers eux-mêmes, et les anciens répertoires supplémentaires ne sont pas fusionnés dans l’espace de travail actif.
• L’avertissement : l’espace de travail est le répertoire de travail par défaut, pas un bac à sable strict ; les chemins relatifs s’y résolvent, mais les chemins absolus peuvent toujours atteindre le reste de l’hôte sauf si le bac à sable est activé, et avec le bac à sable activé et un accès à l’espace de travail autre que lecture-écriture, les outils travaillent dans un espace de travail de bac à sable sous le répertoire d’état à la place.

L’espace de travail est le foyer de l’agent : le répertoire de travail utilisé pour les outils de fichiers et le contexte de l’espace de travail. Gardez-le privé et traitez-le comme de la mémoire.

La carte des fichiers

Les instructions de fonctionnement et l’usage de la mémoire vivent dans AGENTS.md, chargé au début de chaque session, avec une section Outils qui porte des conventions locales mais ne contrôle pas la disponibilité des outils. SOUL.md porte le personnage, le ton et les limites, chargé à chaque session. USER.md est un modèle d’utilisateur facultatif fondé sur des directives avec son propre budget de 4 000 caractères. IDENTITY.md porte le nom, l’ambiance et l’emoji issus du rituel d’amorçage. BOOT.md est une liste de contrôle de démarrage facultative exécutée quand le hook de démarrage est activé, et BOOTSTRAP.md le rituel unique de première exécution, supprimé une fois terminé. Les journaux de mémoire quotidiens se trouvent dans un dossier de mémoire, un fichier par jour, et MEMORY.md est la mémoire à long terme soignée, chargée seulement dans la session principale privée. Un dossier de compétences contient les compétences de l’espace de travail, l’emplacement de compétences de plus haute priorité. Un fichier requis manquant injecte un marqueur et la session continue ; les fichiers facultatifs sont simplement omis ; les gros fichiers sont tronqués sous une valeur par défaut de 20 000 caractères par fichier et 60 000 au total, et l’éditeur de fichiers de l’interface de contrôle est là où vous les modifiez.

Ce qui reste dehors, et la sauvegarde

• Hors de l’espace de travail et jamais versionné avec lui : le fichier de configuration, la base d’état partagée, la base d’exécution par agent avec les profils d’authentification, l’état de routage, les lignes de session et les transcriptions, le dossier Codex par agent, le répertoire des identifiants, les artefacts de sessions hérités, et les compétences gérées ; les anciens fichiers d’état annexes sont importés et supprimés par le docteur.
• La sauvegarde recommandée est un dépôt git privé : les espaces de travail neufs sont initialisés automatiquement quand git est présent, puis ajoutez les fichiers d’instructions, de personnage, d’identité, d’utilisateur et de mémoire, poussez vers un dépôt distant privé sur GitHub ou GitLab, et validez à mesure que la mémoire change.
• Même dans un dépôt privé, aucun secret : pas de clés d’API, de jetons ni de mots de passe, rien du répertoire d’état, pas de copies brutes de discussions ni de pièces jointes sensibles ; utilisez des espaces réservés et gardez les vraies valeurs dans un gestionnaire de mots de passe, l’environnement ou le répertoire d’état, avec le fichier d’exclusion de départ de la documentation pour les fichiers env, les clés et les certificats.

SOUL.md dans OpenClaw couvre le fichier de personnage en profondeur, et La mémoire d’OpenClaw expliquée les journaux quotidiens et le fichier soigné autour desquels l’espace de travail est construit.

Le déplacer

Clonez le dépôt au chemin voulu, pointez le réglage d’espace de travail de l’agent dessus, confirmez avec la commande de liste des agents avant de démarrer la passerelle, et copiez la base de sessions par agent séparément si vous avez besoin des sessions ; déplacer un espace de travail n’exige pas de relancer l’assistant de démarrage. Le routage multi-agents peut donner à chaque agent son propre espace de travail, et avec le bac à sable activé, les sessions non principales peuvent utiliser des espaces de travail de bac à sable par session. Sauvegarde et restauration d’OpenClaw couvre l’archive qui capture l’état et l’espace de travail ensemble, et Le bac à sable d’OpenClaw expliqué l’isolation que l’espace de travail lui-même ne fournit pas.

Sur Diali

Sur Diali, l’espace de travail vit sur le volume persistant de l’assistant, initialisé à partir de ce que vous avez écrit à l’assistant de démarrage, et le module de sauvegardes est l’étape du dépôt privé faite pour vous. OpenClaw hébergé sur Diali est l’assistant et Le prompt système d’OpenClaw explique où ces fichiers atterrissent dans le prompt.

• Le foyer, pas un bac à sable.
• Instructions, personnage, identité, utilisateur, mémoire, compétences.
• Un dépôt privé, et jamais un secret dedans.