MCP
openclaw mcp 有两个职责：
- 使用
openclaw mcp serve将 OpenClaw 作为 MCP 服务器运行 - 使用
list、show、status、doctor、probe、add、set、configure、tools、login、logout、reload和unset管理由 OpenClaw 管理的出站 MCP 服务器定义
serve 是 OpenClaw 充当 MCP 服务器的模式。其他子命令则是让 OpenClaw 充当 MCP 客户端注册表，用于登记其自身运行时后续可能使用的服务器。
Note
list、show、set 和 unset 只读取和写入 OpenClaw 配置中由 OpenClaw 管理的 mcp.servers 条目。它们不包含来自 config/mcporter.json 的 mcporter 服务器；该注册表请使用 mcporter list。
当 OpenClaw 需要自行托管编码工具会话并将该运行时通过 ACP 路由时，请使用 openclaw acp。
选择正确的 MCP 路径¶
| 目标 | 使用方式 | 原因 |
|---|---|---|
| 让外部 MCP 客户端读取/发送 OpenClaw 频道对话 | openclaw mcp serve |
OpenClaw 是 MCP 服务器，并通过 stdio 暴露由 Gateway 支持的对话。 |
| 保存第三方 MCP 服务器，供 OpenClaw 管理的智能体运行使用 | openclaw mcp add、set、configure、tools、login |
OpenClaw 是 MCP 客户端注册表，随后会将这些服务器注入到符合条件的运行时。 |
| 在不运行智能体轮次的情况下检查已保存的服务器 | openclaw mcp status、doctor、probe |
status 和 doctor 检查配置；probe 打开实时 MCP 连接并列出能力。 |
| 从浏览器编辑 MCP 配置 | Control UI /settings/mcp（/mcp 别名） |
该页面显示清单、启用状态、OAuth/过滤器摘要、命令提示以及一个作用域限定的 mcp 编辑器。 |
| 为 Codex 应用服务器提供作用域限定的原生 MCP 服务器 | mcp.servers.<name>.codex |
codex 块仅影响 Codex 应用服务器线程投影，并且会在原生配置交接之前被剥离。 |
| 运行 ACP 托管的编码工具会话 | openclaw acp 和 ACP Agents |
ACP 桥接模式不接受按会话的 MCP 服务器注入；请改为配置 Gateway/插件桥接。 |
Tip
如果不确定需要哪条路径，请从 openclaw mcp status --verbose 开始。它会在不启动任何 MCP 服务器的情况下显示 OpenClaw 已保存的内容。
MCP 页面¶
本页是一个索引。openclaw mcp 有六个页面，每页对应一个读者任务。请打开与您的任务匹配的页面。
| 页面 | 阅读时机 |
|---|---|
| 将 OpenClaw 作为 MCP 服务器运行 | 当 MCP 客户端需要通过 openclaw mcp serve 读取或发送 OpenClaw 频道对话时。 |
| 管理已保存的 MCP 服务器 | 当您正在保存、检查或批准用于 OpenClaw 管理运行的第三方 MCP 服务器时。 |
| JSON 输出结构 | 当您正在针对 status --json、doctor --json 或 probe --json 编写脚本时。 |
| 传输方式与 OAuth | 当您需要传输配置字段，或正在运行 MCP OAuth 登录流程时。 |
| Control UI 中的 MCP | 当您想从浏览器编辑或检查 MCP 配置时。 |
| MCP Apps | 当您正在启用或保护 MCP Apps 主机桥接时。 |
各章节迁移位置¶
之前单页版本中的每个锚点在此仍然有效，因此诸如 /cli/mcp#bridge-tools 的现有链接可以继续使用。每个条目都指向现在承载相应内容的页面。
- 将 OpenClaw 作为 MCP 服务器
- 何时使用 serve
- 工作原理
- 客户端启动桥接
- 桥接连接到 Gateway
- 会话变为 MCP 对话
- 实时事件队列
- 可选的 Claude 推送
- 重要行为
- 选择客户端模式
- 通用 MCP 客户端
- Claude Code
- serve 暴露的内容
- 用法
- 本地 Gateway
- 远程 Gateway（令牌）
- 远程 Gateway（密码）
- Verbose / Claude off
- 桥接工具
- conversations_list
- conversation_get
- messages_read
- attachments_fetch
- events_poll
- events_wait
- messages_send
- permissions_list_open
- permissions_respond
- 事件模型
- Claude 频道通知
- off
- on
- auto（默认）
- MCP 客户端配置
- 选项
- --url
- --token
- --token-file
- --password
- --password-file
- --claude-channel-mode
- -v, --verbose
- 安全与信任边界
- 测试
- 故障排除
- 未返回任何对话
- events_poll 或 events_wait 遗漏较早的消息
- Claude 通知未显示
- 缺少审批
- 将 OpenClaw 作为 MCP 客户端注册表
- 重要行为
- Codex 工具审批
- 已保存的 MCP 服务器定义
- 常见服务器配置方案
- Filesystem
- Memory
- 本地脚本
- 远程 HTTP
- 桌面/CUA
- JSON 输出结构
- status --json
- doctor --json
- probe --json
- Stdio 传输方式
- SSE / HTTP 传输方式
- SSE / HTTP 传输方式
- OAuth 工作流
- 保存服务器
- 开始登录
- 需要时使用手动回退方案
- 检查授权
- 清除凭据
- Streamable HTTP 传输方式
- Control UI
- MCP Apps
- 当前限制
相关链接¶
- 连接 MCP 服务器
- CLI 参考
- 插件
openclaw attach— 使用临时的会话级 Gateway MCP 授权启动 Claude Code
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw