Espace de travail de l'agent

Espace de travail de l’agent

L’espace de travail est le domicile de l’agent. C’est le seul 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 une mémoire.

Ceci est distinct de ~/.openclaw/, qui stocke la configuration, les identifiants et les sessions.

Important : l’espace de travail est le cwd par défaut, et non un bac à sable strict. Les outils résolvent les chemins relatifs par rapport à l’espace de travail, mais les chemins absolus peuvent toujours atteindre d’autres endroits sur l’hôte sauf si le sandboxing est activé. Si vous avez besoin d’isolement, utilisez agents.defaults.sandbox (et/ou la configuration de sandbox par agent). Lorsque le sandboxing est activé et que workspaceAccess n’est pas "rw", les outils fonctionnent à l’intérieur d’un espace de travail bac à sable sous ~/.openclaw/sandboxes, et non votre espace de travail hôte.

Emplacement par défaut

Par défaut : ~/.openclaw/workspace
Si OPENCLAW_PROFILE est défini et non "default", la valeur par défaut devient ~/.openclaw/workspace-<profile>.
Remplacer dans ~/.openclaw/openclaw.json :

{
  agent: {
    workspace: "~/.openclaw/workspace",
  },
}

openclaw onboard, openclaw configure, ou openclaw setup créera l’espace de travail et initialisera les fichiers d’amorçage s’ils sont manquants. Les copies d’amorçage de bac à sable n’acceptent que les fichiers réguliers dans l’espace de travail ; les alias de lien symbolique ou de lien dur qui résolvent en dehors de l’espace de travail source sont ignorés.

Si vous gérez déjà les fichiers de l’espace de travail vous-même, vous pouvez désactiver la création de fichiers d’amorçage :

{ agent: { skipBootstrap: true } }

Dossiers d’espace de travail supplémentaires

Les installations plus anciennes ont pu créer ~/openclaw. Garder plusieurs répertoires d’espace de travail peut causer une confusion de l’authentification ou une dérive de l’état, car un seul espace de travail est actif à la fois.

Recommandation : conserver un seul espace de travail actif. Si vous n’utilisez plus les dossiers supplémentaires, archivez-les ou déplacez-les dans la Corbeille (par exemple trash ~/openclaw). Si vous conservez intentionnellement plusieurs espaces de travail, assurez-vous que agents.defaults.workspace pointe vers celui qui est actif.

openclaw doctor avertit lorsqu’il détecte des répertoires d’espace de travail supplémentaires.

Cartographie des fichiers de l’espace de travail (signification de chaque fichier)

Voici les fichiers standards que OpenClaw s’attend à trouver dans l’espace de travail :

AGENTS.md
- Instructions de fonctionnement pour l’agent et la manière dont il doit utiliser la mémoire.
- Chargé au début de chaque session.
- Bon endroit pour les règles, les priorités et les détails sur « comment se comporter ».
SOUL.md
- Persona, ton et limites.
- Chargé à chaque session.
USER.md
- Qui est l’utilisateur et comment s’adresser à lui.
- Chargé à chaque session.
IDENTITY.md
- Le nom, l’ambiance et l’emoji de l’agent.
- Créé/mis à jour lors du rituel d’amorçage.
TOOLS.md
- Notes sur vos outils locaux et conventions.
- Ne contrôle pas la disponibilité des outils ; il s’agit uniquement de conseils.
HEARTBEAT.md
- Petite liste de contrôle optionnelle pour les exécutions de heartbeat.
- Gardez-la courte pour éviter la surconsommation de jetons.
BOOT.md
- Liste de contrôle de démarrage optionnelle exécutée lors du redémarrage de la passerelle lorsque les crochets internes sont activés.
- Gardez-la courte ; utilisez l’outil de message pour les envois sortants.
BOOTSTRAP.md
- Rituel de première exécution unique.
- Créé uniquement pour un espace de travail tout neuf.
- Supprimez-le une fois le rituel terminé.
memory/YYYY-MM-DD.md
- Journal de mémoire quotidien (un fichier par jour).
- Recommandé de lire aujourd’hui + hier au début de la session.
MEMORY.md (optionnel)
- Mémoire à long terme organisée.
- À charger uniquement dans la session principale privée (pas les contextes partagés/groupe).

Voir Mémoire pour le workflow et le vidage automatique de la mémoire.

