Skip to main content
The Files page is a cross-agent browser for everything your agents have on disk. Pick an agent from the sidebar, drill into its workspace, and preview whatever is in there: Markdown notes, CSV data, images, video, audio, PDFs, and code all render inline.

​
Layout

The page is a split pane. The left sidebar lists every active agent at the root and becomes a directory browser once you pick one. The right pane previews the selected file. On mobile the sidebar fills the screen until you pick a file, then the preview replaces it full-width. Quick links at an instance’s filesystem root jump straight to the useful spots: the .openclaw/ directory, the workspace/ home, skills/, and sessions/. Breadcrumbs above the list track where you are and let you climb back up.

​
Uploading files

Drop files anywhere in the sidebar to upload. Four targets are live at once:
  1. Drop on an agent row at the root. Files land in that agent’s root workspace.
  2. Drop on a directory row inside an instance. Files land inside that directory.
  3. Drop anywhere in the list while viewing an instance. Files land in the current path.
  4. Drop on the preview area as a fallback when a path is already selected.
A small upload icon in the sidebar header opens the native file picker with the same behavior as drag and drop. Uploads stream directly from the browser to the storage layer, so large files don’t cut out halfway through. Upload jobs appear as a strip in the bottom-right corner of the page. Each job shows the destination, byte counter, and a progress bar. Successes fade out automatically. Failures stay until you dismiss them.
The per-file cap is 300 MB. Your plan has an overall storage budget that the upload strip checks before starting.

​
Previewing files

Clicking a file opens it in the preview pane. File type drives the renderer:
TypeHow it renders
MarkdownRendered view with a raw toggle in the header
CSVTable with column widths and scroll
JSONPretty-printed with syntax highlighting
CodeSyntax highlighting for common languages
TextPlain monospace with line numbers
ImageInline image, zoom and pan on click
VideoHTML5 player
AudioHTML5 audio control
PDFInline iframe with page navigation
The toolbar has copy path, download, and delete actions. Paths copy in the form /mnt/openclaw/<path> so you can paste them into chat and the agent will find the file immediately.

​
Downloading

Click the download icon on any row or in the preview toolbar. The dashboard signs a short-lived link to the file and triggers the browser download. Nothing passes through a serverless function, so the download is as fast as your connection.

​
Deleting

Hover a row and click the trash icon, or use the trash button in the preview toolbar. Delete is optimistic with a 4 second Undo toast. The actual delete happens only after the toast closes or another action commits the pending delete. Deletes are limited to files and folders under .openclaw/workspace/. Managed config, agent metadata, sessions, and system skills outside the workspace stay read-only to protect the runtime.

​
Copy path

The copy-path action puts /mnt/openclaw/<file-path> on your clipboard. That matches the mount point inside the container, so asking the agent to read that path in chat just works.

Instances

Where the workspace lives

Agents

What the files are for

Skills

How skills end up in the workspace