AI导哈

OpenClaw MCP服务器

OpenClaw MCP服务器是一个通过可流式HTTP传输将OpenClaw助手暴露给Claude Desktop或任何MCP客户端的服务，实现两个AI系统之间的交互。

  • by rodgco
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 rodgco/openclaw-mcp-server

使用说明

OpenClaw MCP服务器🏰

暴露你的 开爪 Claude Desktop（或任何MCP客户端）的助理 流式HTTP 运输。

这使您可以从Claude Desktop与您的OpenClaw助手进行交互，有效地连接两个AI系统。

✨ 特性

  • 可流式HTTP传输 --正确实施MCP规范
  • SSE流媒体 --实时响应
  • API密钥验证 --安全远程访问
  • 简易安装 --一个脚本来设置所有内容
  • 可配置的 --自定义bot名称、会话标签、端口
  • 系统集成 --开机自动启动

🚀 快速安装

在运行OpenClaw的服务器上：

# Clone the repo
git clone https://github.com/rodgco/openclaw-mcp-server.git
cd openclaw-mcp-server

# Run installer
./install.sh

安装程序将：

  1. ✅ 检查Node.js 18+和OpenClaw
  2. 📦 安装依赖项
  3. 🔑 生成API密钥
  4. ⚙️ 询问您的机器人名称和会话标签
  5. 🚀 创建systemd服务（可选）
  6. 📋 输出Claude Desktop配置

📋 手动安装

如果您更喜欢手动设置：

# Clone and install
git clone https://github.com/rodgco/openclaw-mcp-server.git
cd openclaw-mcp-server
npm install

# Configure
cp .env.example .env
# Edit .env with your settings

# Generate API key
openssl rand -base64 32

# Run
npm start

⚙️ 配置

编辑 .env 文件：

# Name of your assistant/bot
BOT_NAME="MyAssistant"

# OpenClaw session label to connect to
OPENCLAW_SESSION_LABEL="main"

# API Key (generate with: openssl rand -base64 32)
MCP_SERVER_API_KEY="your-secret-key-here"

# Port to listen on
PORT=3721

# Bind address (0.0.0.0 for all interfaces)
BIND_ADDRESS="0.0.0.0"

# OpenClaw workspace path
OPENCLAW_WORKSPACE="${HOME}/.openclaw/workspace"

🖥️ Claude桌面配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "myassistant": {
      "transport": "streamable-http",
      "url": "http://YOUR_SERVER_IP:3721/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

配置文件位置：

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json
  • Linux： ~/.config/Claude/claude_desktop_config.json

🛠️ 可用工具

连接后，Claude Desktop可以使用以下工具：

ask

向您的OpenClaw助手发送消息或问题。

memory_search

搜索助手的长期记忆（memory.md）。

sessions_status

检查OpenClaw会话状态。

📡 运作原理

Claude Desktop (your computer)
    ↕️ HTTP POST/GET + SSE
http://your-server:3721/mcp
    ↕️
openclaw-mcp-server
    ↕️ openclaw sessions send
OpenClaw Assistant (remote server)
  1. Claude Desktop通过HTTP POST发送JSON-RPC请求
  2. MCP服务器将消息转发到OpenClaw会话
  3. 响应通过服务器发送事件（SSE）流式返回

🔧 systemd服务

如果使用脚本安装并选择systemd：

# Check status
sudo systemctl status openclaw-mcp-server

# View logs
sudo journalctl -u openclaw-mcp-server -f

# Restart
sudo systemctl restart openclaw-mcp-server

🔒 安全

  • 需要API密钥 对于所有MCP请求
  • 建议使用尾秤 用于安全的远程访问
  • 在没有额外保护的情况下，切勿将端口3721暴露于公共互联网
  • 考虑在生产环境中使用HTTPS（使用nginx/caddy的反向代理）

🧪 测试

# Health check
curl http://localhost:3721/health

# Server info
curl http://localhost:3721/

# Test MCP endpoint (requires auth)
curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
  http://localhost:3721/mcp

🗑️ 卸载

./uninstall.sh

或手动：

sudo systemctl stop openclaw-mcp-server
sudo systemctl disable openclaw-mcp-server
sudo rm /etc/systemd/system/openclaw-mcp-server.service
rm -rf ~/.openclaw/mcp-server

📚 MCP规范

此服务器实现 可流式HTTP传输 来自模型上下文协议规范。

🤝 贡献

欢迎拉取请求！请先打开一个问题来讨论更改。

📄 许可证

麻省理工学院

🔗 链接

相关 MCP