openclaw部署后如何调用mcp和skills

目录

• 一、先明确：Skills 与 MCP 的关系
• 二、前置准备（离线环境）
• 三、第一部分：Skills 安装与调用（最常用）
• 1. 安装 Skills（离线/在线）
• 方式1：在线安装（有外网时）
• 方式2：离线安装（内网必备）
• 2. 查看已安装 Skills
• 3. 调用 Skills（3 种方式）
• 方式1：Web 控制台（最直观）
• 方式2：命令行直接调用
• 方式3：API 调用（集成到业务系统）
• 四、第二部分：MCP 配置与调用（连接外部服务）
• 1. 安装 MCP 适配器（2 种主流方式）
• 方式A：官方 mcporter（推荐，内置 Skill）
• 方式B：mcp-adapter 插件（更灵活）
• 2. 配置 MCP Server（核心）
• 方式A：用 mcporter 配置（简单）
• 方式B：在 openclaw.json 配置（推荐，持久化）
• 3. 验证 MCP 连接
• 4. 调用 MCP（同 Skills 3 种方式）
• 五、企业内网最佳实践（离线/安全）
• 六、常见问题排查
• 七、下一步

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

• Skills：OpenClaw 原生“技能”，是可直接安装/调用的功能模块（文件读写、浏览器、PDF、代码等）。
• MCP（Model Context Protocol）：标准协议，让 OpenClaw 连接外部 MCP Server（如数据库、API、第三方服务）。
• 协作：
  • 用 mcporter 或 mcp-adapter 把 MCP Server 转为 OpenClaw 可调用的 Skill。
  • 或直接安装已封装好的 MCP Skill（如 coding-plan-mcp）。

1. 确保 OpenClaw 网关已启动：

   openclaw gateway start

2. 生成访问令牌（Web 控制台用）：

   openclaw token generate

   令牌保存在 ~/.openclaw/openclaw.json。

3. 内网离线包准备：
   • 提前在外网下载：clawhub、mcporter、mcp-adapter、目标 Skills 包、MCP Server 离线包。
   • 上传到内网服务器 /opt/offline-packages。

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

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

openclaw skills list

1. 访问：http://<服务器IP>:3000/?token=<你的Token>
2. 新建对话 → 输入自然语言指令，AI 自动调用对应 Skill：
   • “读取 /data/report.pdf 并总结”
   • “搜索 2026 年网络安全趋势”
   • “创建文件 test.md，内容：Hello OpenClaw”

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

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

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

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

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

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

{
  "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。

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

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

1. 离线包管理

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

2. 权限控制

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

3. 日志与审计

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

4. 高可用

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

1. Skill 安装后不显示

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

2. MCP 连接失败

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

3. AI 不自动调用 Skill/MCP

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

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

到此这篇关于openclaw部署后如何调用mcp和skills的文章就介绍到这了,更多相关openclaw 调用mcp和skills内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！