How to Set Up OpenClaw MCP Server

What is OpenClaw and MCP?

OpenClaw is an open-source local AI assistant that runs on your machine. It works alongside messaging apps like WhatsApp, Telegram, Discord, voice, browser automation, and skills from ClawHub. MCP stands for Model Context Protocol, the open standard for connecting AI models to external tools and servers.

Fast.io hosts a production MCP server at mcp.fast.io with 251 tools covering workspaces, file storage, sharing, AI chat, webhooks, URL imports, file locks, and more. This allows OpenClaw agents to access cloud-based intelligent workspaces without self-hosting infrastructure.

The Fast.io ClawHub skill (dbalve/fast-io) bundles 14 key MCP tools for natural language file management. Examples include "save recent WhatsApp attachments to a workspace", "query all PDFs for indemnity clauses", or "create a branded share for Q4 reports expiring in 30 days".

This integration provides persistent cloud storage, real-time collaboration, built-in RAG for document querying, and ownership transfer workflows. Agents build workspaces and hand them off to humans easily. For full MCP tool details, see the Fast.io agent storage docs.

OpenClaw MCP Prerequisites

Before setting up OpenClaw with Fast.io's MCP server, verify these requirements:

Essential Software:

• Node.js (version 22 or higher recommended for latest features and security)
• OpenClaw installed via npm install -g openclaw@latest. Follow the OpenClaw guide for details.
• Terminal or command prompt access for installation.

AI Backend:

• LLM API key configured in OpenClaw. Supported providers include Anthropic (Claude), OpenAI (GPT), Google (Gemini), and local models via Ollama or similar.
• Run openclaw onboard --install-daemon to set up your preferred LLM and test connectivity.

Communication Channels (Optional but Recommended):

• Messaging apps like WhatsApp, Telegram, Discord, or iMessage for natural interaction.
• OpenClaw handles setup automatically during onboarding.

No Fast.io account is required upfront. The first tool invocation triggers browser-based authentication, creating a free agent account automatically. The agent free tier includes 50GB storage and 5,000 monthly credits.

Step-by-Step OpenClaw MCP Setup

Setting up OpenClaw with Fast.io's MCP server takes a few minutes. Follow these steps.

Step 1: Install OpenClaw Open your terminal and run:

npm install -g openclaw@latest

This installs the latest OpenClaw CLI. Then onboard your instance:

openclaw onboard --install-daemon

Follow prompts to configure your LLM provider (e.g., Anthropic Claude API key) and messaging channels. See OpenClaw documentation for details.

Step 2: Install Fast.io ClawHub Skill Install the official Fast.io skill from ClawHub:

npx clawhub@latest install dbalve/fast-io

or

clawhub install dbalve/fast-io

This registers 14 optimized MCP tools for file management, sharing, and AI querying. No configuration files or environment variables needed. Zero-config setup.

Step 3: Authenticate with Fast.io Message your OpenClaw instance: "Use Fast.io storage" or "Set up Fast.io MCP." A browser tab opens for Fast.io authentication:

• Sign up for a free agent account (no credit card required).
• Or log in if you have one.
• Approve access (PKCE flow handles OAuth securely). The session token is saved automatically in durable storage, persistent across restarts.

Step 4: Verify Integration Test with natural language commands:

• "List my workspaces"
• "Create a test workspace called 'mcp-demo'"
• "Upload a note 'test.md' with content 'MCP setup successful'" Confirm at app.fast.io. You should see the new workspace and file.

Expected output includes node IDs, links, and status. If tools fail, check troubleshooting below.

Ready for OpenClaw MCP?

Install Fast.io skill for 251 MCP tools, 50GB free storage. One-command setup, any LLM. Built for openclaw mcp setup workflows.

Install Skill

Testing OpenClaw MCP Integration

Verify your setup works end-to-end with these practical tests. Each command demonstrates core MCP tools.

1. Basic Storage Operations:

   "Create workspace 'test-mcp'. Upload note 'hello.md' with content 'OpenClaw MCP test successful.' List contents."
   

   Expected: Workspace ID, note node ID, confirmation. Browse at app.fast.io.

