Working with Files

When you ask your bot to create something — a report, a spreadsheet, a script, an image — it saves the result to a secure folder on your server. The Files section in your Dashboard lets you browse, preview, and download those files without any technical setup.

No tunnels. No exposed ports. No sharing links. Just your files, in one place.

Where files go

Every file your bot creates lands in ~/files/ on your server. Your bot is instructed to save all output here by default, so you’ll always know where to look.

Files can be organised into subfolders — for example, your bot might create a ~/files/reports/ folder for weekly summaries or ~/files/code/ for scripts it writes. You can navigate into subfolders in the Dashboard just by tapping them.

Tip

You can tell your bot exactly where to save something: “Save that as a PDF in ~/files/invoices/”. It’ll create the folder if it doesn’t exist.

Browsing your files

Go to Dashboard → Content → Files to see everything saved so far. The list shows each file’s name, size, and when it was last modified.

• Tap a folder to navigate into it
• Use the breadcrumb at the top to jump back up
• Hit Refresh to pick up any new files your bot has just saved

Previewing files

Tap any filename to open a full preview — no download needed. The preview adapts to the file type:

Type	What you’ll see
Markdown (.md)	Rendered formatting, with a toggle to view raw text
HTML (.html)	Rendered page, with a toggle to view source
Images (.png, .jpg, .gif, .svg, .webp)	Inline image
Code & text (.txt, .csv, .json, .js, .py, etc.)	Plain text
PDF (.pdf)	Embedded PDF viewer
Video (.mp4)	Video player
Audio (.mp3, .wav)	Audio player

If a file type can’t be previewed, clicking the name won’t do anything — use the download button instead.

Copying the file path

Every file and folder has a copy path button (the clipboard icon) next to its name. Tapping it copies the full server path to your clipboard — for example:

~/files/reports/weekly-summary.md

This is useful when you want to tell your bot to read, update, or do something with a specific file: “Update the file at ~/files/reports/weekly-summary.md with today’s numbers.”

Downloading files

Click the Download icon next to any file (or the download button inside the preview panel) to save a copy to your device.

Note

Files up to ~6 MB can be downloaded directly. For larger files, ask your bot to compress or split them first.

Deleting files

Click the trash icon next to a file, then confirm. The file is removed from your server immediately and can’t be recovered.

If you have the file open in the preview panel when you delete it, the panel closes automatically.

Why not just open a port or tunnel?

Other setups often require you to expose a port on your server or use a tunneling service (like ngrok) so you can access files remotely. ClawOps doesn’t do this, for good reason:

• Open ports are attack surface. Every port exposed to the internet is one more thing that can be targeted, misconfigured, or exploited.
• Tunnels require ongoing trust. You’re routing your private files through a third-party service.
• It’s unnecessary complexity. You’d need to manage authentication, keep the tunnel running, and deal with URL changes.

The ClawOps approach is simpler and safer: your server stays closed, and the Dashboard fetches files on demand over the same secure connection it already uses for everything else. There’s nothing extra to configure, nothing extra to secure.

Tip

Your bot won’t spontaneously share files with anyone. Everything stays on your server until you explicitly download it.