How to Set Up OpenClaw MCP Server

Model Context Protocol (MCP) is an open standard for connecting AI models to external tools and services. It lets agents call into storage systems, APIs, databases, and custom tools using a consistent interface. Anthropic published the spec, but any vendor or developer can build an MCP server against it.

OpenClaw is an open-source local AI assistant that runs on your machine. It works alongside messaging apps like WhatsApp, Telegram, and Discord, and adds capabilities through skills from ClawHub. When you install an MCP skill, OpenClaw registers those tools and can call them during agent execution.

You can connect OpenClaw to any MCP server. There are community servers for databases, code execution, browser automation, and more. Fastio's hosted MCP server at mcp.fast.io is one option, focused on file storage and collaboration. It exposes 19 consolidated tools covering workspaces, file operations, sharing, AI chat, webhooks, URL imports, and file locks.

The Fastio ClawHub skill (dbalve/fast-io) installs and registers those tools with a single command, with no config files and no environment variables. It's a good fit if you want cloud storage with built-in RAG and don't want to host anything yourself.

Before setting up OpenClaw with any MCP server, you need a working OpenClaw instance.

Runtime:

• Node.js 24 recommended. Node 22 LTS (22.16+) still supported.
• Install OpenClaw: npm install -g openclaw@latest
• Then run openclaw onboard --install-daemon to configure your LLM and messaging channels.

LLM backend:

• An API key for your preferred provider: Anthropic, OpenAI, Google, or a local model via Ollama.
• OpenClaw prompts for this during onboarding.

For Fastio specifically:

• No account needed upfront. The first tool call triggers browser-based OAuth and creates your account.
• There is no permanent free tier. To run an organization, start a 14-day trial (a credit card is required) or take a subscription. Storage and seats come with the plan, and included credits cover AI work.

This covers connecting OpenClaw to Fastio's MCP server using the ClawHub skill. If you want to connect a different MCP server, the pattern is similar: install the relevant skill or configure the server URL directly in OpenClaw's config.

Step 1: Install OpenClaw

npm install -g openclaw@latest
openclaw onboard --install-daemon

Follow the prompts to set your LLM provider and optional messaging channels. See openclaw.ai for details.

Step 2: Install the Fastio skill

npx clawhub@latest install dbalve/fast-io

or, if you have clawhub installed globally:

clawhub install dbalve/fast-io

This registers 19 MCP tools for file management, sharing, and AI queries. No additional config required.

Step 3: Authenticate Send your OpenClaw instance a message: "Use Fastio storage" or "Set up Fastio." A browser tab opens for OAuth. Sign up and start a 14-day trial, or log in to an existing account. The session token persists across restarts.

Step 4: Verify Test with a few natural language commands:

• "List my workspaces"
• "Create a workspace called 'mcp-demo'"
• "Upload a note 'test.md' with content 'MCP setup successful'"

Check app.Fastio to confirm the workspace and file appeared. If something fails, see the troubleshooting section below.

Connect OpenClaw to Fastio MCP

One command installs 19 MCP tools for file management, sharing, and AI queries. Start with a 14-day trial.

Install Skill

Run through these checks to confirm the setup works end to end.

1. Basic file operations:

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

You should get a workspace ID, a node ID for the file, and a confirmation. Browse to app.Fastio to see it.

2. RAG query:

   "Enable intelligence on 'test-mcp'. Query: summarize workspace contents."
  

With intelligence mode on, uploaded files get indexed. The response should cite 'hello.md'.

3. Share creation:

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

You'll get a share ID and a branded link you can open in a browser.

4. URL import:

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

Should return an import job ID and a node ID once complete.

5. File lock:

   "Acquire lock on 'hello.md'. List locks. Release it."
  

You should see a lock token appear and then clear.

Node IDs look like f3jm5-zqzfx-.... Check openclaw logs if anything returns an error.

Here are some things you can do once the integration is running.

Attachment archiving:

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

OpenClaw creates the workspace, uploads files, organizes into folders. The result is browsable at app.Fastio.

Document Q&A: Upload contracts or research PDFs to a workspace and enable intelligence mode.

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

The built-in RAG pipeline indexes files and returns citations with page references.

Client data room:

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

Produces a share link with file previews. Audit logs track views.

Multi-agent coordination:

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

File locks prevent agents from writing to the same file simultaneously.

Ownership handoff:

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

A human claims the workspace via the link and can upgrade the plan. The agent keeps admin access.

Auth fails or token expired: Run openclaw logout, then try "Use Fastio" again. PKCE handles OAuth. If the browser tab gets stuck, disable any extensions blocking popups and copy the auth code manually.

Credit limits (402 error): Included credits refresh with your billing period. Monitor with auth status. If you're hitting limits mid-workflow, overage runs $10 per 100,000 credits, or transfer the org to a human account so they can move up a plan at /pricing/.

Tool errors: Run openclaw doctor for diagnostics. Check openclaw logs for specifics. If a skill seems outdated, run openclaw update or reinstall with npx clawhub@latest install dbalve/fast-io.

No workspaces visible: Run org discover-external to find workspaces you've been invited to. Check auth status to confirm scopes.

RAG not working: Confirm intelligence mode is enabled (workspace update intelligence=true). Files need to reach ai_state: ready, which you can check with storage details. Large files take a minute to index.

Upload fails: Use a resumable upload for large files so a dropped connection resumes instead of restarting. Storage comes out of your plan allowance rather than your credits, so an upload failure is almost never a credit problem.

Still stuck: Check the Fastio MCP docs or the OpenClaw community.