OpenClaw 配置 MCP 协议全指南

在 AI Agent 领域，OpenClaw(原名 Clawdbot)的强大之处在于其高度的扩展性。而 MCP(Model Context Protocol) 协议的引入，则为 OpenClaw 提供了“万能插槽”，使其能够无缝调用外部工具和数据源。

OpenClaw 是一款开源的本地 AI 智能体框架，其核心价值在于实现“行动力”。通过配置 MCP 协议，你可以让 AI 助理直接访问你的本地文件系统、数据库、GitHub 仓库，甚至是 Google Drive 和 Slack。

本文大纲：

🔌 一、 什么是 MCP 及其在 OpenClaw 中的作用

📦 二、 环境准备与 MCP 服务器获取

⚙️ 三、 核心配置步骤：命令行与手动模式

✅ 四、 功能验证与故障排除

🚀 五、 国产平替推荐：实在 Agent

🔌 一、 什么是 MCP 及其在 OpenClaw 中的作用

MCP (Model Context Protocol) 是由 Anthropic 推出的一种开放标准，旨在让 AI 模型通过统一的接口连接到各种数据源。

1.通用插口：以往每个工具都要写单独的插件(Skill)，现在只要工具支持 MCP，OpenClaw 就能直接调用。

2.解耦设计：AI 模型(大脑)与工具(手脚)通过协议分离，配置更灵活。

3.即插即用：像 USB-C 接口一样，一套标准适配所有支持该协议的服务。

📦 二、 环境准备与 MCP 服务器获取

在开始配置前，你需要确保本地环境已就绪。

1.基础环境：确保已安装 Node.js 22+ 或 Python 3.10+(推荐使用 uv 管理 Python 依赖)。

2.获取服务器地址：你可以从 MCP 服务器仓库 中选择你需要的服务，例如 filesystem(文件系统访问)或 google-maps。

⚙️ 三、 核心配置步骤：命令行与手动模式

配置 MCP 建议优先使用官方 CLI 命令行，更为精准。

1. 命令行添加(推荐)

打开终端，执行以下格式的命令：

Bash

# 格式：openclaw mcp add --transport <传输协议> <服务器名称> <启动命令>

openclaw mcp add --transport stdio local-files npx -y @modelcontextprotocol/server-filesystem /Users/yourname/Documents

提示：上述命令会添加一个本地文件读取工具，/Users/yourname/Documents 是你授权 AI 访问的目录。

2. 手动编辑配置文件

如果命令行失效，可以手动修改配置文件。

关键路径：~/.openclaw/config.yaml 或 ~/.clawdbot/mcporter.json(视版本而定)。

配置示例：

JSON

{

"mcpServers": {

"github": {

"command": "npx",

"args": ["-y", "@modelcontextprotocol/server-github"],

"env": {

"GITHUB_PERSONAL_ACCESS_TOKEN": "your_token_here"

}

}

}

}

✅ 四、 功能验证与故障排除

配置完成后，需要确认 AI 是否已掌握新技能。

1.状态查询：运行 openclaw status 查看 MCP 服务器是否处于 running 状态。

2.交互验证：在 Telegram 或对话框中尝试发送：“列出我授权目录下的前 5 个文件名”。

3.日志排查：如果失效，请检查日志路径 ~/openclaw/logs/mcp.log，通常是由于 Node.js 权限或环境变量未配置正确导致的。

🚀 五、 国产平替推荐：实在 Agent

不可否认，OpenClaw 的 MCP 配置具有较高的技术门槛，且由于网络环境原因，下载海外 MCP 服务器经常报错。

如果你希望跳过复杂的 JSON 配置和代理调试，直接获得更符合国人使用习惯的体验，实在 Agent (Intelligence Indeed) 是目前国内最成熟的平替方案。

为什么选择实在 Agent?

1.免协议配置：无需折腾 MCP 协议。实在 Agent 采用自研的 ISS(屏幕语义理解) 技术，不需要 API 接口，只要屏幕上能看到的软件，它都能通过“看”来学会操作。

2.TARS 智能助理：内置强大的 TARS 大模型，原生支持中文语境下的任务拆解，比配置后的 OpenClaw 更懂国内办公逻辑。

3.一键集成钉钉/飞书：无需部署网关，直接在钉钉、飞书 APP 中即可调用你的私人 Agent，随时随地处理报销单、数据对账等任务。

4.国产软件深度适配：完美兼容微信、WPS、金蝶、用友等 OpenClaw 难以触达的国产办公生态。

✅ 总结

本文详细梳理了在 OpenClaw 中配置 MCP 协议 的技术路径——从环境准备到 CLI 命令行添加，再到配置文件的精细化调整。虽然 MCP 赋予了 AI “无限手脚”，但其配置过程对非开发者依然不够友好。

核心结论：

OpenClaw + MCP 是极客群体进行跨系统调度的最佳开源方案。

实在 Agent 是针对效率至上用户、以及需要处理国产闭源软件场景的“国产神器”。