openclaw

关注公众号 jb51net

关闭
AI > openclaw >

openclaw部署后如何调用mcp和skills

斯班奇的好朋友阿法法

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

一、先明确：Skills 与 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。

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

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

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

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

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

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

2. 查看已安装 Skills

openclaw skills list

3. 调用 Skills（3 种方式）

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

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

方式2：命令行直接调用

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

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

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"
    }
  }'

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

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

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

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

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

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

2. 配置 MCP Server（核心）

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

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

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

编辑 ~/.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。

3. 验证 MCP 连接

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

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

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

  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内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！