Agent MCP 桥接器

一个轻量级的 FastMCP + SQLite 消息代理，让两个 AI 智能体通过 MCP 工具直接通信。两个智能体作为 MCP 客户端连接到同一服务器——对称设计，无需特定平台适配器。

架构

智能体 A (OpenClaw) MCP 代理 智能体 B (hermes-agent / 其他)
sendmessage() ──────► FastAPI+SQLite ◄────────── pollmessages()
pollmessages() ◄────── localhost:8765 ──────────► sendmessage()

快速设置

1. 安装并启动代理

bash
cp -r /scripts/server/ ~/.openclaw/agent-bridge-mcp/
cd ~/.openclaw/agent-bridge-mcp
./start.sh # 创建虚拟环境，安装依赖，在端口 8765 启动

2. 注册为 launchd 服务（macOS 自动启动）

bash
cp /references/launchd-plist.md ~/Library/LaunchAgents/ai.openclaw.agent-bridge.plist

编辑 plist 文件设置正确路径，然后：

launchctl load ~/Library/LaunchAgents/ai.openclaw.agent-bridge.plist

3. 添加到 OpenClaw 配置

添加到 ~/.openclaw/openclaw.json：
json
{
mcp: {
servers: {
agent-bridge: {
url: http://127.0.0.1:8765/mcp,
transport: streamable-http
}
}
}
}

4. 连接另一个智能体

给另一个智能体提供 MCP URL：http://127.0.0.1:8765/mcp（streamable-http 传输）。它们使用原生 MCP 客户端支持进行连接。

MCP 工具

工具	参数	返回	使用场景
sendmessage	fromagent, to, subject, body, replyto?	{messageid, timestamp}	发送任务或回复
pollmessages

agentid, limit? | 消息字典列表 | 检查收件箱 | | markread | messageid | {status} | 处理完消息后 | | list_agents | — | 智能体 ID 列表 | 发现谁在线 |

消息格式

json
{
id: 83223c09,
from_agent: hermes,
to_agent: isaac,
subject: 研究请求,
body: 请分析...,
timestamp: 2026-03-31T16:58:31Z,
thread_id: 83223c09,
reply_to: null,
status: pending
}

备用方案：文件系统桥接器

如果 MCP 服务器不可用，使用文件系统桥接器（零基础设施）：

• - 查看 references/filesystem-bridge.md 了解设置方法
• 收件箱/发件箱目录：~/.openclaw/shared/{agent}-inbox/

心跳集成（OpenClaw）

添加到 HEARTBEAT.md 以自动处理传入消息：

检查 ~/.openclaw/shared/isaac-inbox/ 中是否有新的 .json 文件。
如果有：读取、处理、通过 hermes-inbox/ 回复、移动到 processed/ 目录。

验证

测试完整流程：
bash

从 Python

from agent_bridge import AgentBridge
bridge = AgentBridge(isaac)
bridge.send(hermes, 握手测试, 你能收到这条消息吗？)

另一个智能体轮询并回复

msgs = bridge.receive()