yjzf-openclaw-plugin

优居找房 U+ MCP 工具插件 for OpenClaw

通过 stdio 连接 @yjzf/mcp-server-yjzf，以单工具代理模式将优居找房 U+能力接入 OpenClaw Agent。

✨ 功能特性

• 🔗 单工具代理模式：注册 yjzf_mcp 工具，通过 list / call 两个操作代理所有 MCP 子工具
• 📋 动态工具发现：运行时通过 yjzf_mcp list 列出所有可用子工具及参数说明
• ⏱️ 超时控制：可配置单次 MCP 调用超时时间，防止 MCP server 挂起导致 Agent 卡死
• 🔄 连接自动重建：MCP client 单例管理，断连后下次调用自动重建
• 📊 OTEL 追踪：工具调用完整记录在 OpenTelemetry trace 中（openclaw.tool.execution span）

🚀 快速开始

安装

openclaw plugins install yjzf-openclaw-plugin

或本地路径安装：

在 openclaw.json 中配置：

{
  "plugins": {
    "load": {
      "paths": ["/path/to/yjzf-openclaw-plugin"]
    },
    "allow": ["yjzf-openclaw-plugin"]
  }
}

配置

在 openclaw.json 中添加插件配置：

{
  "plugins": {
    "yjzf-openclaw-plugin": {
      "apiKey": "your-api-key-here"
    }
  }
}

配置完成后重启网关：

openclaw gateway restart

⚙️ 配置项

| 配置项 | 类型 | 必填 | 默认值 | 说明 | |---|---|---|---|---| | apiKey | string | ✅ | — | 优居找房 U+ API Key，对应 MCP server 的 MCP_YJZF_API_KEY 环境变量 | | timeoutMs | number | ❌ | 300000 | 单次 MCP 调用超时时间（毫秒），默认 5 分钟 |

示例（自定义超时）：

{
  "plugins": {
    "yjzf-openclaw-plugin": {
      "apiKey": "your-api-key-here",
      "timeoutMs": 60000
    }
  }
}

🛠️ 工具使用

插件注册 yjzf_mcp 工具，支持两种操作：

列出所有可用工具

yjzf_mcp list

返回所有子工具的名称、描述和参数说明。

调用工具

yjzf_mcp call <toolName> '<jsonArgs>'

示例：

yjzf_mcp call query_order '{"orderId": "2024010100001"}'
yjzf_mcp call apply_refund '{"orderId": "2024010100001", "amount": 100}'

在 Skill 中使用

在 skill 文件中直接说明使用方式，模型即可按需调用：

处理支付相关请求时，使用 yjzf_mcp 工具。

常用操作：
- 查询订单：yjzf_mcp call query_order '{"orderId": "..."}'
- 申请退款：yjzf_mcp call apply_refund '{"orderId": "...", "amount": ...}'

如需查看完整工具列表：yjzf_mcp list

📦 更新

openclaw plugins update yjzf-openclaw-plugin

📄 License

MIT