# How to Transfer Ownership in OpenClaw Workspaces Ownership transfer in OpenClaw workspaces lets AI agents create Fastio organizations, build file structures, and hand them to human users. Agents organize assets, enable AI features, and generate transfer tokens that humans claim via a simple link. The process supports agent-to-human handoffs, with agents retaining admin access for ongoing support. Source: https://fast.io/resources/openclaw-ownership-transfer/ Last reviewed: 2026-02-17 ## What Is Ownership Transfer in OpenClaw? Ownership transfer allows OpenClaw agents to build complete Fastio organizations and workspaces, then transfer control to human users. Agents connect to the remote Fastio MCP server at `https://mcp.fast.io/mcp`, which provides a consolidated MCP toolset for authentication, organization management, file uploads, and claim link generation. Agents generate a 72-hour transfer token, send the claim link to a human, and step down to admin while retaining operational access. This enables clean agent-to-human workflows. ### Key Components - **Agent Account**: Created with `auth` action `signup`, then placed on a 14-day trial or subscription. - **Organization**: Built with `org` action `create`. - **Transfer Token**: Generated via `org` action `transfer-token-create`. ## Why Use Ownership Transfer in OpenClaw Workspaces? An agent building on a 14-day Business Trial (credit card required) works inside a defined plan allowance. Storage and seats come with the plan (Starter, Business, Growth; see [/pricing/](/pricing/)), and included credits meter AI operations. Ownership transfer hands the organization to a human who can add a permanent billing method and manage seats, while the agent retains its administrative role to continue executing tasks. ### Agent Tier Limits A trial runs for 14 days and carries the seat and storage allowance of the plan it is attached to. Included credits refresh with the billing period, and overage runs $10 per 100,000 credits. Transfer before the trial lapses so nothing stalls mid-project. ## Prerequisites for Transfer - Connect OpenClaw to Fastio's remote MCP server at `https://mcp.fast.io/mcp` using a scoped API key [Fastio docs](/storage-for-agents/). - Authenticate the agent session. - Build organization and workspaces using the consolidated MCP toolset. - Generate a transfer token with a 72-hour validity window. ## Step-by-Step Ownership Transfer Process **Step 1: Authenticate Agent** Authenticate using a long-lived scoped API key from Fastio settings. **Step 2: Create Organization** Call the organization creation tool to establish the new organization. Note the returned org_id. **Step 3: Build Workspaces** Create workspaces, configure folder permissions, and enable Intelligence for RAG indexing. Upload deliverables and documents. **Step 4: Generate Transfer Token** Call the transfer token tool to create a claim link with a 72-hour expiration window: `https://go.fast.io/claim?token=...` **Step 5: Human Claims Organization** The human recipient opens the claim link in their browser. Once claimed, ownership transfers immediately while the agent retains admin access. ### Token Management Revoke unused tokens: `transfer-token-delete`. Humans use `transfer-claim` if agent-assisted. ## After Transfer: What Changes? Human owns org, handles billing. Agent as admin: full access minus billing. Files, shares, AI state preserved. Audit logs capture transfer. Humans upgrade via dashboard. Agents continue via MCP tools. ## Troubleshooting Common Issues - **No transfer option**: Confirm agent account (verify authentication status). - **Token expired**: 72 hours max; create new. - **402 Payment Required**: Transfer or upgrade. - **External orgs**: Use `org` discover-external. Check [agent troubleshooting](https://fast.io/storage-for-agents/). ## Evidence and Benchmarks Fastio storage is persistent and organization-owned, so a workspace an agent builds survives the session that built it. That is a different model from ephemeral assistant storage, and Fastio's consolidated MCP toolset lets agents create organizations, manage files, and hand off ownership cleanly. ## Advanced Use Cases - Multi-agent builds: Coordinate via folder permissions and version history. - Client data rooms: Agent populates assets, transfers ownership to the client. - Reactive workflows: Realtime activity feeds and WebSocket events notify downstream systems of updates post-transfer. ## Best Practices Document handoff in notes. Test claims. Use PKCE for secure auth. Monitor credits pre-transfer. ## Frequently asked questions ### How does OpenClaw ownership transfer work? Agent builds org/workspaces, creates 72-hour token, shares claim URL. Human claims; agent keeps admin. ### What is agent-to-human handoff in OpenClaw? Agents prepare workspaces/shares, transfer ownership for human billing/management. ### Does agent lose access after transfer? No, retains admin role. ### What are the limits while an agent is building? An agent works inside the plan or trial attached to its organization. Storage and seats come with the plan, and included credits cover AI work such as ingestion and agent runs. A trial lasts 14 days and requires a credit card. ### How does an agent connect to Fastio in OpenClaw? Configure OpenClaw to connect to Fastio's remote MCP server at `https://mcp.fast.io/mcp` using a scoped API key to access consolidated workspace tools. ### Upgrade after transfer? Human upgrades via /pricing. ### Token duration? 72 hours; revoke if unused. ### How do multiple agents coordinate during setup? Agents coordinate using folder permissions, file version history, and Fastio's append-only audit log. ## About Fast.io Fast.io provides shared workspaces where people and AI agents work on the same files, with built-in semantic search and citation-backed chat over what they hold. Agents reach it through a remote MCP server at https://mcp.fast.io/mcp, a REST API at https://api.fast.io/current/, and a command line client published on npm as @vividengine/fastio-cli.