OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Fundamentals

Espacio de trabajo del agente

El espacio de trabajo es el hogar del agente: el directorio de trabajo utilizado para las herramientas de archivos y el contexto del espacio de trabajo. Manténgalo privado y trátelo como memoria.

Esto es independiente de ~/.openclaw/, que almacena la configuración, las credenciales y las sesiones.

Ubicación predeterminada

  • Valor predeterminado: ~/.openclaw/workspace
  • Si OPENCLAW_PROFILE está definido y no es "default", el valor predeterminado pasa a ser ~/.openclaw/workspace-<profile>.
  • OPENCLAW_WORKSPACE_DIR sustituye ambos valores anteriores cuando está definido.
  • Los agentes no predeterminados (agents.list[]) sin un espacio de trabajo explícito se resuelven como <state-dir>/workspace-<agentId>, no como el espacio de trabajo predeterminado compartido.

Sustitúyalo en ~/.openclaw/openclaw.json:

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

Sustitución por agente: agents.list[].workspace.

openclaw onboard, openclaw configure u openclaw setup crean el espacio de trabajo y generan los archivos de inicialización si faltan.

Si ya gestiona personalmente los archivos del espacio de trabajo, deshabilite la creación de archivos de inicialización:

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

Carpetas adicionales del espacio de trabajo

Es posible que las instalaciones antiguas hayan creado ~/openclaw. Mantener varios directorios de espacios de trabajo puede provocar confusiones en la autenticación o divergencias de estado, ya que solo puede haber un espacio de trabajo activo a la vez.

Mapa de archivos del espacio de trabajo

Archivos estándar que OpenClaw espera encontrar dentro del espacio de trabajo:

AGENTS.md: instrucciones de funcionamiento

Instrucciones de funcionamiento para el agente y sobre cómo debe utilizar la memoria. Se cargan al principio de cada sesión. Es un buen lugar para incluir reglas, prioridades y detalles sobre «cómo comportarse».

SOUL.md: personalidad y tono

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

USER.md: quién es el usuario

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

IDENTITY.md: nombre, estilo y emoji

El nombre, el estilo y el emoji del agente. Se crea o actualiza durante el ritual de inicialización.

TOOLS.md: convenciones de herramientas locales

Notas sobre las herramientas y convenciones locales. No controla la disponibilidad de las herramientas; solo sirve como guía.

HEARTBEAT.md: lista de comprobación de Heartbeat

Pequeña lista de comprobación opcional para las ejecuciones de Heartbeat. Manténgala breve para evitar un consumo excesivo de tokens.

BOOT.md: lista de comprobación de inicio

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

BOOTSTRAP.md: ritual de primera ejecución

Ritual de primera ejecución que se realiza una sola vez. Solo se crea para un espacio de trabajo completamente nuevo. Elimínelo una vez finalizado el ritual.

memory/YYYY-MM-DD.md: registro diario de memoria

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

MEMORY.md: memoria seleccionada a largo plazo (opcional)

Memoria seleccionada a largo plazo: hechos duraderos, preferencias, decisiones y resúmenes breves. Mantenga los registros detallados en memory/YYYY-MM-DD.md para que las herramientas de memoria puedan recuperarlos bajo demanda sin inyectarlos en cada prompt. Cargue MEMORY.md únicamente en la sesión principal privada (no en contextos compartidos o grupales). Consulte Memoria para conocer el flujo de trabajo y el volcado automático de memoria.

skills/: Skills del espacio de trabajo (opcional)

Skills específicos del espacio de trabajo. Es la ubicación de Skills con mayor precedencia para ese espacio de trabajo, por delante de los Skills del agente del proyecto, los Skills personales del agente, los Skills gestionados, los Skills incluidos y skills.load.extraDirs cuando coinciden los nombres.

canvas/: archivos de la interfaz de Canvas (opcional)

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

Qué NO se encuentra en el espacio de trabajo

Estos elementos se encuentran en ~/.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 de modelos: OAuth + claves de API)
  • ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite (filas de sesiones, transcripciones y estado de ejecución por agente)
  • ~/.openclaw/agents/<agentId>/agent/codex-home/ (cuenta, configuración, Skills, Plugins y estado nativo de hilos de la ejecución de Codex por agente)
  • ~/.openclaw/credentials/ (estado de canales/proveedores y datos heredados de importación de OAuth)
  • ~/.openclaw/agents/<agentId>/sessions/ (orígenes de migración heredados y artefactos de archivo o asistencia)
  • ~/.openclaw/skills/ (Skills gestionados)

Si necesita migrar sesiones o la configuración, cópielas por separado y manténgalas fuera del control de versiones.

Copia de seguridad con Git (recomendada y privada)

Trate el espacio de trabajo como memoria privada. Guárdelo en un repositorio Git privado para disponer de una copia de seguridad recuperable.

Ejecute estos pasos en la máquina donde se ejecuta el Gateway (allí se encuentra el espacio de trabajo).

  • Inicializar el repositorio

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

    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"

  • Añadir un repositorio remoto privado

    Interfaz web de GitHub

    1. Cree un repositorio privado nuevo en GitHub.
    2. No lo inicialice con un README (para evitar conflictos de fusión).
    3. Copie la URL HTTPS del repositorio remoto.
    4. Añada el repositorio remoto y envíe los cambios:
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

    CLI de GitHub (gh)

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

    Interfaz web de GitLab

    1. Cree un repositorio privado nuevo en GitLab.
    2. No lo inicialice con un README (para evitar conflictos de fusión).
    3. Copie la URL HTTPS del repositorio remoto.
    4. Añada el repositorio remoto y envíe los cambios:
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

  • Actualizaciones continuas

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

    • No confirme secretos

    Plantilla inicial sugerida para .gitignore:

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

    Trasladar el espacio de trabajo a una máquina nueva

  • Clonar el repositorio

    Clone el repositorio en la ruta deseada (valor predeterminado: ~/.openclaw/workspace).

  • Actualizar la configuración

    Establezca agents.defaults.workspace en esa ruta dentro de ~/.openclaw/openclaw.json.

  • Generar los archivos que falten

    Ejecute openclaw setup --workspace <path> para generar los archivos que falten.

  • Copiar las sesiones (opcional)

    Si necesita las sesiones, copie ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite por separado desde la máquina antigua. Copie ~/.openclaw/agents/<agentId>/sessions/ únicamente cuando también necesite entradas de migración heredadas o artefactos de archivo o asistencia.

    • Notas avanzadas

    • El enrutamiento multiagente puede utilizar distintos espacios de trabajo por agente mediante agents.list[].workspace. Consulte Enrutamiento de canales para conocer la configuración del enrutamiento.
    • Si agents.defaults.sandbox está habilitado, las sesiones que no sean la principal pueden utilizar espacios de trabajo aislados por sesión en agents.defaults.sandbox.workspaceRoot.

    Temas relacionados

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

    On this page