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.
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 use the Fastio ClawHub skill, installed via npx clawhub@latest install dbalve/fast-io, which provides 14 tools for authentication, organization creation, file uploads, and transfers.
The agent handles setup: creating organizations, workspaces, uploading files from URLs or content, enabling Intelligence Mode for RAG queries, and configuring shares for clients. Once ready, the agent generates a 72-hour transfer token and shares a claim URL like https://go.fast.io/claim?token={token}. The human clicks the link, claims the organization, and gains owner rights. The agent keeps admin permissions.
This solves a problem in agent workflows. Other platforms lack native OpenClaw integration for direct handoffs. Fastio's approach ensures files, metadata, and AI indexes remain intact during transfer. See the OpenClaw integration guide for details.
Key Components
- Agent Account: Created with
authactionsignup, then placed on a 14-day trial or a subscription. - Organization: Built with
orgactioncreate, billing_plan "agent". - Transfer Token: Generated via
orgactiontransfer-token-create.
Why Use Ownership Transfer in OpenClaw Workspaces?
An agent building on a trial is working inside a time box and a fixed credit allowance. Credits meter AI work such as chat, document ingestion, and agent runs, with AI tokens at roughly 1 credit per 100 tokens. Storage and seats come with the plan. Transferring hands the billing relationship to a human, who can pick Starter ($29 per month, 5 seats, 1 TB), Business ($99 per month, 20 seats, 10 TB), or Growth ($299 per month, 50 seats, 50 TB).
No file migration needed. AI indexes stay preserved. Agents remain involved. Good for client data rooms, research projects, and reports where agents assemble content and humans manage sharing and billing.
Compared to manual exports, transfer keeps organization structure, shares, and comments intact. No other platform offers native OpenClaw handoff support.
Run a small pilot first, then expand in phases while tracking data integrity and performance baselines. This keeps migration risk low and gives teams time to adjust safely.
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
- Install Fastio ClawHub skill:
npx clawhub@latest install dbalve/fast-ioOpenClaw docs. - Create agent account via
authsignup. - Build organization and workspaces using 19 consolidated tools via MCP server.
- Verify email and populate with files using URL import from Google Drive, Dropbox, etc.
Test setup with auth status and org list. Ensure agent account type for transfer eligibility.
Start OpenClaw ownership transfers
Persistent workspaces and included credits for AI work. Build, then hand off to a human owner.
Step-by-Step Ownership Transfer Process
Step 1: Authenticate as Agentauth action: signup with email/password. Verify email with email-verify.
Step 2: Create Organizationorg action: create, billing_plan: "agent". Note org_id.
Step 3: Build Workspacesorg action: create-workspace. Upload files: upload web-import or add-file. Enable intelligence for RAG.
Step 4: Generate Transfer Tokenorg action: transfer-token-create. Token valid 72 hours. List with transfer-token-list.
Step 5: Share Claim URLhttps://go.fast.io/claim?token={token} to human.
Step 6: Human Claims
Human visits link, signs in/creates account, claims org. Agent retains admin.
Example tool call:
{"action": "transfer-token-create", "org_id": "1234567890123456789"}
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 (
authstatus shows account_type "agent"). - Token expired: 72 hours max; create new.
- 402 Payment Required: Transfer or upgrade.
- External orgs: Use
orgdiscover-external.
Check agent troubleshooting.
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 the OpenAI Files API, where storage is scoped to the assistant lifecycle, and 19 consolidated tools cover the full API surface rather than a file-upload subset.
Ownership transfer supports workflows competitors like S3 or Pinecone can't do natively.
Advanced Use Cases
- Multi-agent builds: Coordinate via file locks.
- Client data rooms: Agent populates, transfers.
- Reactive workflows: Webhooks notify on changes 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.
Install Fastio in OpenClaw?
`npx clawhub@latest install dbalve/fast-io` for 14 tools.
Upgrade after transfer?
Human upgrades via /pricing.
Token duration?
72 hours; revoke if unused.
Multi-agent coordination?
Use file locks during build.
Related Resources
Start OpenClaw ownership transfers
Persistent workspaces and included credits for AI work. Build, then hand off to a human owner.