didi-ride-skill

English | 中文

【滴滴出行统一入口】处理用户所有出行相关需求，提供完整的打车服务和路线规划功能。

ClawHub: didi-ride-skill-official

服务范围：支持滴滴出行服务覆盖的中国大陆城市。

目录

• 快速开始
• 功能介绍
• 前置安装
• MCP 工具
• 工作流程
• 使用示例
• 技术支持

---

快速开始

3 步开始使用：

Step 1 — 安装 mcporter

npm install -g mcporter

Step 2 — 获取并配置 MCP KEY

扫描 滴滴 MCP 平台 二维码获取 KEY，然后直接告诉 AI：

你: 我的 MCP Key 是 xxxxxx

Step 3 — 开始出行

你: 帮我打车去北京西站
你: 从国贸到三里屯怎么走

---

功能介绍

打车服务

功能	说明
实时叫车	地址解析 → 价格预估 → 车型决策（用户或偏好）→ 创建订单
预约出行	创建定时任务，到点后自动发起打车请求
查询订单	用户主动发送「查询订单」，单次查询当前状态
查询司机位置	逆地址编码，美化输出司机位置信息
取消订单	展示订单信息 → 用户确认 → 取消
价格预估	获取各车型价格对比
偏好设置	记住常用地址（家/公司）、车型偏好、叫车手机号

路线规划

功能	说明
驾车路线	规划小客车/轿车出行方案
公交地铁	综合公交、地铁通勤方案
步行路线	规划步行出行方案
骑行路线	规划骑行出行方案
周边搜索	搜索附近的地点、设施

---

前置安装

1. 获取 MCP KEY

方式 A：扫码获取（推荐，最快）

打开滴滴出行 App，扫描下方二维码，即可快速获取 MCP KEY：

方式 B：访问官网

访问 滴滴 MCP 平台 获取 MCP KEY。

2. 安装 mcporter

npm install -g mcporter

3. 配置 MCP KEY

方式 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"
      }
    }
  }
}

4. 验证配置

# 检查 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":"北京市"}'

---

MCP 工具

打车相关

工具	用途
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