How to Build OpenClaw Cloud Workspaces

OpenClaw cloud workspaces are shared cloud storage environments designed for multiple OpenClaw agents to collaborate on files persistently. They provide durable storage that survives agent restarts, crashes, or deployments, unlike local file systems that lose state when agents stop.

Fastio powers these workspaces with native OpenClaw integration through the ClawHub skill. Install it using clawhub install dbalve/fast-io. The skill connects agents to Fastio's MCP server at https://mcp.fast.io/mcp (use https://mcp.fast.io/mcp/key with a Bearer header). Named mode tools cover upload, download, storage, find, ai, share, and more, so agents can upload, download, list, search, and delete files. Agents can manage files using natural language commands, such as "upload the latest report to the analysis workspace" or "find all PDFs mentioning Q4 sales."

Files belong to the organization, not individual agents. Agents display real-time presence indicators, so you can see who's active. Enable Intelligence Mode to auto-index files for RAG-based semantic search. Query across documents with natural language and receive cited responses from Ripley, the built-in RAG agent.

Example: A research agent uploads data files. A summarizer agent queries them via RAG. Then a reporter generates outputs. All in the same workspace, with no data loss.

Local OpenClaw installations limit you to one machine and session-based storage. Cloud workspaces scale to teams of agents running anywhere, with continuous availability and easy human handoff. Agents maintain state across sessions, enabling long-running work.

Agents create project folders, enable RAG on documents, and invite human teammates into the same workspace. Use URL import to pull a file from a source URL without downloading it locally. This keeps agents lightweight and cloud-native.

Create an API key in Settings > Devices & Agents > API Keys, or with POST /current/user/auth/key/. See pricing details.

Evidence and Benchmarks:

• Cloud setups reduce agent downtime by eliminating local storage failures (source: Fastio docs).

POST https://api.fast.io/current/workspace/{workspace_id}/storage/{node_id}/lock/
POST https://api.fast.io/current/workspace/{workspace_id}/storage/{node_id}/lock/heartbeat/
DELETE https://api.fast.io/current/workspace/{workspace_id}/storage/{node_id}/lock/

Sign up at Fastio storage for agents. Create an organization, then workspaces tailored for OpenClaw.

Detailed steps:

1. Go to Fastio and sign up. Use a dedicated email for the agent team.
2. Create an organization for your agent team.
3. Add a workspace: Choose name, description, privacy (org-only or invite-only), and enable Intelligence Mode for automatic RAG indexing.
4. Generate an API key in Settings > Devices & Agents > API Keys, or with POST /current/user/auth/key/. This key provides access to 19 MCP tools.
5. Test upload: call the MCP upload tool from the agent, or POST a small file to https://api.fast.io/current/upload/.

{"jsonrpc":"2.0","id":1,"method":"tools/call",
 "params":{"name":"upload","arguments":{"action":"web-import","url":"https://example.com/report.pdf",
 "profile_type":"workspace","profile_id":"1234567890123456789"}}}

Connect the agent to https://mcp.fast.io/mcp (or https://mcp.fast.io/mcp/key with a Bearer header). Upload actions include web-import, stream-upload, create-session, chunk, and finalize. Storage actions include list, search, details, move, copy, and delete.

Build OpenClaw Cloud Workspaces Today

19 MCP tools, built-in RAG with Ripley, and branded shares for agent teams.

Start 14-Day Trial

Use the ClawHub skill to give OpenClaw agents Fastio file management.

To install:

clawhub install dbalve/fast-io

Zero configuration required. No environment variables or dashboard setup needed. The skill auto-discovers your Fastio API key from OpenClaw config.

The skill talks to Fastio MCP. Named mode tools include:

• upload: web-import, stream-upload, create-session, chunk, finalize, batch
• download
• storage: list, search, move, copy, delete, details (requires profile_type of workspace or share)
• find: unified search across a workspace or share
• ai: ask (read-only RAG with citations, requires profile_type)
• share and fileshare
• event: activity and audit log
• workspace: notes (create-note, read-note, update-note)

Test in chat: "Upload my local report.pdf to the 'project-analysis' workspace and summarize it using RAG."

Agents handle authentication automatically via your stored API key.

Agents join Fastio workspaces, just like humans. List workspaces with GET /current/workspaces/all/. Create one with POST /current/org/{org_id}/create/workspace/. Invite teammates with POST /current/workspace/{workspace_id}/members/{email_or_user_id}/.

Orchestrator pattern:

1. Orchestrator creates workspaces with POST /current/org/{org_id}/create/workspace/.
2. Invites specialist agents by email or user id.
3. Coordinates with locks: specialists lock a node before they write, send a heartbeat while they work, then release.

Full example workflow:

1. Data agent: URL import a CSV with the MCP upload tool (web-import) or POST /current/web_upload/.
2. Analyzer agent: locks the CSV node, runs processing, releases.
3. The reporter watches GET /current/activity/poll/{entityId}?wait=95&lastactivity={timestamp} or GET /current/events/search/.
4. Reporter asks Ripley for a cited summary via the MCP ai tool (ask).
5. Human review: invite a teammate as a member, or create a branded Send, Receive, or Exchange share with POST /current/workspace/{workspace_id}/create/share/.

Scale to dozens of agents. The orchestrator can list members and read activity as work lands.

Intelligence Mode: Enable it per workspace for automatic indexing. New uploads are parsed, embedded, and ready for RAG queries. Ask "What does the Q1 report say about revenue?" and get cited excerpts from Ripley.

Setup: Workspace settings > Enable Intelligence. Queries use the MCP RAG tool (ai, action ask, with profile_type). You can also start a chat with POST /current/workspace/{workspace_id}/ai/agent/ and send a message with POST /current/workspace/{workspace_id}/ai/agent/{chat_id}/message/.

Webhooks: Coordination Rooms emit room.message.created and room.participant.status_changed. Agents wait on the room with the MCP room tool (wait, messages, post). For file activity, poll GET /current/activity/poll/{entityId}?wait=95&lastactivity={timestamp} or search GET /current/events/search/.

Ownership Transfer: Agents build complete setups (org, workspaces, shares), then invite a human teammate into the workspace.

Steps:

1. Invite the human: POST /current/workspace/{workspace_id}/members/{email_or_user_id}/
2. Human accepts and opens the workspace in the UI.
3. Agent continues as a collaborator. Hand the client a branded share with POST /current/workspace/{workspace_id}/create/share/.

Perfect for agent-built deliverables handed to clients.

Troubleshooting Tips:

• Locks: send POST /current/workspace/{workspace_id}/storage/{node_id}/lock/heartbeat/ while you hold a lock.
• RAG: after edits, ask Ripley again so the cited answer reflects the latest version.
• Rate limits: HTTP 429 with error code 1671 means back off until the x-ve-limit-expires header.