Desktop App
What It Does
SuperClaws Desktop gives you a persistent desktop companion for your AI agent, with three core capabilities:
- Upload files to your agent — drag files onto the app or use the file picker to send documents, spreadsheets, images, and other files to ClawBox, where your agent can access them
- Receive files from your agent — when your agent creates or processes a file, it deposits the result into ClawBox; the desktop app shows all available files and lets you open them with one click
- Send instructions directly — use the Agent Inbox to type a quick task and send it to your agent without switching to Telegram or the web dashboard
ClawBox — Two-Way File Sharing
ClawBox is the shared file layer between you and your agent. Think of it as a shared folder that both you and your agent can read and write to.
Drag any file onto the Upload panel in the desktop app, or click to open a file picker. The file is uploaded to ClawBox and immediately becomes accessible to your agent. You can then send an instruction telling your agent what to do with it.
When your agent generates a report, exports data, or creates any output file, it deposits it into ClawBox. The My Files panel in the desktop app lists all your ClawBox files with their names, sizes, and upload times. Click any file to open it in your default application.
Agent Inbox
The Agent Inbox panel gives you a real-time view of tasks in your agent's queue, as well as a quick-send field for dispatching new instructions without leaving the desktop app.
To send a task:
- Click Agent Inbox in the sidebar
- Type your instruction in the "Send a quick task to your agent" field
- Press Enter (or click Send)
Your agent picks up the task during its next heartbeat and processes it automatically. Completed tasks move to the Done section of the inbox.
Watched Folders
Watched Folders let you monitor directories on your computer and surface new files for your agent. When a new file appears in a watched folder, you can quickly upload it to ClawBox and dispatch an instruction in one step.
To add a watched folder:
- Click Watched Folders in the sidebar
- Click + Add Folder… and select a directory on your computer
- The app monitors that folder and highlights new files as they arrive
Download SuperClaws Desktop
Choose your platform below. The Windows build is coming soon.
Installing on Mac
Double-click the .dmg to mount it. A window will appear showing the SuperClaws Desktop app and a shortcut to your Applications folder.
Drag SuperClaws Desktop.app into the Applications folder shortcut in the same window.
Go to Applications, right-click SuperClaws Desktop, and choose Open. On first launch macOS may show a Gatekeeper prompt — click Open to proceed. You only need to do this once.
Installing on Windows
Double-click the downloaded .exe installer. If Windows SmartScreen shows a warning, click More info then Run anyway.
Accept the licence, choose an install location, and click Install. The app will launch automatically when setup completes.
Signing In
SuperClaws Desktop uses your existing SuperClaws account — there is no separate login to manage.
- Open the app — you will see a Sign In screen
- Click Sign in with SuperClaws — your browser opens and takes you to the dashboard login page
- Log in (or proceed if already logged in) — the dashboard redirects back and authorises the desktop app automatically
- The app switches to the main interface once authorised
Tips and Best Practices
- Upload before instructing — upload your file to ClawBox first, then send the instruction. Your agent needs the file accessible in ClawBox before it can act on it.
- Name files clearly — when your agent references a file, it uses the filename. Descriptive names like
Q1_Sales_Report.xlsxhelp your agent and your own future reference. - Use Watched Folders for recurring inputs — if you regularly export from another tool, point a watched folder at the exports directory so new files are surfaced automatically.
- Check the inbox for status — after sending a task, the Agent Inbox shows its status (pending → done). If a task is taking longer than expected, your agent may be processing a large file or waiting on an external service.