AI创想
标题:
openclaw部署后如何调用mcp和skills
[打印本页]
作者:
米落枫
时间:
11 小时前
标题:
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 网关已启动：
openclaw gateway start
复制代码
生成访问令牌（Web 控制台用）：
openclaw token generate
复制代码
令牌保存在 ~/.openclaw/openclaw.json。
内网离线包准备：
提前在外网下载：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 控制台（最直观）
访问：http://<服务器IP>:3000/?token=<你的Token>
新建对话 → 输入自然语言指令，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 种方式）
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
欢迎光临 AI创想 (https://llms-ai.com/)
Powered by Discuz! X3.4