使用说明
openclaw-molt-mcp
MCP server + webapp that bridge Cursor and Claude Desktop to OpenClaw and Moltbook. openclaw-molt-mcp uses those platforms (Gateway, APIs); it does not implement or replace them. Alpha. Ingest for LLMs: gitingest.com/sandraschi/openclaw-molt-mcp.
What this repo is
| Part | What it does |
|---|---|
| MCP server (stdio) | FastMCP 3.1.0+ tools: agent, sessions, channels, routing, skills, gateway, security, moltbook. For Cursor/Claude Desktop. |
| Webapp (React + Vite + Tailwind) | Dashboard on port 10744: Startpage, AI (Ollama), Channels, Routes, Diagram, Statistics, Moltbook, Integrations, Clawnews, Skills, Security, Generate landing (landing-site generator), Settings. |
| webapp_api (FastAPI) | Backend on 10745: /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.
Quick Start
git clone https://github.com/sandraschi/openclaw-molt-mcp
cd openclaw-molt-mcp
just
This opens an interactive dashboard showing all available commands. Run just bootstrap to install dependencies, then just serve or just dev to start.
Manual Setup
If you don't have just installed:
Install & run
Clone-based or MCPB Bundle. See INSTALL.md for: clone repo, install from source, MCP only or webapp (API + frontend), one-shot scripts, config, logging, checks.
- MCPB: A standard
openclaw-molt-mcp.mcpbbundle is available for one-click import into compliant clients.
Repo layout
- src/openclaw_molt_mcp/ MCP server and tools
- webapp/ React dashboard (port 10744)
- webapp_api/ FastAPI backend (port 10745)
- 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-molt-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.md | Documentation index |
| docs/ONBOARDING.md | First-timer: OpenClaw + Moltbook accounts/keys |
| docs/CONFIGURATION.md | Env vars and config |
| docs/TOOLS.md | MCP tool reference |
| docs/DEVELOPMENT.md | Dev setup and quality gates |
| docs/TROUBLESHOOTING.md | Symptom → fix |
| docs/README_WEBAPP.md | Webapp pages, API, Logger |
| docs/README_openclaw_molt_mcp_TOOLS.md | MCP tools (narrative) |
| 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-molt-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. Cursors MCP discovery) may crawl GitHub without a manifest.
References
This README is formatted to render well on the GitHub repo page (pretty-printed).
Installation
Prerequisites
- uv installed (RECOMMENDED)
- Python 3.12+
Quick Start
Run immediately via uvx:
uvx openclaw-molt-mcp
Claude Desktop Integration
Add to your claude_desktop_config.json:
"mcpServers": {
"openclaw-molt-mcp": {
"command": "uv",
"args": ["--directory", "D:/Dev/repos/openclaw-molt-mcp", "run", "openclaw-molt-mcp"]
}
}
🛡️ Industrial Quality Stack
This project adheres to SOTA 14.1 industrial standards for high-fidelity agentic orchestration:
- Python (Core): Ruff for linting and formatting. Zero-tolerance for
printstatements in core handlers (T201). - Webapp (UI): Biome for sub-millisecond linting. Strict
noConsoleLogenforcement. - Protocol Compliance: Hardened
stdout/stderrisolation to ensure crash-resistant JSON-RPC communication. - Automation: Justfile recipes for all fleet operations (
just lint,just fix,just dev). - Security: Automated audits via
banditandsafety.
