Espacio de trabajo del agente

El espacio de trabajo es el hogar del agente. Es el único directorio de trabajo usado para las herramientas de archivos y para el contexto del espacio de trabajo. Mantenlo privado y trátalo como memoria.

Esto está separado de ~/.openclaw/, que almacena configuración, credenciales y sesiones.

# Ubicación predeterminada

• Predeterminado: ~/.openclaw/workspace
• Si OPENCLAW_PROFILE está definido y no es "default", el valor predeterminado pasa a ser ~/.openclaw/workspace-<profile>.
• Sobrescribir en ~/.openclaw/openclaw.json:

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

openclaw onboard, openclaw configure u openclaw setup crearán el espacio de trabajo y sembrarán los archivos de arranque si faltan.

Si ya gestionas tú mismo los archivos del espacio de trabajo, puedes deshabilitar la creación de archivos de arranque:

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

# Carpetas adicionales del espacio de trabajo

Las instalaciones anteriores pueden haber creado ~/openclaw. Mantener varios directorios de espacio de trabajo puede causar confusiones de autenticación o desviaciones de estado, porque solo un espacio de trabajo está activo a la vez.

# Mapa de archivos del espacio de trabajo

Estos son los archivos estándar que OpenClaw espera dentro del espacio de trabajo:

# Qué NO está en el espacio de trabajo

Estos viven bajo ~/.openclaw/ y NO deben confirmarse en el repositorio del espacio de trabajo:

• ~/.openclaw/openclaw.json (configuración)
• ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (perfiles de autenticación del modelo: OAuth + claves de API)
• ~/.openclaw/agents/<agentId>/agent/codex-home/ (cuenta de runtime Codex por agente, configuración, Skills, plugins y estado nativo de hilos)
• ~/.openclaw/credentials/ (estado de canal/proveedor más datos de importación OAuth heredados)
• ~/.openclaw/agents/<agentId>/sessions/ (transcripciones de sesión + metadatos)
• ~/.openclaw/skills/ (Skills gestionados)

Si necesitas migrar sesiones o configuración, cópialas por separado y mantenlas fuera del control de versiones.

# Copia de seguridad con Git (recomendada, privada)

Trata el espacio de trabajo como memoria privada. Ponlo en un repositorio git privado para que tenga copia de seguridad y sea recuperable.

Ejecuta estos pasos en la máquina donde se ejecuta el Gateway (ahí es donde vive el espacio de trabajo).

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

# No confirmes secretos

Inicio sugerido de .gitignore:

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

# Mover el espacio de trabajo a una máquina nueva

# Notas avanzadas

• El enrutamiento multiagente puede usar distintos espacios de trabajo por agente. Consulta Enrutamiento de canales para la configuración de enrutamiento.
• Si agents.defaults.sandbox está habilitado, las sesiones no principales pueden usar espacios de trabajo de sandbox por sesión bajo agents.defaults.sandbox.workspaceRoot.

# Relacionado

• Heartbeat - archivo de espacio de trabajo HEARTBEAT.md
• Sandboxing - acceso al espacio de trabajo en entornos con sandbox
• Sesión - rutas de almacenamiento de sesiones
• Órdenes permanentes - instrucciones persistentes en archivos del espacio de trabajo