Componentes de Filesystem

La mitad relacional de un agente apunta a la configuración; la mitad en disco reside bajo la raíz de instalación. El diseño está organizado por alcance, no en un único árbol plano: el estado a nivel de instancia, los recursos compartidos entre agentes y los datos privados por agente tienen cada uno su propio directorio de nivel superior.

<install>/
├── data/                         — instance-wide state (not per-agent)
│   ├── sessions/                 — chat session stores
│   │   └── sessions.db, acp-sessions.db
│   ├── state/                    — runtime state
│   │   └── costs.jsonl, runtime-trace.jsonl
│   ├── devices.db                — paired-device metadata
│   └── memory/                   — shared instance memory
│       └── brain.db, audit.db, response_cache.db,
│           MEMORY_SNAPSHOT.md, archive/
├── shared/                       — resources agents draw on in common
│   └── skills/<bundle>/          — skill bundles
│       └── SKILL.md, scripts/, references/, assets/
└── agents/                       — per-agent private data
    └── <alias>/
        └── workspace/            — the agent's jailed filesystem sandbox
            └── memory/
                └── brain.db

Las tres raíces se corresponden con tres ámbitos:

• data/ contiene el estado que pertenece a toda la instalación, no a ningún agente en particular: sessions/ de chat, state/ en tiempo de ejecución (seguimiento de costos y similares), los metadatos de dispositivos emparejados en devices.db y la memoria compartida de la instancia en data/memory/. Los tokens portadores válidos del gateway siguen siendo estado de configuración; devices.db hace que los dispositivos emparejados sean visibles y manejables.
• shared/ contiene los recursos que los agentes utilizan en común, en particular los paquetes de habilidades bajo shared/skills/<bundle>/.
• agents/<alias>/ contiene todo lo privado de un agente. De forma predeterminada, el espacio de trabajo de un agente es <install>/agents/<alias>/workspace/, y todo lo que el agente lee o escribe permanece dentro de él. La fuente de identidad del agente se resuelve de forma relativa a este espacio de trabajo. Los agentes están enjaulados en su propio espacio de trabajo a menos que concedas explícitamente acceso entre agentes.

Espacio de trabajo

El espacio de trabajo es el sandbox del sistema de archivos del agente. Los campos a continuación se generan a partir del esquema:

zeroclaw config set agents.<alias>.workspace.access <value>

export ZEROCLAW_agents__<alias>__workspace__access=

zeroclaw config set agents.<alias>.workspace.path <value>

export ZEROCLAW_agents__<alias>__workspace__path=

zeroclaw config set agents.<alias>.workspace.read_memory_from <value>

export ZEROCLAW_agents__<alias>__workspace__read_memory_from=

zeroclaw config set agents.<alias>.workspace.unrestricted_filesystem <value>

export ZEROCLAW_agents__<alias>__workspace__unrestricted_filesystem=

Dos cosas que vale la pena destacar:

• access es una lista de permitidos entrante para el uso compartido del sistema de archivos entre agentes. Vacía significa aislado (solo el propio espacio de trabajo); una entrada otorga a un agente hermano con nombre un modo de lectura o escritura en el espacio de trabajo de este agente.
• unrestricted_filesystem es la vía de escape: cuando es true, el agente puede acceder a cualquier cosa que el sistema de archivos del host permita. Está desactivado por defecto y activarlo es auditable.

Memoria

Cada agente mantiene su propio almacén de memoria en su espacio de trabajo (agents/<alias>/workspace/memory/), separado de la memoria de instancia compartida en data/memory/. El backend se selecciona por agente:

zeroclaw config set agents.<alias>.memory.backend <value>

export ZEROCLAW_agents__<alias>__memory__backend=

El backend usa SQLite de forma predeterminada para un agente nuevo y, una vez que el agente ha escrito datos en disco, el valor queda bloqueado, por lo que no puedes intercambiar silenciosamente un backend bajo la memoria existente. El uso compartido de memoria entre agentes es opcional mediante la lista de अनुमति del workspace read_memory_from. Para el propio modelo de memoria, consulta Runtime internals. Para un mapa de estado entre sistemas, consulta Runtime state and persistence.

Identidad

La identidad de un agente (su personalidad) se obtiene por agente:

zeroclaw config set agents.<alias>.identity.aieos_inline <value>

export ZEROCLAW_agents__<alias>__identity__aieos_inline=

zeroclaw config set agents.<alias>.identity.aieos_path <value>

export ZEROCLAW_agents__<alias>__identity__aieos_path=

zeroclaw config set agents.<alias>.identity.format <value>

export ZEROCLAW_agents__<alias>__identity__format=

El format selecciona cómo se carga la identidad. El valor predeterminado lee los archivos de personalidad del proyecto; la alternativa carga una definición JSON de AIEOS, ya sea desde una ruta relativa al espacio de trabajo o en línea.