skills/ (optionnel)
- Compétences spécifiques à l’espace de travail.
- Remplace les compétences gérées/groupées lorsque les noms sont en conflit.
canvas/ (facultatif)
- Fichiers d’interface utilisateur Canvas pour les affichages de nœuds (par exemple canvas/index.html).

Si un fichier d’amorçage manque, OpenClaw injecte un marqueur de “fichier manquant” dans la session et continue. Les fichiers d’amorçage volumineux sont tronqués lors de l’injection ; ajustez les limites avec agents.defaults.bootstrapMaxChars (par défaut : 20000) et agents.defaults.bootstrapTotalMaxChars (par défaut : 150000). openclaw setup peut recréer les valeurs par défaut manquantes sans écraser les fichiers existants.

Ce qui n’est PAS dans l’espace de travail

Ces éléments se trouvent sous ~/.openclaw/ et ne doivent PAS être validés dans le dépôt de l’espace de travail :

~/.openclaw/openclaw.json (configuration)
~/.openclaw/credentials/ (jetons OAuth, clés API)
~/.openclaw/agents/<agentId>/sessions/ (transcriptions de session + métadonnées)
~/.openclaw/skills/ (compétences gérées)

Si vous devez migrer des sessions ou une configuration, copiez-les séparément et gardez-les en dehors du contrôle de version.

Sauvegarde Git (recommandée, privée)

Traitez l’espace de travail comme une mémoire privée. Placez-le dans un dépôt git privé afin qu’il soit sauvegardé et récupérable.

Exécutez ces étapes sur la machine où le Gateway s’exécute (c’est là que se trouve l’espace de travail).

1) Initialiser le dépôt

Si git est installé, les nouveaux espaces de travail sont initialisés automatiquement. Si cet espace de travail n’est pas déjà un dépôt, exécutez :

cd ~/.openclaw/workspace
git init
git add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/
git commit -m "Add agent workspace"

2) Ajouter un distant privé (options adaptées aux débutants)

Option A : Interface Web GitHub

Créez un nouveau dépôt privé sur GitHub.
Ne l’initialisez pas avec un README (évite les conflits de fusion).
Copiez l’URL distante HTTPS.
Ajoutez le distant et envoyez (push) :

git branch -M main
git remote add origin <https-url>
git push -u origin main

Option B : GitHub CLI (gh)

gh auth login
gh repo create openclaw-workspace --private --source . --remote origin --push

Option C : Interface Web GitLab

Créez un nouveau dépôt privé sur GitLab.
Ne l’initialisez pas avec un README (évite les conflits de fusion).
Copiez l’URL distante HTTPS.
Ajoutez le distant et envoyez (push) :

git branch -M main
git remote add origin <https-url>
git push -u origin main

3) Mises à jour continues

git status
git add .
git commit -m "Update memory"
git push

Ne validez pas de secrets

Même dans un dépôt privé, évitez de stocker des secrets dans l’espace de travail :

Clés d’API, jetons OAuth, mots de passe ou informations d’identification privées.
Tout ce qui se trouve sous ~/.openclaw/.
Sauvegardes brutes des discussions ou pièces jointes sensibles.

Si vous devez stocker des références sensibles, utilisez des espaces réservés et gardez le secret réel ailleurs (gestionnaire de mots de passe, variables d’environnement ou ~/.openclaw/).

Starter .gitignore suggéré :

.DS_Store
.env
**/*.key
**/*.pem
**/secrets*

Déplacement de l’espace de travail vers une nouvelle machine

Clonez le dépôt vers le chemin souhaité (par défaut ~/.openclaw/workspace).
Définissez agents.defaults.workspace sur ce chemin dans ~/.openclaw/openclaw.json.
Exécutez openclaw setup --workspace <path> pour créer les fichiers manquants.
Si vous avez besoin des sessions, copiez ~/.openclaw/agents/<agentId>/sessions/ depuis l’ancienne machine séparément.

Notes avancées

Le routage multi-agent peut utiliser différents espaces de travail par agent. Voir Channel routing pour la configuration du routage.
Si agents.defaults.sandbox est activé, les sessions non principales peuvent utiliser des espaces de travail sandbox par session sous agents.defaults.sandbox.workspaceRoot.

Connexes

Standing Orders — instructions persistantes dans les fichiers de l’espace de travail
Heartbeat — fichier de l’espace de travail HEARTBEAT.md
Session — chemins de stockage de session
Sandboxing — accès à l’espace de travail dans les environnements sandboxés