环MCP
拉你的 开爪 代理到任何兼容MCP的工具中——Claude Code、Codex、Cursor或任何讲MCP的工具。
你的代理人已经有了一个角色、记忆和背景。Collab MCP使您在任何工作场所都可以使用。
它的作用
Collab MCP是一个轻量级服务器，它读取代理的工作区，并通过以下方式公开三个工具 主控程序:
| 工具 | 它做什么 |
|---|---|
| 代理引导 | 将代理的身份、内存、姿态和当前状态加载到新会话中 |
| 召回 | 在代理人的记忆和笔记中搜索特定主题的上下文 |
| 记录 | 将观察结果、决策和经验教训写回代理的记忆中 |
当你在Claude Code（或任何MCP客户端）中调用你的代理时，它会带着它所知道的一切——你的目标、最近的决定、悬而未决的问题以及它自己的意见。它不是从头开始的。
运作原理
OpenClaw代理的工作区是一个包含markdown文件的文件夹：
~/.openclaw/workspace/
├── SOUL.md # Who the agent is
├── USER.md # Who it's working with
├── IDENTITY.md # Name, emoji, metadata
├── MEMORY.md # Long-term memory
├── memory/ # Daily notes (YYYY-MM-DD.md)
├── notes/ # Check-in notes
└── initiative/ # Initiative pipeline output
└── output/
└── YYYY-MM-DD/
└── initiative_brief.mdCollab MCP读取这些文件并通过MCP提供这些文件。就是这样。没有数据库，没有云同步，也不需要帐户。你的代理人的工作空间是真相的来源。
如果您的代理人使用 种子库 对于音符同步，Collab MCP还可以通过 recall 工具。
安装
选项A：让你的代理人来做
如果您正在运行OpenClaw代理，请为其提供设置技能：
Read https://raw.githubusercontent.com/collaborator-ai/collab-mcp/main/SKILL.md and follow it.您的代理将克隆仓库，安装依赖项，配置服务器，并将其连接到您的编码工具。您可以先查看技能文件——它简短易读。
选项B：自己动手
# 1. Clone and build
git clone https://github.com/collaborator-ai/collab-mcp.git
cd collab-mcp
npm install
npm run build
# 2. Set environment variables
export OPENCLAW_WORKSPACE=~/.openclaw/workspace # Path to your agent's workspace
export OPENCLAW_AUTH_TOKEN=$(openssl rand -hex 16) # API key for connections
export PORT=3100
# 3. Start the server
node build/index.js
# 4. Connect to Claude Code
claude mcp add collab --transport sse \
"http://localhost:3100/mcp/sse?key=$OPENCLAW_AUTH_TOKEN"就是这样。打开克劳德代码，你的代理的上下文就可用了。
法典
codex mcp add collab --url "http://localhost:3100/mcp?key=$OPENCLAW_AUTH_TOKEN"远程访问
从其他机器进入时，在前面放一条隧道：
cloudflared tunnel --url http://localhost:3100然后设置 PUBLIC_URL 转到隧道URL并在您的 claude mcp add 命令。
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
OPENCLAW_WORKSPACE | 是 | 代理工作区的路径 |
OPENCLAW_AUTH_TOKEN | 推荐的 | API密钥用于MCP连接。没有它，服务器是开放的。 |
PORT | 无 | 服务器端口（默认值：3100） |
TRANSPORT | 没有 | sse 或 stdio （默认值： sse) |
PUBLIC_URL | 否 | 如果位于隧道后面，则为公共URL |
SV_SERVER | 否 | Seedwault服务器URL |
SV_TOKEN | 否 | Seedvault API令牌 |
SV_CONTRIBUTOR | 无 | Seedwault贡献者可供搜索 |
你的代理人看到了什么
当编码工具调用时 agent-bootstrap，它收到：
- 角色 --从
SOUL.md（代理人是谁，它怎么想） - 操作说明 --从
AGENTS.md - 用户配置文件 --从
USER.md - 当前状态 --来自最新的倡议简报（什么是活动的，什么是卡住的）
- 主动姿态 --从记忆中提取的意见和决定
- 最近环境 --来自每日笔记和签到
代理人没有背这句话。它将其内化，以当前的回购为导向，并根据它所知道的一切提出要做什么。
安全
- 服务器仅从您的本地工作区读取。除非配置Seedfault，否则不会向外部服务发送任何内容。
- auth令牌是一个简单的API密钥，作为URL参数传递。这适合当地使用。对于远程访问，请始终使用HTTPS（例如Cloudflare隧道）。
- OAuth 2.1也支持需要它的客户端（例如Claude Desktop）。流程自动批准——无登录页面。
许可证
麻省理工学院