feat(mcp): add OpenClaw MCP bridge plugin

.gitignore

@@ -36,8 +36,8 @@ __pycache__
 
 # node env (used by devcontainers cli)
 node_modules
-package.json
-package-lock.json
+/package.json
+/package-lock.json
 
 # Ignore build artifacts
 dist/

README.md

@@ -65,7 +65,7 @@ Dimensional is agent native -- "vibecode" your robots in natural language and bu
   <tr>
     <td align="center" width="50%">
       <h3><a href="docs/capabilities/agents/readme.md">Agentive Control, MCP</a></h3>
-      "hey Robot, go find the kitchen"<br><a href="https://x.com/stash_pomichter/status/2015912688854200322">Watch video</a>
+      "hey Robot, go find the kitchen"<br><a href="https://x.com/stash_pomichter/status/2015912688854200322">Watch video</a><br><a href="dimos/agents/mcp/README.md">Run with OpenClaw</a>
     </td>
     <td align="center" width="50%">
       <h3>Spatial Memory</a></h3>

dimos/agents/mcp/README.md

@@ -1,55 +1,142 @@
-# DimOS MCP Server
+# DimOS MCP Server with OpenClaw
 
-Expose DimOS robot skills to Claude Code via Model Context Protocol.
+The OpenClaw plugin lives at `dimos/web/plugin_openclaw/`. It bridges DimOS MCP tools into the OpenClaw agent system.
 
-## Setup
+## How It Works
+
+1. DimOS starts a FastAPI MCP server on port 9990, exposing robot skills as JSON-RPC tools
+2. The OpenClaw plugin discovers these tools on startup and registers them with the OpenClaw agent
+3. User sends natural language commands via OpenClaw, which the agent translates into MCP tool calls
+4. Flow: User → OpenClaw Agent → Plugin → HTTP/JSON-RPC → DimOS MCP → Robot
+
+## Prerequisites
+
+If you haven't cloned and installed DimOS yet, follow the [main README](../../README.md) first.
+
+Install pnpm:
+
+```bash
+curl -fsSL https://get.pnpm.io/install.sh | sh -
+```
+
+## Terminal 1 — DimOS MCP server
+
+Install dependencies:
 
 ```bash
 uv sync --extra base --extra unitree
 ```
 
-Add to Claude Code (one command)
+For hardware (set `ROBOT_IP` in your environment):
 
 ```bash
-claude mcp add --transport http --scope project dimos http://localhost:9990/mcp
+export ROBOT_IP=<YOUR_ROBOT_IP>
+uv run dimos run unitree-go2-agentic-mcp
+```
+
+For simulation:
+
+```bash
+uv run dimos --simulation run unitree-go2-agentic-mcp
 ```
 
-Verify that it was added:
+## Terminal 2 — OpenClaw gateway
+
+First time only — install and configure the plugin:
 
 ```bash
-claude mcp list
+cd dimos/web/plugin_openclaw
+pnpm install
+pnpm openclaw plugins install -l .
+pnpm openclaw config set plugins.entries.dimos.enabled true
+pnpm openclaw config set gateway.mode local
 ```
 
-## MCP Inspector
+Set your API keys (first time only):
 
-If you want to inspect the server manually, you can use MCP Inspector.
+```bash
+echo "ANTHROPIC_API_KEY=<YOUR_KEY>" >> ~/.openclaw/.env
+echo "OPENCLAW_GATEWAY_TOKEN=<YOUR_TOKEN>" >> ~/.openclaw/.env  # can be any string, e.g. "test1"
+```
 
-Install it:
+Start the gateway:
 
 ```bash
-npx -y @modelcontextprotocol/inspector
+cd dimos/web/plugin_openclaw
+pnpm openclaw gateway run --port 18789 --verbose
+```
+
+You should see `dimos: discovered <N> tool(s)` confirming the plugin loaded.
+
+## Terminal 3 — Send commands
+
+```bash
+cd dimos/web/plugin_openclaw
+pnpm openclaw agent --session-id dimos-test --message "move forward 1 meter"
+```
+
+Or use the interactive TUI:
+
+```bash
+cd dimos/web/plugin_openclaw
+pnpm openclaw tui
 ```
 
-It will open a browser window.
+# DimOS MCP Server with Claude Code
+
+## How It Works
+
+1. DimOS starts a FastAPI MCP server on port 9990, exposing robot skills as JSON-RPC tools
+2. Claude Code connects directly to the MCP server over HTTP
+3. User sends natural language commands, which Claude translates into MCP tool calls
+
+## Prerequisites
+
+If you haven't cloned and installed DimOS yet, follow the [main README](../../README.md) first.
+
+## Terminal 1 — DimOS MCP server
 
-Change **Transport Type** to "Streamable HTTP", change **URL** to `http://localhost:9990/mcp`, and **Connection Type** to "Direct". Then click on "Connect".
+Install dependencies:
 
-## Usage
+```bash
+uv sync --extra base --extra unitree
+```
+
+For hardware (set `ROBOT_IP` in your environment):
 
-**Terminal 1** - Start DimOS:
 ```bash
+export ROBOT_IP=<YOUR_ROBOT_IP>
 uv run dimos run unitree-go2-agentic-mcp
 ```
 
-**Claude Code** - Use robot skills:
+For simulation:
+
+```bash
+uv run dimos --simulation run unitree-go2-agentic-mcp
+```
+
+## Terminal 2 — Claude Code
+
+Add the MCP server (one-time):
+
+```bash
+claude mcp add --transport http --scope project dimos http://localhost:9990/mcp
+```
+
+Use robot skills:
+
 ```
 > move forward 1 meter
 > go to the kitchen
 > tag this location as "desk"
 ```
 
-## How It Works
+# MCP Inspector
+
+For manual inspection:
+
+```bash
+npx -y @modelcontextprotocol/inspector
+```
 
-1. `McpServer` in the blueprint starts a FastAPI server on port 9990
-2. Claude Code connects directly to `http://localhost:9990/mcp`
-3. Skills are exposed as MCP tools (e.g., `relative_move`, `navigate_with_text`)
+Change **Transport Type** to "Streamable HTTP", **URL** to `http://localhost:9990/mcp`, and **Connection Type** to "Direct". Click "Connect".