English | 中文
【滴滴出行统一入口】处理用户所有出行相关需求，提供完整的打车服务和路线规划功能。
ClawHub: didi-ride-skill-official
服务范围：支持滴滴出行服务覆盖的中国大陆城市。
3 步开始使用：
Step 1 — 安装 mcporter
npm install -g mcporterStep 2 — 获取并配置 MCP KEY
扫描 滴滴 MCP 平台 二维码获取 KEY，然后直接告诉 AI：
你: 我的 MCP Key 是 xxxxxx
Step 3 — 开始出行
你: 帮我打车去北京西站
你: 从国贸到三里屯怎么走
| 功能 | 说明 |
|---|---|
| 实时叫车 | 地址解析 → 价格预估 → 车型决策（用户或偏好）→ 创建订单 |
| 预约出行 | 创建定时任务，到点后自动发起打车请求 |
| 查询订单 | 用户主动发送「查询订单」，单次查询当前状态 |
| 查询司机位置 | 逆地址编码，美化输出司机位置信息 |
| 取消订单 | 展示订单信息 → 用户确认 → 取消 |
| 价格预估 | 获取各车型价格对比 |
| 偏好设置 | 记住常用地址（家/公司）、车型偏好、叫车手机号 |
| 功能 | 说明 |
|---|---|
| 驾车路线 | 规划小客车/轿车出行方案 |
| 公交地铁 | 综合公交、地铁通勤方案 |
| 步行路线 | 规划步行出行方案 |
| 骑行路线 | 规划骑行出行方案 |
| 周边搜索 | 搜索附近的地点、设施 |
方式 A：扫码获取（推荐，最快）
打开滴滴出行 App，扫描下方二维码，即可快速获取 MCP KEY：
方式 B：访问官网
访问 滴滴 MCP 平台 获取 MCP KEY。
npm install -g mcporter方式 A：对话中输入（推荐）
直接在对话中告诉 AI 您的 MCP KEY，AI 会自动持久化配置：
你: 我的 MCP Key 是 xxxxxx
方式 B：环境变量
export DIDI_MCP_KEY="YOUR_MCP_KEY_HERE"方式 C：配置文件
编辑 ~/.openclaw/openclaw.json：
{
"skills": {
"entries": {
"didi-ride-skill": {
"apiKey": "YOUR_MCP_KEY_HERE"
}
}
}
}# 检查 Key 是否已配置
echo $DIDI_MCP_KEY
# 测试 API 连通性
export MCP_URL="https://mcp.didichuxing.com/mcp-servers?key=$DIDI_MCP_KEY"
mcporter call "$MCP_URL" maps_textsearch --args '{"keywords":"西二旗地铁站","city":"北京市"}'| 工具 | 用途 |
|---|---|
maps_textsearch |
文本地址解析，获取经纬度坐标 |
taxi_estimate |
价格预估，查询可用车型及价格 |
taxi_create_order |
创建打车订单 |
taxi_query_order |
查询订单状态和司机信息 |
taxi_get_driver_location |
获取司机实时位置 |
maps_regeocode |
逆地址编码（坐标转地址） |
taxi_cancel_order |
取消订单 |
taxi_generate_ride_app_link |
生成 App 深度链接（无 API 直发权限时的备选方案） |
| 工具 | 用途 |
|---|---|
maps_direction_driving |
驾车路线规划 |
maps_direction_transit |
公交地铁路线规划 |
maps_direction_walking |
步行路线规划 |
maps_direction_bicycling |
骑行路线规划 |
maps_place_around |
周边搜索 |
┌─────────────────────────────────────────────────────────────────┐
│ 用户发起打车请求 │
│ "我要从国贸去三里屯" │
└──────────────────────────┬──────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Step 1: 地址解析 (maps_textsearch) │
│ - 解析起点：国贸 → (116.458, 39.908) │
│ - 解析终点：三里屯 → (116.455, 39.937) │
└──────────────────────────┬──────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Step 2: 确认起终点 │
│ - 推断地址或多候选结果时，向用户确认起终点 │
│ - 用户明确指定且精确匹配的地点无需确认 │
└──────────────────────────┬──────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Step 3: 价格预估 (taxi_estimate) │
│ - 获取可用车型列表和价格 │
│ - 展示给用户选择（如用户未明确车型） │
└──────────────────────────┬──────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Step 4: 车型决策 │
│ - 用户指定车型或按偏好直发 │
└──────────────────────────┬──────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Step 5: 创建订单 (taxi_create_order) │
│ - 使用用户选择的车型创建订单 │
└──────────────────────────┬──────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Step 6: 输出订单信息 + 提示跟踪 │
│ - 输出订单号、起终点、车型、预估价 │
│ - 提示用户：发送「查询订单」可了解订单状态 │
└──────────────────────────┬──────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Step 7: 发单后自动回查（自动创建 cron） │
│ - 创建 5 分钟后的定时回查任务 │
│ - 到点自动查询订单状态并推送通知 │
└─────────────────────────────────────────────────────────────────┘
| 状态代码 | 状态文本 | 说明 |
|---|---|---|
| 0 | 匹配中 | 正在为您匹配司机 |
| 1 | 司机已接单 | 展示司机信息及距上车点距离/ETA |
| 2 | 司机已到达 | 提示前往上车 |
| 4 | 行程进行中 | 行程已开始 |
| 5 | 订单完成 | 展示费用信息 |
| 6 | 订单已被系统取消 | 系统自动取消 |
| 7 | 订单已被取消 | 用户取消 |
| 3/8-12 | 其他终态 | 显示对应状态描述 |
| 操作 | 确认方式 |
|---|---|
| 实时单下单 | 允许用户指定车型或按偏好直发，不必确认 |
| 预约出行 | 直接创建 cron（托管叫车需求，到点后发起打车） |
| 取消订单 | 展示订单信息 → 等待用户确认 |
基础叫车
你: 帮我叫个车从北京西站到西二旗地铁站
AI: 正在解析地址...
已找到起点：北京西站 (116.321, 39.894)
已找到终点：西二旗地铁站 (116.297, 40.053)
正在查询价格...
1. 特惠快车: 约 32 元
2. 快车: 约 34 元
3. 专车: 约 54 元
请选择车型，或说"确认"使用推荐车型。
指定车型
你: 叫个快车从家到公司
AI: 正在为您呼叫快车...
订单已创建！订单号: qo01uCXI6ojeiD
预约出行
你: 明天早上8点从家到公司
AI: 已设置定时任务：明天 08:00
到点后将自动发起打车请求。
查询订单
你: 查询订单 qo01uCXI6ojeiD
AI: 订单号: qo01uCXI6ojeiD
状态: 司机已接单
车牌: 京A·XXXXX
距离: 约 1.2 公里
预计到达: 3 分钟
注意：当前仅支持查询进行中的订单，历史订单请在滴滴出行 App 中查看。
查询司机位置
你: 司机现在在哪里
AI: 🚗 司机位置信息
📍 位置: 北京市朝阳区建国门外大街1号国贸附近
📏 距您: 约 1.2 公里
⏱️ 预计到达: 约 3 分钟
驾车路线
你: 规划从望京SOHO到国贸的驾车路线
AI: 🚗 驾车路线规划
📍 路线: 望京SOHO → 国贸
📏 距离: 约 8.5 公里
⏱️ 预计: 约 25 分钟
公交地铁路线
你: 查一下从北京西站到西二旗的公交地铁路线
AI: 🚌 公交地铁路线
📍 路线: 北京西站 → 西二旗地铁站
⏱️ 预计: 约 55 分钟
🔄 换乘: 地铁9号线 → 地铁13号线
步行路线
你: 从家到地铁站步行要多久
AI: 🚶 步行路线
📍 路线: 家 → 地铁站
📏 距离: 约 800 米
⏱️ 预计: 约 10 分钟
骑行路线
你: 骑车从望京到三里屯怎么走
AI: 🚴 骑行路线
📍 路线: 望京 → 三里屯
📏 距离: 约 6.2 公里
⏱️ 预计: 约 28 分钟
周边搜索
你: 附近有什么咖啡馆
AI: ☕ 周边搜索结果
📍 当前位置周边咖啡馆：
1. 瑞幸咖啡 - 距您约 150 米
2. 星巴克 - 距您约 320 米
3. Manner Coffee - 距您约 580 米
- 详细工作流程: SKILL.md
- API 参考文档: api_references.md
- 错误处理指南: error_handling.md