English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Fundamentals

Espacio de trabajo del agente

El espacio de trabajo es el hogar del agente. Es el único directorio de trabajo usado para 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>.
  • Sobrescríbelo en ~/.openclaw/openclaw.json:
json5
{  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:

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

Carpetas adicionales del espacio de trabajo

Las instalaciones antiguas pueden haber creado ~/openclaw. Mantener varios directorios de espacio de trabajo puede causar confusiones de autenticación o deriva 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:

AGENTS.md - operating instructions

Instrucciones operativas para el agente y cómo debe usar la memoria. Se cargan al inicio de cada sesión. Buen lugar para reglas, prioridades y detalles sobre "cómo comportarse".

SOUL.md - persona and tone

Persona, tono y límites. Se carga en cada sesión. Guía: guía de personalidad de SOUL.md.

USER.md - who the user is

Quién es el usuario y cómo dirigirse a él. Se carga en cada sesión.

IDENTITY.md - name, vibe, emoji

El nombre, la vibra y el emoji del agente. Se crea/actualiza durante el ritual de arranque.

TOOLS.md - local tool conventions

Notas sobre tus herramientas locales y convenciones. No controla la disponibilidad de herramientas; es solo orientación.

HEARTBEAT.md - heartbeat checklist

Lista de comprobación diminuta opcional para ejecuciones de Heartbeat. Mantenla breve para evitar consumo de tokens.

BOOT.md - startup checklist

Lista de comprobación de inicio opcional que se ejecuta automáticamente al reiniciar el Gateway (cuando los hooks internos están habilitados). Mantenla breve; usa la herramienta de mensajes para envíos salientes.

BOOTSTRAP.md - first-run ritual

Ritual único de primera ejecución. Solo se crea para un espacio de trabajo completamente nuevo. Elimínalo cuando el ritual esté completo.

memory/YYYY-MM-DD.md - daily memory log

Registro diario de memoria (un archivo por día). Se recomienda leer hoy + ayer al iniciar la sesión.

MEMORY.md - curated long-term memory (optional)

Memoria a largo plazo curada: hechos duraderos, preferencias, decisiones y resúmenes breves. Mantén registros detallados en memory/YYYY-MM-DD.md para que las herramientas de memoria puedan recuperarlos bajo demanda sin inyectarlos en cada prompt. Carga MEMORY.md solo en la sesión principal y privada (no en contextos compartidos/grupales). Consulta Memoria para ver el flujo de trabajo y el vaciado automático de memoria.

skills/ - workspace skills (optional)

Skills específicas del espacio de trabajo. Ubicación de Skills de mayor precedencia para ese espacio de trabajo. Sobrescribe Skills de agente del proyecto, Skills de agente personales, Skills gestionadas, Skills incluidas y skills.load.extraDirs cuando los nombres coinciden.

canvas/ - Canvas UI files (optional)

Archivos de interfaz de Canvas para visualizaciones de nodos (por ejemplo canvas/index.html).

Qué NO está en el espacio de trabajo

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

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

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 repo de 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).

  • Initialize the repo

    Si git está instalado, los espacios de trabajo completamente nuevos se inicializan automáticamente. Si este espacio de trabajo aún no es un repo, ejecuta:

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

  • Add a private remote

    GitHub web UI

    1. Crea un nuevo repositorio privado en GitHub.
    2. No lo inicialices con un README (evita conflictos de fusión).
    3. Copia la URL remota HTTPS.
    4. Añade el remoto y haz push:
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

    GitHub CLI (gh)

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

    GitLab web UI

    1. Crea un nuevo repositorio privado en GitLab.
    2. No lo inicialices con un README (evita conflictos de fusión).
    3. Copia la URL remota HTTPS.
    4. Añade el remoto y haz push:
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

  • Ongoing updates

    bash
    git statusgit add .git commit -m "Update memory"git push

    • No confirmes secretos

    Inicio sugerido de .gitignore:

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

    Mover el espacio de trabajo a una máquina nueva

  • Clone the repo

    Clona el repo en la ruta deseada (predeterminada ~/.openclaw/workspace).

  • Update config

    Define agents.defaults.workspace en esa ruta en ~/.openclaw/openclaw.json.

  • Seed missing files

    Ejecuta openclaw setup --workspace <path> para sembrar cualquier archivo faltante.

  • Copy sessions (optional)

    Si necesitas sesiones, copia ~/.openclaw/agents/<agentId>/sessions/ desde la máquina anterior por separado.

    • Notas avanzadas

    • El enrutamiento multiagente puede usar diferentes 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 aislados por sesión bajo agents.defaults.sandbox.workspaceRoot.

    Relacionado

    • Heartbeat - archivo de espacio de trabajo HEARTBEAT.md
    • Aislamiento - acceso al espacio de trabajo en entornos aislados
    • Sesión - rutas de almacenamiento de sesiones
    • Órdenes permanentes - instrucciones persistentes en archivos del espacio de trabajo
    Was this useful?
    On this page

    On this page