Workspace del Agente

El workspace es el hogar del agente. Es la única ubicación usada para

herramientas de archivo y contexto de workspace. Mantenlo privado y trátalo como memoria.

Esto es separado de ''~/.openclaw/'', que almacena configuración, credenciales y

sesiones.

Importante: El workspace es el cwd predeterminado, no un sandbox duro. Las herramientas

resuelven rutas relativas contra el workspace, pero las rutas absolutas aún pueden alcanzar

otras ubicaciones en el host a menos que sandboxing esté habilitado. Si necesitas aislamiento, usa

''''agents.defaults.sandbox'''' (y/o configuración de sandbox por agente).

Cuando sandboxing está habilitado y ''workspaceAccess'' no es ''"rw"'', las herramientas se ejecutan

en un workspace sandbox bajo ''~/.openclaw/sandboxes'', no tu workspace del host.

- Predeterminado: ''~/.openclaw/workspace''

- Si ''OPENCLAW_PROFILE'' está establecido a algo diferente de ''"default"'', el predeterminado se convierte en

''~/.openclaw/workspace-<profile>''.

- Anula en ''~/.openclaw/openclaw.json'':

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

''openclaw onboard'', ''openclaw configure'', o ''openclaw setup'' crearán

el workspace y los archivos bootstrap semilla (si faltan).

Si ya gestionas archivos de workspace tú mismo, puedes deshabilitar la creación

de archivos bootstrap:

{ agent: { skipBootstrap: true } }

Instalaciones antiguas pueden haber creado ''~/openclaw''. Mantener múltiples directorios

de workspace puede llevar a confusión de autenticación o deriva de estado, ya que solo un

workspace está activo a la vez.

Recomendación: Mantén un workspace activo. Si ya no usas

carpetas extra, archívalas o muévelas a la papelera (ej., ''trash ~/openclaw'').

Si intencionalmente mantienes múltiples workspaces, asegúrate que

''agents.defaults.workspace'' apunte al activo.

''openclaw doctor'' advierte cuando se detectan directorios de workspace extra.

Estos son los archivos estándar que OpenClaw espera en el workspace:

- ''AGENTS.md''

- Instrucciones operacionales para el agente y cómo debería usar la memoria.

- Cargado al inicio de cada sesión.

- Buen lugar para reglas, prioridades y detalles de "cómo comportarse".

- ''SOUL.md''

- Persona, tono y límites.

- Cargado por sesión.

- ''USER.md''

- Quién es el usuario y cómo dirigirse a él.

- Cargado por sesión.

- ''IDENTITY.md''

- Nombre del agente, vibra y emoji.

- Creado/actualizado durante el ritual bootstrap.

- ''TOOLS.md''

- Notas sobre herramientas locales y convenciones.

- No controla disponibilidad de herramientas; esto es solo guía.

- ''HEARTBEAT.md''

- Checklist opcional de ejecución de heartbeat.

- Mantenlo corto para evitar quemar tokens.

- ''BOOT.md''

- Checklist de inicio opcional para ejecutar al reiniciar el gateway cuando los hooks internos están habilitados.

ReferenceConceptsAgentWorkspacePage.step03.p23

ReferenceConceptsAgentWorkspacePage.step03.p24

ReferenceConceptsAgentWorkspacePage.step03.p25

ReferenceConceptsAgentWorkspacePage.step03.p26

ReferenceConceptsAgentWorkspacePage.step03.p27

ReferenceConceptsAgentWorkspacePage.step03.p28

ReferenceConceptsAgentWorkspacePage.step03.p29

ReferenceConceptsAgentWorkspacePage.step03.p30

ReferenceConceptsAgentWorkspacePage.step03.p31

ReferenceConceptsAgentWorkspacePage.step03.p32

ReferenceConceptsAgentWorkspacePage.step03.p33

ReferenceConceptsAgentWorkspacePage.step03.p34

ReferenceConceptsAgentWorkspacePage.step03.p35

ReferenceConceptsAgentWorkspacePage.step03.p36

ReferenceConceptsAgentWorkspacePage.step03.p37

ReferenceConceptsAgentWorkspacePage.step03.p38

ReferenceConceptsAgentWorkspacePage.step03.p39

ReferenceConceptsAgentWorkspacePage.step03.p40

ReferenceConceptsAgentWorkspacePage.step03.p41

ReferenceConceptsAgentWorkspacePage.step03.p42

ReferenceConceptsAgentWorkspacePage.step03.p43

ReferenceConceptsAgentWorkspacePage.step03.p44

These live under ''~/.openclaw/'' and should NOT be committed to the workspace repo:

- ''~/.openclaw/openclaw.json'' (configuration)

- ''~/.openclaw/credentials/'' (OAuth tokens, API keys)

- ''~/.openclaw/agents/<agentId>/sessions/'' (session logs + metadata)

- ''~/.openclaw/skills/'' (managed skills)

Si necesitas migrar sesiones o configuración, cópialas por separado y mantén

fuera del control de versiones.

Trata el workspace como memoria privada. Ponlo en un repositorio git privado para que esté

respaldado y recuperable.

Ejecuta estos pasos en la máquina que ejecuta el gateway (es decir, donde

el workspace existe).

#

Los workspaces nuevos se inicializan automáticamente si git está instalado. Si este

workspace aún no es un repositorio, ejecuta:

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"

#

Opción A: Interfaz Web de GitHub

1. Crea un nuevo repositorio privado en GitHub.

2. No inicialices con README (para evitar conflictos de fusión).

3. Copia la URL remota HTTPS.

4. Añade el remoto y haz push:

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

Opción B: CLI de GitHub (''gh'')

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

Opción C: Interfaz Web de GitLab

1. Crea un nuevo repositorio privado en GitLab.

2. No inicialices con README (para evitar conflictos de fusión).

3. Copia la URL remota HTTPS.

4. Añade el remoto y haz push:

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

#

Incluso en repositorios privados, evita almacenar secretos en el workspace:

- Claves API, tokens OAuth, contraseñas o credenciales privadas.

- Cualquier cosa bajo ''~/.openclaw/''.

- Volcados sin procesar de chats o adjuntos sensibles.

Si debes almacenar referencias sensibles, usa placeholders y mantén los

secretos en otro lugar (gestor de contraseñas, variables de entorno, o ''~/.openclaw/'').

Inicio sugerido de ''.gitignore'':

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

1. Clona el repositorio en la ruta deseada (por defecto ''~/.openclaw/workspace'').

2. Establece ''agents.defaults.workspace'' a esa ruta en ''~/.openclaw/openclaw.json''.

3. Ejecuta ''openclaw setup --workspace <path>'' para sembrar archivos faltantes.

4. Si necesitas sesiones, copia ''~/.openclaw/agents/<agentId>/sessions/'' desde la

máquina antigua por separado.

- El enrutamiento multi-agente puede usar diferentes workspaces por agente. Ver

''Enrutamiento de Canales'' para configuración de enrutamiento.

- Si ''agents.defaults.sandbox'' está habilitado, las sesiones no primarias pueden usar sandbox por sesión

workspaces bajo ''agents.defaults.sandbox.workspaceRoot''.