Environment
An Environment (represented by Environment in the runtime) is a sandboxed execution space where agents run code, manage structured data, and persist files.
Sandbox Architecture
Each environment operates with strict logical isolation, consisting of:
- Workspace Filesystem: A full, virtual filesystem that allows agents to read, write, edit, and manage files securely.
- Structured SQL Database: A local, transaction-capable SQLite database engine, allowing agents to store and query structured data instantly without external database setup.
- Isolated Code Runner: A sandboxed JS/TS script runner that runs arbitrary code safely without exposing the host runtime.
Environment Types
UClaw segments environments by scope:
- App-level Environment (
app:*): A shared environment space accessible by all agents within the same parent application. Ideal for global data storage, configuration files, and shared database resources. - Agent-level Environment (
agent:*): A strictly isolated environment dedicated to a single agent instance. This is the default workspace when an agent writes files or executes scripts.
To understand what tools and permissions are available in these environments, check out the Capability System guide.