Agent Workspace

Understanding the agent's file workspace.

Overview

The agent workspace is a directory where agents can read and write files during operations.

Default Location

~/.config/openclaw/workspace/

Workspace Structure

workspace/
├── downloads/      # Downloaded files
├── uploads/        # User uploads
├── temp/           # Temporary files
├── projects/       # Project directories
└── output/         # Generated output

Configuration

{
  workspace: {
    path: "~/.config/openclaw/workspace",
    maxSize: "1GB",
    cleanupAge: "7d"
  }
}

File Operations

Agents can:

• Read files in the workspace
• Write new files
• Create directories
• Execute scripts (if enabled)

Security

Sandboxing

File operations can be sandboxed:

{
  workspace: {
    sandbox: true,
    allowedPaths: [
      "~/Documents",
      "~/Projects"
    ]
  }
}

Permissions

Control what operations are allowed:

{
  workspace: {
    permissions: {
      read: true,
      write: true,
      execute: false
    }
  }
}

See Also

• Gateway Sandboxing
• Tools