Docs

ArkClaw Enterprise

File management

File space

During daily use, ArkClaw generates a large number of files (such as presentations, documents, images, videos, and code) in its workspace (.openclaw/) based on your task requirements. The platform provides the file space feature, which allows you to perform complete file management operations such as uploading, downloading, browsing, and deleting files in this directory while ensuring system security.

Feature differences

This section summarizes the differences between this feature and the cloud disk feature to help you choose as needed.

Feature name	Differences	Applicable scenario
File space	No extra charge Uses ArkClaw storage space Only supports uploading files in specific formats The size of each file to be uploaded cannot exceed 2 GB Only supports managing files in the ArkClaw workspace (the .openclaw/ directory).	Routine lightweight file interaction: Suitable for uploading small files such as text, code, or configuration to ArkClaw for processing, or downloading files generated by ArkClaw to your local device. For example, upload a CSV data file for ArkClaw to analyze, or download a PPT generated by ArkClaw to your local device.
Cloud disk	Requires extra payment Does not occupy ArkClaw storage space No restriction on uploaded file formats The size of each file to be uploaded cannot exceed 5 GB Mounted to ArkClaw as an independent disk	Large files and long-term storage: Suitable for uploading large files (such as video files and datasets) and storing files or data that are not limited by ArkClaw storage capacity for long-term use. For example, upload a 3 GB video file for ArkClaw to edit, or store project datasets in the cloud disk for on-demand access.

File category description

Workspace files are displayed in three categories in your file space. Output files are shown by default, and you can switch to Uploaded by me and All files categories to view files under the corresponding category.

Type	Description
Output files	Output files generated by a task or an agent that you pay close attention to (such as PPTs, documents, images, and code generated by ArkClaw).
Uploaded by me	Files or folders that you proactively upload to the workspace (including files uploaded through a conversation), as well as folders that you create yourself.
All files	Displays all files in the workspace, including output files, your uploads, and system files.

View workspace file information

Switch to the target ArkClaw page, and select "File management" in the directory tree on the left.

Select the "File space" tab.

For first-time use, click "Install now" to install the file space system components.

You can quickly locate a target file in the following ways.

If you are prompted that the claw-prism-plugin plugin is not installed or its version is outdated, click the "Check for updates" button. In the dialog box that appears, confirm the plugin update and click "Confirm" to complete the upgrade

Filter by category: Click the "Output files" button, and then select "Output files”, “Uploaded by me”, or "All files" from the drop-down list.

Filter by file type: Click the "All types" button and then select Document, PPT, PDF, Image, Video, Audio, Website, Markdown, Code, Compressed package, or Other from the drop-down list.

Filter by agent type: Click the "All agents" button and select the target agent from the drop-down list. This feature is available only when the file category is set to Output files.

Search by keyword: Enter a file name keyword in the search box, and the system matches files within the current view.

Upload/download workspace files

You can upload local corpus, configuration files, and other data to the workspace for ArkClaw to use. For files generated by ArkClaw in the workspace, you can also download them to your local device without transfers through messaging channels.

Upload file/folder

Download workspace file/folder

warning

You can upload files only in certain formats, including .md, .txt, .pdf, .json, .yaml, .csv, .py, .png, and .jpg.

You can only upload files or folders up to 2 GB in size.

Ensure that your ArkClaw has sufficient storage capacity to store files to be uploaded. Otherwise, the upload fails.

On the File space tab, click the "Upload" button and select "Upload file" or "Upload folder" as needed.

To upload files to a specific directory, first enter the target directory and then perform the upload.

In the pop-up window, select the local file or folder you need to upload to ArkClaw.

You can view the upload progress in the lower right corner. Before the upload is complete, you can pause or delete the upload task as needed.

After the file is uploaded, click "... > Reference to task" on the right of the file to reference it in the chat box and have ArkClaw use this file to complete the task. For details, refer to Reference files to tasks.

More operations

You can also create, delete, share, and move files or folders within your ArkClaw workspace or transfer them to your cloud disk.

Actions	Description
Reference files to tasks	You can reference files from file space directly to a task, without uploading them again. In the file list, select one or more files to be referenced. Single file: Select "··· > Reference to task" on the right of the target file. Multiple files: Select the target files, and click "Reference to task" at the bottom of the page. In the pop-up dialog box, select a reference method: Reference to a new task: Use the selected file as input to create a new task conversation. Reference to an existing task: Add the selected file to the conversation context of an existing task. After you make your selection, click the "Confirm" button. The system redirects you to the corresponding task page, where you can continue entering commands and interacting with ArkClaw.
Preview files	You can preview files in the workspace directly in file space without downloading them locally first. tip Only certain file types can be previewed. Actual supported file types take precedence. In the file list, click the name of the target file. A preview window pops up in the center of the page, where you can view the file content. To view in full screen, click the "Full screen" button in the upper-right corner of the preview window to switch to the full-screen preview. During preview, you can perform the following operations directly: Download locally: Click the download icon to save the currently previewed file to your local device. Reference to task: Reference the current file as input in a new or existing task. Share: Generate a short link for the current file to share. Click the × button in the upper-right corner to close the preview and return to the file list.
Share outputs	To share output files or uploaded files with external collaborators, generate a link and send it to them for file viewing. tip You can share only the following file types: web pages, code files, images, PDFs, and PPTs. Files larger than 8 MB cannot be shared. In the file list, select one or more files to be shared. Single file: Select "··· > Share" on the right of the target file. Multiple files: Select the target files and click "Share" at the bottom of the page. In the pop-up dialog box, click "Copy link" and share the link with collaborators.
Move a file/folder	To archive files by project or category, you can move uploaded or newly created files and folders to another directory in the workspace. In the file list, click "... > Move" on the right of the file or folder to be moved. In the directory tree of the dialog box, select the target directory (for example, git), and then click "Confirm" to complete the operation.
Rename a file/folder	You can rename your uploaded or newly created files and folders for semantic categorization as needed. tip Only files under the "All files" category can be renamed. The renaming operation is unavailable after you switch to the "Output files" or "Personal files" category. In file space, click the category drop-down menu at the top, and then select "All files". In the file list, locate the file or folder you want to rename, and click "... > Rename" on the right of the target file or folder. Enter the new name in the pop-up window and click the "Confirm" button to complete the operation.
Transfer to cloud disk	If you need to store uploaded project files or output files for the long term, you can save them using the "My cloud disk" feature. In the file list, locate the target file and click the "... > Transfer to cloud disk" button on the right. When the system returns "Transferred to cloud disk", the file has been transferred. The system automatically creates a Transferred file folder in My cloud disk. Select the "My cloud disk" tab, and then click the "Transferred file" button to view transferred files.
Create folders	If you plan to upload files of different projects or categories, you can create multiple folders to categorize, making it easier for ArkClaw to read files from the corresponding directories as needed for different tasks. Click the "Create folder" button. Enter the folder name in the pop-up window and click the "Confirm" button to complete the operation.
Delete a file/folder	If you no longer use a specific folder and all the files within it, you can delete the folder to free up storage space. warning To ensure the operational security of your ArkClaw instance, you cannot delete the core files, such as system and environment configuration files. For example, you cannot delete files such as openclaw.json, .env, and update-check.json. Click "... > Delete" on the right of the target file/folder. After confirming the risk information in the pop-up window, click the "Confirm" button to complete the operation.

Last updated: 2026.08.07 16:55:23