跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

OpenClaw 集成 MCP 协议:构建自托管 AI 助手工具链

MCP 协议作为连接 AI 应用与外部系统的标准接口,正逐步成为主流。OpenClaw 通过支持 MCP 集成,实现了在飞书、Telegram 等多渠道接入的同时,保持数据自托管的安全性。本文探讨了 MCP 的核心架构,演示了如何在 OpenClaw 中配置文件系统、GitHub 等服务器,并提供了自动化工作流的实战案例。重点分析了安全配置与权限控制的最佳实践,帮助开发者利用标准化协议扩展 AI 助手的能力边界,实现跨平台的工具调用与任务自动化。

乱七八糟发布于 2026/3/24更新于 2026/6/2121 浏览

OpenClaw 集成 MCP 协议:构建自托管 AI 助手工具链

MCP(Model Context Protocol)正逐渐成为连接 AI 应用与外部系统的标准接口。作为开源 AI 助手框架,OpenClaw 率先支持了 MCP 集成,这为开发者打造能连接任意工具的超级 AI 助手提供了便利。

什么是 MCP?

简单来说,MCP 就像是 AI 的 USB-C 接口。就像 USB-C 让电脑能连接显示器、硬盘一样,MCP 让 AI 助手能连接数据库、文件系统、API 等各种工具。

核心架构

MCP 采用客户端 - 服务器模式,主要包含三个角色:

角色说明示例
MCP HostAI 应用,管理多个 MCP 客户端Claude Desktop、VS Code、OpenClaw
MCP Client维护与服务器的连接由 Host 创建
MCP Server提供上下文数据的程序文件系统服务器、数据库服务器

三大能力

MCP Server 主要暴露三种核心能力:

  1. Tools(工具):可执行的函数,AI 调用后执行操作,如文件读写、API 请求。
  2. Resources(资源):提供上下文信息的数据源,如文件内容、数据库记录。
  3. Prompts(提示词):可复用的交互模板,用于标准化系统提示或 Few-shot 示例。

为什么选择 OpenClaw + MCP?

OpenClaw 的优势

OpenClaw 是一个自托管的 AI 助手网关,核心价值在于:

  • 多渠道接入:支持飞书、Telegram、Discord、微信等。
  • 数据主权:完全自托管,数据掌握在自己手中。
  • 技能扩展:通过插件机制实现功能扩展。
  • 多代理路由:支持多工作空间隔离。

结合后的价值

两者结合实现了'一个入口,无限可能'。你在飞书发送一条消息,AI 助手就能通过 MCP 协议查询数据库、操作 GitHub 或读写文件。这种标准化连接方式避免了重复开发,复用性强。

实战配置指南

1. 安装环境

首先确保 Node.js 环境正常,然后全局安装 OpenClaw:

npm install -g openclaw@latest

2. 配置 MCP Server

OpenClaw 通过 ACP(Agent Communication Protocol)模式支持 MCP 服务器集成。你需要编辑配置文件 ~/.openclaw/openclaw.json。

这里以配置文件系统服务器和 GitHub 服务器为例。注意权限控制,建议限制访问目录:

{
  "acp": {
    "mcpServers": 
       
         
           
      
       
         
          
         
           
        
      
    
  

{
"filesystem"
:
{
"command"
:
"npx"
,
"args"
:
[
"-y"
,
"@modelcontextprotocol/server-filesystem"
,
"/path/to/allowed/dir"
]
}
,
"github"
:
{
"command"
:
"npx"
,
"args"
:
[
"-y"
,
"@modelcontextprotocol/server-github"
]
,
"env"
:
{
"GITHUB_TOKEN"
:
"your-github-token"
}
}
}
}
}

3. 启动网关

配置完成后,启动 Gateway 服务:

openclaw gateway --port 18789

4. 连接渠道

最后连接你的即时通讯工具,例如:

# 飞书
openclaw channels login feishu
# Telegram
openclaw channels login telegram

现在,你在飞书或 Telegram 发送消息,AI 助手就能通过 MCP 访问配置的工具了。

常用 MCP Server 推荐

官方服务器

服务器功能安装命令
filesystem文件系统读写npx @modelcontextprotocol/server-filesystem
githubGitHub API 操作npx @modelcontextprotocol/server-github
postgresPostgreSQL 数据库npx @modelcontextprotocol/server-postgres
slackSlack 消息操作npx @modelcontextprotocol/server-slack

社区服务器

  • mcp-server-brave-search:Brave 搜索
  • mcp-server-puppeteer:浏览器自动化
  • mcp-server-sentry:Sentry 错误监控
  • mcp-server-google-calendar:Google 日历

实战案例:日报自动生成

场景需求

每天自动从 GitHub 获取提交记录,从 Sentry 获取错误报告,生成日报发送到飞书。

