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 pour le contexte de l’espace de travail. Gardez-le privé et traitez-le comme une mémoire.

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

# Emplacement par défaut

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

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

openclaw onboard, openclaw configure ou openclaw setup créera l’espace de travail et ajoutera les fichiers d’amorçage s’ils manquent.

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

{ agents: { defaults: { skipBootstrap: true } } }

# Dossiers d’espace de travail supplémentaires

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

# Carte des fichiers de l’espace de travail

Voici les fichiers standard qu’OpenClaw attend dans l’espace de travail :

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

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

• ~/.openclaw/openclaw.json (configuration)
• ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (profils d’authentification modèle : OAuth + clés d’API)
• ~/.openclaw/agents/<agentId>/agent/codex-home/ (compte d’exécution Codex par agent, configuration, Skills, plugins et état natif des threads)
• ~/.openclaw/credentials/ (état des canaux/fournisseurs plus données d’import OAuth héritées)
• ~/.openclaw/agents/<agentId>/sessions/ (transcriptions de session + métadonnées)
• ~/.openclaw/skills/ (Skills gérés)

Si vous devez migrer des sessions ou une configuration, copiez-les séparément et gardez-les hors 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).

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"

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

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

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

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

# Ne commitez pas de secrets

Modèle de départ .gitignore suggéré :

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

# Déplacer l’espace de travail vers une nouvelle machine

# Notes avancées

• Le routage multi-agent peut utiliser différents espaces de travail par agent. Consultez Routage des canaux 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.

# Connexe

• Heartbeat - fichier d’espace de travail HEARTBEAT.md
• Sandboxing - accès à l’espace de travail dans les environnements sandboxés
• Session - chemins de stockage des sessions
• Ordres permanents - instructions persistantes dans les fichiers de l’espace de travail