要在 OpenClaw 中通过 ACP（Agent Client Protocol）协议配置 MCP Server 以实现文件系统和 GitHub 工具的连接，核心在于编辑 OpenClaw 的配置文件，并在其中正确声明 MCP 服务器。以下是详细的步骤和配置说明。

核心配置步骤

整个配置过程围绕修改 OpenClaw 的配置文件 ~/.openclaw/openclaw.json（或项目根目录下的 openclaw.json）展开，主要分为安装、配置和启动三个主要环节。

1. 安装 OpenClaw 与 MCP 服务器

首先，确保已全局安装 OpenClaw 框架，并准备好所需的 MCP 服务器。

# 安装 OpenClaw 命令行工具 npm install -g openclaw@latest 

对于文件系统和 GitHub 工具，我们需要安装对应的 MCP 服务器包。这些服务器通常是独立的 npm 包。

# 安装文件系统 MCP 服务器（官方提供） npm install -g @modelcontextprotocol/server-filesystem # 安装 GitHub MCP 服务器（官方提供） npm install -g @modelcontextprotocol/server-github 

2. 配置 ACP 协议下的 MCP Servers

这是最关键的一步。ACP 是 OpenClaw 用于与 IDE 或其他客户端通信的协议，它同样支持集成 MCP Server。你需要在 openclaw.json 配置文件的 acp 部分下，定义 mcpServers 对象 [ref_1]。

下表对比了两个需要配置的 MCP Server 的关键信息：

以下是具体的配置示例，将其添加到你的 openclaw.json 文件中：

{ "acp": { "mcpServers": { "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "/path/to/your/safe/directory" // 替换为你想开放给 AI 访问的实际目录路径 [ref_1] ], "env": {}, "readOnly": true // 可选，设置为只读模式以提高安全性 [ref_1] }, "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { "GITHUB_TOKEN": "ghp_your_actual_github_token_here" // 替换为你的真实 GitHub Personal Access Token [ref_1] } } // 可以继续在此添加其他 MCP Server，如 PostgreSQL、Slack 等 [ref_1] } } // ... 配置文件的其他部分（如渠道配置、技能配置等） } 

配置详解：

• command: "npx"：指示 OpenClaw 使用 npx 命令来运行后续指定的包。这允许你无需全局安装服务器包，npx 会自动下载并运行。
• args：传递给 npx 命令的参数列表。
  • 对于 filesystem：-y 参数表示自动确认安装提示；@modelcontextprotocol/server-filesystem 是要运行的包名；最后一个参数是服务器可以访问的根目录。
  • 对于 github：同理，指定运行 @modelcontextprotocol/server-github 包。
• env：设置服务器进程的环境变量。对于 github 服务器，GITHUB_TOKEN 是必填项，用于授权 API 调用。
• readOnly (可选)：仅适用于 filesystem 服务器。当设置为 true 时，AI 助手只能读取文件，无法写入或删除，这是一个重要的安全**实践 [ref_1]。

3. 启动 OpenClaw Gateway 并连接客户端

配置完成后，需要启动 OpenClaw 的核心服务 Gateway。

# 启动 Gateway 服务，指定端口（默认或自定义） openclaw gateway --port 18789 

Gateway 启动后，它会加载上述配置文件，并按照 ACP 协议的规定，初始化并连接到配置的 MCP 服务器 [ref_2]。此时，你的 AI 助手已经具备了通过 MCP 调用文件系统和 GitHub 工具的能力。

接下来，你需要将客户端（如 VS Code 插件、飞书机器人等）连接到这个 Gateway。以 ACP 模式为例，在支持 ACP 的 IDE 客户端中，你需要配置其连接到 ws://localhost:18789（或你指定的 Gateway 地址和端口）。连接成功后，IDE 内的 AI 助手（如 Cody、Tabby 等）就能通过 OpenClaw Gateway 间接调用已配置的 MCP 工具 [ref_2]。

验证与使用

配置并启动后，你可以通过以下方式验证：

1. 查看日志：在运行 openclaw gateway 的终端，观察启动日志，确认 filesystem 和 github 服务器是否被成功加载，没有报错。

    openclaw logs --filter mcp # 可以专门过滤查看 MCP 相关的调用日志 [ref_1] 

2. 在客户端测试：在已连接的 IDE 或聊天客户端中，向 AI 助手发出涉及文件操作或 GitHub 查询的指令。例如：
   • “请列出 /path/to/your/safe/directory 目录下的所有 Markdown 文件。”
   • “查看我的 GitHub 仓库 username/repo 最近的三条提交记录。”

如果配置正确，AI 助手应该能够调用相应的 MCP 工具并返回结果。

高级配置与**实践

• 安全隔离：为 filesystem 服务器配置的目录应尽可能狭窄，仅包含 AI 助手需要访问的文件，避免暴露敏感系统文件。
• 按需加载：只启用业务真正需要的 MCP 服务器，减少潜在的攻击面和资源占用 [ref_1]。
• 动态配置：OpenClaw 支持热重载配置。修改 openclaw.json 后，通常重启 Gateway 服务即可生效。
• 结合其他协议：除了 ACP，OpenClaw 的 Gateway 也同时支持标准的 MCP over STDIO 等连接方式，这意味着配置好的 MCP 服务器也能被其他兼容 MCP 的 Host（如 Claude Desktop）使用，实现“一次配置，多处使用” [ref_1][ref_5]。

通过以上步骤，你就成功在 OpenClaw 中通过 ACP 协议桥接，集成了文件系统和 GitHub 的 MCP 工具，极大地扩展了 AI 助手的能力边界，使其能够直接与你的本地文件和代码仓库进行交互。这种基于标准化协议（MCP）和桥接协议（ACP）的架构，是 OpenClaw 实现“一个入口，无限可能”愿景的关键技术路径 [ref_6]。