配置要点

在配置文件中添加定时任务(cron)和对应的 MCP 服务器:

{
  "acp": {
    "mcpServers": {
      "github": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-github"],
        "env": { "GITHUB_TOKEN": "xxx" }
      },
      "sentry": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-sentry"],
        "env": { "SENTRY_TOKEN": "xxx" }
      }
    }
  },
  "cron": {
    "dailyReport": {
      "cron": "0 9 * * *",
      "task": "生成昨日工作报告"
    }
  }
}

运行效果

每天早上 9 点,AI 助手会自动执行以下流程:

  1. 从 GitHub 拉取昨天的 commits。
  2. 从 Sentry 抓取昨天的错误报告。
  3. 汇总信息并生成日报文本。
  4. 将结果推送到飞书群。

MCP vs 传统插件方案

对比项MCP传统插件
标准化✅ 统一协议❌ 各自实现
生态✅ 跨平台复用❌ 平台绑定
开发成本✅ 一次开发❌ 每个平台单独开发
维护✅ 社区维护❌ 自己维护
安全✅ 权限可控⚠️ 依赖实现

最佳实践建议

1. 安全配置

默认情况下不要开放所有权限。对于文件系统服务器,建议设置为只读模式,并限制特定目录:

{
  "filesystem": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/safe-dir"],
    "readOnly": true
  }
}

2. 按需加载

只配置实际需要的 MCP Server,避免过度授权带来的风险。

3. 日志监控

定期检查 MCP 调用日志,排查异常行为:

openclaw logs --filter mcp

总结

OpenClaw 配合 MCP 协议,为 AI 助手提供了标准化的工具接口能力:

  1. 一次配置,多渠道使用:飞书、Telegram、Discord 通用。
  2. 标准化工具生态:复用 Claude、VS Code 等平台的 MCP 服务器。
  3. 自托管,数据安全:所有数据都在自己的服务器上。
  4. 可扩展:随时添加新的 MCP Server。

通过这种方式,你可以逐步构建起属于自己的自动化工作流,让 AI 真正融入日常开发与管理中。

参考资料

  • MCP 官方文档
  • OpenClaw 官方文档
  • MCP Server 仓库

目录

  1. OpenClaw 集成 MCP 协议:构建自托管 AI 助手工具链
  2. 什么是 MCP?
  3. 核心架构
  4. 三大能力
  5. 为什么选择 OpenClaw + MCP?
  6. OpenClaw 的优势
  7. 结合后的价值
  8. 实战配置指南
  9. 1. 安装环境
  10. 2. 配置 MCP Server
  11. 3. 启动网关
  12. 4. 连接渠道
  13. 飞书
  14. Telegram
  15. 常用 MCP Server 推荐
  16. 官方服务器
  17. 社区服务器
  18. 实战案例:日报自动生成
  19. 场景需求
  20. 配置要点
  21. 运行效果
  22. MCP vs 传统插件方案
  23. 最佳实践建议
  24. 1. 安全配置
  25. 2. 按需加载
  26. 3. 日志监控
  27. 总结
  28. 参考资料
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 大模型入门教程:基础原理、微调技术与实战指南
  • 基于 LLaMA-Factory 微调 Qwen3.5-4B 构建医疗 AI 助手
  • WebArena:真实网页环境下的自主智能体构建与评估
  • CentOS 7 环境下安装 JDK 1.8 及解决 wget 命令缺失问题
  • ToDesk、顺网云、青椒云云电脑 AIGC 性能实测与对比
  • FLUX.1-dev与Stable Diffusion对比评测:图像质量与生成速度
  • LLM 与 LoRA:高效优化大型语言模型的微调方法
  • AIGC 在游戏与影视行业的落地案例
  • AI 产品经理:从需求挖掘到智能化产品落地全流程解析
  • 前端独立产品设计全流程:掌握三大 AI 设计 Skill
  • Llama 3-8B-Instruct 在昇腾 NPU 上基于 SGLang 的性能实测
  • FPGA 验证环境构建:Testbench 编写与 Quartus II+ModelSim 联合仿真
  • Kafka vs RabbitMQ:消息中间件选型指南与 Java 代码实战
  • Dify 1.13.0 更新:引入 HITL 人工审批节点与工作流引擎重构
  • Roo Code 深度上手指南:从 API 配置到实战,打造 AI 编程私有云
  • VS Code 远程连接服务器后 GitHub Copilot 无法使用解决方案
  • 数据结构:二叉树基础与 C 语言实现
  • AI 大模型开发指南:核心技术与实践路径
  • Llama-3.2-3B 部署优化:Ollama 配置上下文窗口与 Token 限制
  • Java 自动装箱与拆箱详解

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online