2. AI Intelligence and RAG:

   "Enable intelligence on 'test-mcp'. Query 'Summarize workspace contents and note details.'"
   

   Expected: RAG response with citations to 'hello.md'. Check ai_state: ready via details.

3. Share Creation:

   "Create send share in 'test-mcp' for root folder. Set password 'test123', get public link."
   

   Expected: Share ID, branded link. Test link in browser for previews/downloads.

4. URL Import:

   "Import a public PDF like https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf to 'test-mcp'."
   

   Expected: Import job ID, node ID. For OAuth (Drive), first auth via PKCE.

5. File Lock (Advanced):

   "Acquire lock on 'hello.md'. List locks, then release it."
   

   Expected: Lock token, status updates.

Success indicators: Node IDs (e.g., f3jm5-zqzfx-...), links, no errors. Logs via openclaw logs. Troubleshoot if needed.

OpenClaw MCP Workflow Examples

Here are practical examples of OpenClaw workflows with Fast.io MCP tools.

Workflow 1: Attachment Archiving Attachments from WhatsApp/Telegram pile up quickly. Command:

"Save recent WhatsApp attachments to 'WhatsApp Archive' workspace. Create subfolders /images, /docs, /audio and sort files by type."

OpenClaw creates the workspace, uploads files, organizes into folders. View organized archive at app.fast.io.

Workflow 2: Document Q&A with RAG Upload contracts/PDFs to a project workspace, enable intelligence mode.

"Enable intelligence on 'contracts' workspace. Find all indemnity clauses across contracts, cite sources."

Built-in RAG indexes files automatically, retrieves relevant sections with page citations. Great for legal review or research.

Workflow 3: Client Delivery Data Room Generate reports, create branded shares.

"In 'Q4-reports' workspace, create a send share for root folder. Brand with client logo, password-protect, expire in 30 days."

Produces professional share link with previews, no downloads needed for review. Track views via audit logs.

Workflow 4: Multi-Agent Collaboration

"Invite agent@example.com to 'team-project' as member. Acquire lock on 'shared-doc.md' before editing."

File locks prevent conflicts. Agents + humans collaborate in real-time with presence indicators.

Workflow 5: URL Import and Analysis

"Import https://drive.google.com/file.pdf to 'research' workspace. Summarize key findings using AI chat."

OAuth pulls from Drive/Dropbox without local I/O. Intelligence mode indexes for instant querying.

Workflow 6: Ownership Handoff After building, transfer to human:

"Create transfer token for my org. Generate claim link."

Human claims via link, upgrades plan if needed. Agent retains admin.

These workflows use the 251 MCP tools with zero-config auth.

Troubleshooting OpenClaw MCP

Common issues and fixes:

Authentication Problems:

• Auth fails or token expires: Clear OpenClaw session (openclaw logout), retry "Use Fast.io". Verify email in Fast.io dashboard. Use PKCE browser flow for SSO.
• PKCE login stuck: Ensure no adblockers; copy code exactly.

Credit Limits (402 Error):

• 5,000 credits/month reset every 30 days. Monitor via auth status.
• Solution: Transfer org ownership to human account (guide in MCP docs), human upgrades at /pricing/.

Tool/Command Errors:

• openclaw doctor for diagnostics, check logs (openclaw logs).
• Update: openclaw update or reinstall skill.
• Network: Verify MCP endpoint reachable (`curl /storage-for-agents/).

No Workspaces/Orgs Visible:

• Run org discover-external for invited workspaces.
• Check auth status for scopes.

AI/RAG Not Working:

• Confirm intelligence enabled (workspace update intelligence=true).
• Files ai_state: ready (storage details).
• Scope queries correctly (folders_scope or default full workspace).

File Upload Fails:

• Max 1GB/file, check credits (100 credits/GB storage).
• Chunked uploads for large files.

Still Stuck?

• Review Fast.io MCP skill.md.
• OpenClaw community or Fast.io support.