滴滴出行服务 (DiDi Ride Skill)

通过 DiDi MCP Server API 提供打车、查询订单、司机位置、预约叫车、路线规划、周边搜索能力。

1. 快速开始（2 分钟）

1.1 获取 MCP KEY

方式一：用「滴滴出行App」扫码（推荐，最快）

⚠️ Agent 注意：用户客户端无法渲染 Markdown 图片，禁止直接输出上方图片语法。需向用户发送二维码时，执行 ### 3.9 MCP KEY 与配置 中的 openclaw message send 命令发图。

打开滴滴出行 App，扫描二维码，即可快速获取 MCP Key。

方式二：访问官网

访问 https://mcp.didichuxing.com/claw 获取您的 MCP Key。

1.2 配置 Key

方式一：对话中输入（推荐）

直接在对话中告诉我您的 MCP Key，我会帮您配置：

你: 我的 MCP Key 是 xxxxxx

方式二：OpenClaw 配置文件

编辑 ~/.openclaw/openclaw.json，添加：

{
  "skills": {
    "entries": {
      "didi-ride-skill": {
        "enabled": true,
        "apiKey": "你的MCP_KEY"  // apiKey 是 OpenClaw 标准字段名，存储的值就是滴滴平台的 MCP KEY
      }
    }
  }
}

1.3 开始使用

配置完成后，直接对话即可：

你: 打车去北京西站
你: 帮我查一下从国贸到三里屯的路线
你: 查询订单

首次使用时，OpenClaw 会提示安装 mcporter 工具。

2. 用户指南

本 Skill 支持以下操作：

• 打车：直接说"打车去[地点]"、"回家"、"上班"
• 查价：查一下从 A 到 B 多少钱
• 查询订单：输入「查询订单」了解当前订单状态（司机位置、行程进度等）
• 司机位置：司机在哪里、多久到
• 预约出行："15分钟后打个车"、"明天9点去机场"
• 路线规划：驾车/公交/步行/骑行路线
• 取消订单：取消当前订单

3. Agent 执行指令

以下内容为 AI 执行参考，用户可忽略。

3.1 文件地图

按需读取以下文件，不要猜测未读过的内容：

3.2 执行前检查

1. 检查 mcporter：若 mcporter 不存在（command not found），停止并引导用户阅读 references/setup.md。没有 mcporter 就无法调用任何 MCP 工具，后续任何流程都无法执行。

2. 检查 Key：执行 openclaw config get skills.entries.didi-ride-skill.apiKey，若输出为空或非 __OPENCLAW_REDACTED__，按 ### 3.9 MCP KEY 与配置 流程引导。Key 缺失时 mcporter 的报错信息具有误导性，不要尝试绕过。

   • ⚠️ 若 Key 已配置（返回 __OPENCLAW_REDACTED__）但 mcporter 仍报 Missing KEY parameter：不是 Key 失效，禁止向用户索要 Key。排查步骤见 references/error_handling.md 中的「mcporter Missing KEY parameter」章节。

3. mcporter 调用格式：

MCP_URL="https://mcp.didichuxing.com/mcp-servers?key=$DIDI_MCP_KEY"
mcporter call "$MCP_URL" <tool> --args '{"key":"value"}'

4. 参数值必须加引号（字符串格式），否则 API 会报”缺少必填参数”。
5. 先预估再下单：taxi_create_order 依赖 taxi_estimate 返回的 traceId，没有 traceId 下单会失败。traceId 有时效性，过期（-32021 错误）需重新预估。
6. 起终点处理：
   • 坐标必须来自 maps_textsearch，不要凭空猜测坐标。
   • 禁止用对话历史记忆补充起终点——用户可能已经换了地方。
   • 起终点缺失时按以下顺序补全：
     • ① 读 assets/PREFERENCE.md，若有地址别名且地址值非空，根据场景推断（如早晨→起点"家"、下班→起点"公司"）。别名行存在但地址为空 = 未配置。
     • ② 若无可用别名，直接询问用户。
   • 别名匹配规则（精确优先）："家"只匹配别名"家"，不匹配"妈妈家"；需明确含"妈妈"语义才匹配"妈妈家"。其他自定义别名同理。
   • 推断的起终点、或 maps_textsearch 返回多个候选结果时，必须在主流程 step 2 向用户确认；用户明确指定且精确匹配的地点无需确认。

3.3 用户确认策略