Files
openclaw-workspace/docker/discord-voice-bot/MCP_README.md
2026-04-11 09:45:12 -05:00

2.8 KiB

OpenClaw MCP Server for GLaDOS

This MCP (Model Context Protocol) server exposes OpenClaw capabilities to GLaDOS, allowing GLaDOS to call OpenClaw tools and agents.

What is MCP?

MCP is a protocol for connecting AI assistants to tools and data sources. GLaDOS uses MCP to discover and call external tools dynamically.

Installation

  1. Install MCP package:
pip install mcp
  1. Verify GLaDOS MCP support:
python -c "from glados.mcp import MCPManager; print('OK')"

Tools Available

The OpenClaw MCP server exposes these tools to GLaDOS:

  • read_file(path) — Read file contents
  • write_file(path, content, append=False) — Write files
  • exec_command(command, timeout=30) — Run shell commands
  • list_workspace_files(directory=".", pattern="*") — List files
  • web_search(query, count=5) — Search the web
  • spawn_subagent(task, model="default", timeout=120) — Spawn OpenClaw sub-agents
  • send_discord_message(channel_id, message) — Send Discord messages
  • get_openclaw_status() — Get OpenClaw gateway status

Configuration

Add to your GLaDOS config.yaml:

Glados:
  # ... your existing config ...
  
  mcp_servers:
    - name: "openclaw"
      transport: "stdio"
      command: "python"
      args:
        - "C:\Users\admin\.openclaw\workspace\discord-voice-bot\openclaw_mcp_server.py"
        - "stdio"
      allowed_tools: null  # Allow all tools, or specify a list

How It Works

  1. GLaDOS starts and connects to the OpenClaw MCP server via stdio
  2. OpenClaw server registers its tools with GLaDOS
  3. When you talk to GLaDOS, it can call OpenClaw tools
  4. Results are spoken back to you

Example Interactions

You: "GLaDOS, what's in my workspace?"
GLaDOS: calls list_workspace_files() "You have several Python files. Would you like me to read one?"

You: "Check the weather"
GLaDOS: calls OpenClaw web search "It's currently 72 degrees and sunny. Not that you go outside much."

You: "Fix the bug in main.py"
GLaDOS: calls read_file(), analyzes, calls write_file() "Fixed your sloppy code. You're welcome."

Running Standalone

Test the MCP server independently:

# Stdio mode (for GLaDOS integration)
python openclaw_mcp_server.py stdio

# HTTP mode (for external connections)
python openclaw_mcp_server.py http --port 8081

Troubleshooting

GLaDOS doesn't see the tools:

  • Check GLaDOS logs for MCP connection errors
  • Verify the path to openclaw_mcp_server.py is correct
  • Ensure mcp package is installed in the same Python environment as GLaDOS

Tools fail to execute:

  • Check OpenClaw gateway is running
  • Verify Discord token in config.yaml (for messaging tools)
  • Review server logs for detailed errors

Permission errors:

  • The MCP server runs with the same permissions as GLaDOS
  • File operations are restricted to the OpenClaw workspace