openclaw部署后如何调用mcp和skills

作者：CSDN博客
OpenClaw 部署后，Skills 是内置/安装的“技能包”，MCP 是连接外部服务的标准协议；两者配合让 AI 从聊天变成能执行任务、调用工具。下面是完整的配置与调用步骤（含离线内网适配）。

---

一、先明确：Skills 与 MCP 的关系

Skills：OpenClaw 原生“技能”，是可直接安装/调用的功能模块（文件读写、浏览器、PDF、代码等）。MCP（Model Context Protocol）：标准协议，让 OpenClaw 连接外部 MCP Server（如数据库、API、第三方服务）。

• 协作：
  
  用 mcporter 或 mcp-adapter 把 MCP Server 转为 OpenClaw 可调用的 Skill。或直接安装已封装好的 MCP Skill（如 coding-plan-mcp）。
  
  
  

---

二、前置准备（离线环境）

确保 OpenClaw 网关已启动：
1. openclaw gateway start
复制代码
• 生成访问令牌（Web 控制台用）：
  1. openclaw token generate

  复制代码
  令牌保存在 ~/.openclaw/openclaw.json。
  
• 内网离线包准备：
  
  提前在外网下载：clawhub、mcporter、mcp-adapter、目标 Skills 包、MCP Server 离线包。上传到内网服务器 /opt/offline-packages。
  
  
  

---

三、第一部分：Skills 安装与调用（最常用）

1. 安装 Skills（离线/在线）

方式1：在线安装（有外网时）

1. # 搜索技能
2. openclaw skills search "文件"# 安装常用技能
3. openclaw skills install filesystem browser pdf summarize
4. # 安装 MCP 相关技能
5. openclaw skills install clawhub/coding-plan-mcp

复制代码

方式2：离线安装（内网必备）

1. # 解压离线技能包到技能目录unzip /opt/offline-packages/filesystem.zip -d ~/.openclaw/skills/filesystem
2. unzip /opt/offline-packages/browser.zip -d ~/.openclaw/skills/browser
3. # 重启网关生效
4. openclaw gateway restart

复制代码

2. 查看已安装 Skills

1. openclaw skills list

复制代码

3. 调用 Skills（3 种方式）

方式1：Web 控制台（最直观）

访问：http://<服务器IP>:3000/?token=<你的Token>

• 新建对话 → 输入自然语言指令，AI 自动调用对应 Skill：
  
  “读取 /data/report.pdf 并总结”“搜索 2026 年网络安全趋势”“创建文件 test.md，内容：Hello OpenClaw”
  
  
  

方式2：命令行直接调用

1. # 调用 filesystem 技能读文件
2. openclaw skill run filesystem.read path="/data/report.pdf"# 调用 browser 技能抓取网页
3. openclaw skill run browser.fetch url="https://example.com"

复制代码

方式3：API 调用（集成到业务系统）

1. curl-X POST http://<服务器IP>:3000/api/skill/run \-H"Content-Type: application/json"\-H"Authorization: Bearer <你的Token>"\-d'{
2.     "skill": "filesystem",
3.     "action": "read",
4.     "params": {
5.       "path": "/data/report.pdf"
6.     }
7.   }'

复制代码

---

四、第二部分：MCP 配置与调用（连接外部服务）

1. 安装 MCP 适配器（2 种主流方式）

方式A：官方 mcporter（推荐，内置 Skill）

1. # 在线安装
2. clawhub install mcporter
3. # 离线安装（解压到技能目录）unzip /opt/offline-packages/mcporter.zip -d ~/.openclaw/skills/mcporter
4. # 重启网关
5. openclaw gateway restart

复制代码

方式B：mcp-adapter 插件（更灵活）

1. # 在线安装
2. openclaw plugins install mcp-adapter
3. # 离线安装（源码/插件包）
4. openclaw plugins install /opt/offline-packages/openclaw-mcp-adapter

复制代码

2. 配置 MCP Server（核心）

方式A：用 mcporter 配置（简单）

1. # 添加一个 MCP Server（示例：文件系统 MCP）
2. mcporter config add filesystem \--url"http://<MCP服务器IP>:<端口>/mcp"\--auth"Bearer <MCP Token>"# 查看已配置 MCP 服务
3. mcporter config list

复制代码

方式B：在 openclaw.json 配置（推荐，持久化）

编辑 ~/.openclaw/openclaw.json，添加 mcp 或 plugins 配置：

1. {"mcp":{"servers":[{"name":"filesystem","transport":"http","url":"http://192.168.1.200:8080/mcp","headers":{"Authorization":"Bearer your-mcp-token"}},{"name":"postgres","transport":"stdio","command":"mcp-server-postgres","args":["postgresql://user:pass@db:5432/mydb"]}]},"plugins":{"entries":{"mcp-adapter":{"enabled":true,"config":{"toolPrefix":true}}}}}

复制代码

重启网关：openclaw gateway restart。
3. 验证 MCP 连接

1. # 列出 MCP 提供的工具
2. mcporter list
3. # 测试调用 MCP 工具
4. mcporter call filesystem.read path="/data/test.txt"

复制代码

4. 调用 MCP（同 Skills 3 种方式）

Web 控制台：自然语言指令，AI 自动路由到 MCP 工具。命令行：openclaw skill run mcp.filesystem.read path="/data/test.txt"API：同 Skills API，skill 字段填 mcp.服务名。

---

五、企业内网最佳实践（离线/安全）

离线包管理

建立内网 clawhub 私服，统一托管 Skills/MCP 包。所有安装均走离线包，禁止外网访问。

权限控制

给 OpenClaw 配置 RBAC，限制不同用户可调用的 Skills/MCP。MCP Server 做 IP 白名单，仅允许 OpenClaw 服务器访问。

日志与审计

开启 Skills/MCP 调用日志：openclaw gateway logs对接企业日志平台（ELK/ Splunk），审计所有工具调用。

高可用

Skills/MCP 配置多副本，网关做负载均衡。关键 MCP 服务（如数据库）做主备切换。

---

六、常见问题排查

Skill 安装后不显示

检查路径：~/.openclaw/skills/<skill-name>重启网关：openclaw gateway restart

MCP 连接失败

验证 MCP Server 地址、端口、Token 是否正确。检查防火墙：开放 OpenClaw → MCP Server 端口。

AI 不自动调用 Skill/MCP

确保提示词清晰：“用 filesystem 技能读取 /data/report.pdf”检查 Agent 配置：开启工具调用能力。

---

七、下一步

需要我给你生成一份可直接复制的内网离线部署脚本，包含 Skills 批量安装、MCP 配置模板和权限加固规则吗？

原文地址：https://blog.csdn.net/weixin_45459322/article/details/159319655