openclaw-mcp
MCP server + webapp that bridge Cursor and Claude Desktop to OpenClaw and Moltbook. openclaw-mcp uses those platforms (Gateway, APIs); it does not implement or replace them. Alpha. Ingest for LLMs: gitingest.com/sandraschi/openclaw-mcp.
What this repo is
| Part | What it does |
|---|---|
| MCP server (stdio) | FastMCP 2.14+ tools: agent, sessions, channels, routing, skills, gateway, security, moltbook. For Cursor/Claude Desktop. |
| Webapp (React + Vite + Tailwind) | Dashboard on port 5180: Startpage, AI (Ollama), Channels, Routes, Diagram, Statistics, Moltbook, Integrations, Clawnews, Skills, Security, Generate landing (landing-site generator), Settings. |
| webapp_api (FastAPI) | Backend on 5181: /api/ask, /api/gateway/status, /api/skills, /api/clawnews, /api/ollama/*, /api/channels, /api/routing, /api/openclaw/status, /api/landing-page. |
One place to run agents, manage channels/routes/skills, and use Moltbook; OpenClaw and Moltbook stay separate.
Install & run
Clone-based (no PyPI package yet). See INSTALL.md for: clone repo, install from source, MCP only or webapp (API + frontend), one-shot scripts, config, logging, checks.
Repo layout
- src/openclaw_mcp/ – MCP server and tools
- webapp/ – React dashboard (port 5180)
- webapp_api/ – FastAPI backend (port 5181)
- scripts/ – install.ps1, install.bat, start.ps1, start.bat, check.ps1, serve_logs.ps1, mcpb-build.ps1
- snippets/ – MCP config snippet (snippets/mcp-config-openclaw-mcp.json); see INSTALL.md and mcp-central-docs pattern
Architecture – data flow, MCP vs API.
Docs
| Doc | Description |
|---|---|
| LICENSE | MIT license |
| CONTRIBUTING.md | How to contribute |
| INSTALL.md | Install, run, config, checks |
| docs/README_INDEX.md | Doc index |
| docs/README_WEBAPP.md | Webapp pages, API, Logger |
| docs/README_OPENCLAW_MCP_TOOLS.md | MCP tools |
| docs/README_OPENCLAW.md | OpenClaw (external) |
| docs/README_MOLTBOOK.md | Moltbook (external) |
| docs/HOW_THIS_WAS_MADE.md | How this was made (vibecode, Cursor, one day) |
| SECURITY.md | Threats, hardening |
Security
OpenClaw has major security risks. Use clawd_security; prefer VM and loopback. SECURITY.md, docs/SECURITY_HARDENING.md.
Repo manifests (LLM scrapers)
| File | Triggers | Purpose |
|---|---|---|
| glama.json | Glama GitHub scraper | MCP server listing: claim ownership, metadata, Docker, usage. Requires $schema + maintainers (GitHub usernames). Re-run claim flow on Glama after changes. |
| llms.txt | Gitingest, llmstxt.org | LLM-friendly manifest: H1 + blockquote summary + ## sections with links. Improves repo ingestion for LLMs (e.g. gitingest.com/sandraschi/openclaw-mcp). |
Other scrapers: no extra files needed. Gitingest ingests the repo (replace github.com with gitingest.com in the repo URL); llms.txt gives it a curated entry point. Glama is the main MCP-directory scraper that uses glama.json; others (e.g. Cursor’s MCP discovery) may crawl GitHub without a manifest.
References
This README is formatted to render well on the GitHub repo page (pretty-printed).