QwenPaw MCP Helper

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install qwenpaw-mcp-helper
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 qwenpaw-mcp-helper。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

QwenPaw MCP Helper 是一款 Openclaw Skills 工具，用于检查、诊断和改进 QwenPaw 中的 Model Context Protocol (MCP) 设置。它会验证本地配置中的 MCP 部分、探测已配置的服务器、检查 QwenPaw 的 MCP 客户端状态，并将检查结果整理成清晰的报告。
可使用它快速排查配置语法错误、连接失败、身份验证问题、超时或重复的工具名称。该技能提供诊断指南，而不会安装 MCP 服务器或更改凭据，因此是 Openclaw Skills 工作流的专用补充。

应用场景

添加 MCP 服务器之前或之后，验证 QwenPaw 配置是否可读取，以及服务器是否可访问。
MCP 工具无法运行时，检查客户端状态并找出可能的配置或连接问题。
服务器连接超时时，检查网络延迟、服务器负载、DNS、端口或防火墙问题。
身份验证失败时，检查相关环境变量或配置值，但不会泄露或修改凭据。
多个 MCP 服务器提供相互冲突或重复的工具名称时，调查可能的命名冲突。

工作原理

从 ~/.qwenpaw/config.json 读取 MCP 部分，并检查配置能否解析为 JSON。
对每个已配置的服务器，使用 curl 探测其 URL 并记录 HTTP 响应代码。可访问的端点预期会返回 200；401 可能表示需要身份验证。
运行 qwenpaw mcp list 检查已向 QwenPaw 注册的 MCP 客户端，并捕获报告的任何错误。
根据常见故障排查路径分析失败原因，例如检查 DNS、端口、防火墙规则、网络延迟、服务器负载、身份验证设置或重复的工具名称。
生成结构化报告，包含配置状态、服务器和连接数量、问题以及具体建议。

配置指南

该技能要求系统中可使用 qwenpaw、python3 和 curl。未声明必须设置任何环境变量。技能文档未指定单独的安装命令；请确保该技能可供你的 Openclaw Skills 环境使用，并且已安装其命令行依赖项。
运行助手：
qwenpaw mcp-check
手动检查 MCP 配置：
cat ~/.qwenpaw/config.json | python3 -c "import sys, json; cfg=json.load(sys.stdin); print(json.dumps(cfg.get('mcp', {}), indent=2))"
检查 QwenPaw 的 MCP 客户端列表：
qwenpaw mcp list 2>&1
可使用 curl 和每个已配置的服务器 URL 探测服务器连接：
curl -s -o /dev/null -w "%{http_code}"
该助手不会自动安装 MCP 服务器、处理需要额外 API 密钥的 MCP 服务，也不会修改用户密码或密钥。

数据架构

该助手从 ~/.qwenpaw/config.json 读取 MCP 配置；文档没有说明单独的持久化数据存储或生成的配置文件。其输出为 Markdown 诊断报告，结构如下：
报告字段 含义
MCP Config MCP 配置有效还是无效
Servers 已配置的 MCP 服务器数量
Connected 被视为已连接的服务器数量
Failed 发生故障的服务器数量
Issues 检测到的问题的编号说明
Suggestions 编号列出的可执行修复步骤
故障排除分类涵盖配置解析、服务器可访问性、客户端状态、身份验证、超时和重复的工具名称。报告会整理检查结果和建议；它不会更改凭据或自动修复配置。

高级特性

在一个诊断工作流中结合配置解析、逐服务器 HTTP 探测和 QwenPaw MCP 客户端检查。
区分预期的 HTTP 响应（如
和与身份验证相关的
）与连接失败。
将常见症状对应到有针对性的检查：身份验证问题检查环境变量或配置值，超时问题检查服务器负载和网络延迟，连接失败则检查 DNS、端口或防火墙规则。
生成结构化且可重复使用的报告，其中包含服务器数量、问题说明和具体建议。
明确安全边界：不会安装服务器、管理额外的 API 密钥，也不会修改密码和凭据。

name: qwenpaw-mcp-helper description: QwenPaw MCP 設定與診斷。用於檢查 MCP 配置、驗證伺服器連線、提供設定範例，並診斷 MCP 連接問題。