[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7E8CB3HT1A52SJ9EXSXAWXR":3,"skill-same:01M7E8CB3HT1A52SJ9EXSXAWXR":102},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":16,"sourceHtmlUrl":17,"categories":18,"keywords":19,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":23,"frontMatter":24,"refName":41,"commitSha":42,"skillDirectory":43,"forksCount":14,"repositoryHtmlUrl":44,"repositoryHomepageUrl":6,"ownerHtmlUrl":45,"ownerBlogUrl":46,"ownerDescription":47,"updatedAt":48,"install":49,"resources":61},"01M7E8CB3HT1A52SJ9EXSXAWXR","didi-ride-skill",null,"中国城市出行服务。当用户表达任何交通出行需求时必须使用此技能——包括打车\u002F叫车\u002F网约车、查价格、路线规划（公交\u002F驾车\u002F步行\u002F骑行）、周边搜索、查询订单\u002F司机位置\u002F取消订单。关键词：\"打车\"、\"叫车\"、\"去[地点]\"、\"回家\"、\"上班\"、\"下班\"、\"查价格\"、\"多少钱\"、\"路线\"、\"怎么走\"、\"步行到\"、\"附近\"、\"周边\"、\"司机\"、\"订单\"、\"查询订单\"。注意：即使用户未明确说\"打车\"，只要涉及从A地到B地、通勤、或交通方式选择，都应触发。不触发场景：开发打车应用、使用其他导航app、订外卖、查公交时刻表、股票\u002F财报查询。","Jane-o-O-o-O\u002Fpersonal-agent","Jane-o-O-o-O","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F179437561?v=4","01M7E4A2T6D0QNC04YPW4P0E9F","Jin Zhangzheng","01M7E4A2TRHBYJEQJM6FZKKZ1X",1,"MIT","https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent\u002Fblob\u002Fmain\u002Fresources\u002Fecosystem\u002Fupstream\u002Fdidi-ride-skill-official\u002Feaaaf96d4e60\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent\u002Fblob\u002Fmain\u002Fresources\u002Fecosystem\u002Fupstream\u002Fdidi-ride-skill-official\u002Feaaaf96d4e60\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: didi-ride-skill\ndescription: 中国城市出行服务。当用户表达任何交通出行需求时必须使用此技能——包括打车\u002F叫车\u002F网约车、查价格、路线规划（公交\u002F驾车\u002F步行\u002F骑行）、周边搜索、查询订单\u002F司机位置\u002F取消订单。关键词：\"打车\"、\"叫车\"、\"去[地点]\"、\"回家\"、\"上班\"、\"下班\"、\"查价格\"、\"多少钱\"、\"路线\"、\"怎么走\"、\"步行到\"、\"附近\"、\"周边\"、\"司机\"、\"订单\"、\"查询订单\"。注意：即使用户未明确说\"打车\"，只要涉及从A地到B地、通勤、或交通方式选择，都应触发。不触发场景：开发打车应用、使用其他导航app、订外卖、查公交时刻表、股票\u002F财报查询。\nhomepage: https:\u002F\u002Fmcp.didichuxing.com\nmetadata:\n  { \"openclaw\": { \"emoji\": \"🚕\", \"always\": true, \"requires\": { \"bins\": [\"openclaw\", \"mcporter\"], \"env\": [\"DIDI_MCP_KEY\"] }, \"primaryEnv\": \"DIDI_MCP_KEY\", \"install\": [{ \"id\": \"node\", \"kind\": \"node\", \"package\": \"mcporter\", \"bins\": [\"mcporter\"], \"label\": \"Install mcporter (node)\" }] } }\n---\n\n# 滴滴出行服务 (DiDi Ride Skill)\n\n通过 DiDi MCP Server API 提供打车、查询订单、司机位置、预约叫车、路线规划、周边搜索能力。\n\n---\n\n## 1. 快速开始（2 分钟）\n\n### 1.1 获取 MCP KEY\n\n**方式一：用「滴滴出行App」扫码（推荐，最快）**\n\n![滴滴出行APP扫码获取MCP Key，解锁一键打车](https:\u002F\u002Fs3-yspu-cdn.didistatic.com\u002Fmcp-web\u002Fqrcode\u002Fdidi_ride_skill_qrcode.png)\n> ⚠️ **Agent 注意**：用户客户端无法渲染 Markdown 图片，**禁止直接输出上方图片语法**。需向用户发送二维码时，执行 `### 3.9 MCP KEY 与配置` 中的 `openclaw message send` 命令发图。\n\n打开滴滴出行 App，扫描二维码，即可快速获取 MCP Key。\n\n**方式二：访问官网**\n\n访问 https:\u002F\u002Fmcp.didichuxing.com\u002Fclaw 获取您的 MCP Key。\n\n### 1.2 配置 Key\n\n**方式一：对话中输入（推荐）**\n\n直接在对话中告诉我您的 MCP Key，我会帮您配置：\n\n```\n你: 我的 MCP Key 是 xxxxxx\n```\n\n**方式二：OpenClaw 配置文件**\n\n编辑 `~\u002F.openclaw\u002Fopenclaw.json`，添加：\n\n```json\n{\n  \"skills\": {\n    \"entries\": {\n      \"didi-ride-skill\": {\n        \"enabled\": true,\n        \"apiKey\": \"你的MCP_KEY\"  \u002F\u002F apiKey 是 OpenClaw 标准字段名，存储的值就是滴滴平台的 MCP KEY\n      }\n    }\n  }\n}\n```\n\n### 1.3 开始使用\n\n配置完成后，直接对话即可：\n\n```\n你: 打车去北京西站\n你: 帮我查一下从国贸到三里屯的路线\n你: 查询订单\n```\n\n首次使用时，OpenClaw 会提示安装 mcporter 工具。\n\n---\n\n## 2. 用户指南\n\n本 Skill 支持以下操作：\n\n- **打车**：直接说\"打车去[地点]\"、\"回家\"、\"上班\"\n- **查价**：查一下从 A 到 B 多少钱\n- **查询订单**：输入「查询订单」了解当前订单状态（司机位置、行程进度等）\n- **司机位置**：司机在哪里、多久到\n- **预约出行**：\"15分钟后打个车\"、\"明天9点去机场\"\n- **路线规划**：驾车\u002F公交\u002F步行\u002F骑行路线\n- **取消订单**：取消当前订单\n\n---\n\n## 3. Agent 执行指令\n\n以下内容为 AI 执行参考，用户可忽略。\n\n### 3.1 文件地图 \n\n按需读取以下文件，不要猜测未读过的内容：\n\n| 文件 | 用途 | 何时读取 |\n|------|------|----------|\n| `SKILL.md` | 触发、主流程、硬性门禁、查询订单规则、预约出行规则 | 每次触发必读 |\n| `references\u002Fworkflow.md` | 分阶段详细流程与命令范式 | 需要实现细节时读 |\n| `references\u002Fapi_references.md` | MCP 函数签名与参数定义 | 每次调用工具前**必须**核对 |\n| `references\u002Ferror_handling.md` | create_order 失败提示、mcporter 常见错误、统一错误码、参数错误排查、apiKey 占位符泄漏 | ⚠️ 遇到任何调用失败（HTTP error \u002F StatusCode=400 \u002F `-32xxx` 错误码 \u002F `Unknown MCP server` \u002F `Missing KEY parameter` \u002F `SSE error: Invalid content type`）必须读取此文件 |\n| `references\u002Fsetup.md` | 安装 mcporter、配置 MCP KEY 的完整步骤 | 用户询问安装\u002F配置问题时读 |\n| `assets\u002FPREFERENCE.md` | 地址别名\u002F车型\u002F手机号偏好 | 用户提到别名地址（家、公司、妈妈家等）、车型、手机号，或未明确给出起终点时**必须**读取。别名匹配规则见执行前检查第 7 条 |\n\n### 3.2 执行前检查\n\n1. **检查 mcporter**：若 `mcporter` 不存在（`command not found`），停止并引导用户阅读 `references\u002Fsetup.md`。没有 mcporter 就无法调用任何 MCP 工具，后续任何流程都无法执行。\n\n2. **检查 Key**：执行 `openclaw config get skills.entries.didi-ride-skill.apiKey`，若输出为空或非 `__OPENCLAW_REDACTED__`，按 `### 3.9 MCP KEY 与配置` 流程引导。Key 缺失时 mcporter 的报错信息具有误导性，不要尝试绕过。\n   - ⚠️ **若 Key 已配置（返回 `__OPENCLAW_REDACTED__`）但 mcporter 仍报 `Missing KEY parameter`**：**不是 Key 失效**，**禁止向用户索要 Key**。排查步骤见 `references\u002Ferror_handling.md` 中的「mcporter Missing KEY parameter」章节。\n   - ⚠️ **`__OPENCLAW_REDACTED__` 是\"已配置\"哨兵值、不是真实 Key**：禁止从 `openclaw config get`（含 `--raw`）提取 Key 字面量；URL 中 `?key=...` 必须固定用 `$DIDI_MCP_KEY`。误把哨兵拼进 URL 会触发 `SSE error: Invalid content type`，详见 error_handling.md 同名章节。\n\n3. **mcporter.json 注意事项**：本 skill 使用 URL 直连模式，**不依赖 `config\u002Fmcporter.json`**，**禁止创建或修改该文件**。如果 mcporter 启动时报 JSON 校验错误（`invalid_type` \u002F `Failed to parse JSON`），参见 `references\u002Ferror_handling.md` 中的「mcporter.json 校验错误」章节。\n\n4. **mcporter 调用格式**（固定写法，不要变形）：\n\n```bash\nMCP_URL=\"https:\u002F\u002Fmcp.didichuxing.com\u002Fmcp-servers?key=$DIDI_MCP_KEY\"\nmcporter call \"$MCP_URL\" \u003Ctool> --args '{\"key\":\"value\"}'\n```\n\n**必读注意事项**：\n- `MCP_URL` 赋值和 `\"$MCP_URL\"` 引用**都必须用英文双引号**，否则 `$DIDI_MCP_KEY` 不会被 shell 展开。禁止用单引号或中文引号。\n- **禁止添加 `--server` 标志**（如 `--server didi-mcp`）。`--server` 会让 mcporter 去查找已注册的命名 server，找不到直接报 `Unknown MCP server`；即使找到了也会和 URL 参数冲突导致 `Missing tool name`。\n- **参数名必须核对 `references\u002Fapi_references.md`**，不要凭记忆。常见致命错误：`keyword` → 应为 `keywords`；`region` → 应为 `city`；`from_lng\u002Ffrom_lat\u002Fto_lng\u002Fto_lat` → 应为 `from_name\u002Ffrom_lat\u002Ffrom_lng\u002Fto_name\u002Fto_lat\u002Fto_lng`（六字段，不是四字段）。\n- mcporter 对参数错误的报错信息为 `backend call failed: ... StatusCode=400`（**不会告诉你具体哪个参数错了**），遇到此错误第一反应是核对参数名，详见 `references\u002Ferror_handling.md`。\n- 遇到不确定的参数名时，执行 `mcporter list \"$MCP_URL\"` 可以查看所有工具的完整签名。\n\n5. **参数值必须加引号**（字符串格式），包括经纬度和 `product_category` 等数字语义字段——API 只接受字符串，否则会报\"缺少必填参数\"。\n6. **先预估再下单**：`taxi_create_order` 依赖 `taxi_estimate` 返回的 `traceId`，没有 traceId 下单会失败。traceId 有时效性，过期（`-32021` 错误）需重新预估。\n7. **起终点处理**：\n\n   **坐标来源**：坐标必须来自 `maps_textsearch`，不要凭空猜测。**禁止用对话历史记忆补充起终点**——用户可能已换了地方。\n\n   **缺失补全**（按优先级）：① 读 `assets\u002FPREFERENCE.md`，有地址别名**且值非空**则按场景推断（早晨→起点\"家\"、下班→起点\"公司\"；别名行存在但地址为空 = 未配置）→ ② 无可用别名则直接询问用户。\n\n   **别名匹配**：精确优先——\"家\"只匹配\"家\"，不匹配\"妈妈家\"；需明确含\"妈妈\"语义才匹配\"妈妈家\"。读取时**必须扫描整张表格**（到下一个 `##` 为止），不要只看默认的前两行——用户可能已追加\"妈妈家\"\"儿子学校\"\"健身房\"等自定义别名。\n\n   **确认规则**：推断的起终点、或 `maps_textsearch` 返回多个候选时，必须在主流程 step 2 向用户确认；用户明确指定且精确匹配的地点无需确认。\n\n8. **`taxi_create_order` 参数约束**：\n- 只接受三个字段：`estimate_trace_id`、`product_category`、`caller_car_phone`（可选）\n- `taxi_create_order` 的 `caller_car_phone` 未由用户提供时，从 `assets\u002FPREFERENCE.md` 的「默认偏好」表读取；都没有就**不传该参数**，禁止在对话中反复向用户索要手机号——skill 级别已允许没有手机号直接发单，口头询问一次若用户未答应即视为\"用默认\u002F不传\"。\n- 不要把 `taxi_estimate` 的坐标\u002F名称字段（`from_lat` \u002F `from_lng` \u002F `from_name` \u002F `to_lat` \u002F `to_lng` \u002F `to_name`）带入。\n\n### 3.3 用户确认策略\n\n| 场景 | 规则 |\n|------|------|\n| 打车（实时\u002F预约） | 推断的地址或搜索返回多个候选时必须确认起终点（见主流程 step 2），用户明确指定且精确匹配时无需确认，确认后再预估下单 |\n| 取消订单 | 即使用户说了\"取消订单\"，仍必须先明确询问\"确认取消吗？\"，等用户回复确认后才能调用 `taxi_cancel_order`。用户的取消意图 ≠ 取消确认。 |\n\n### 3.4 主流程（最小可执行）\n\n1. 地址解析：`maps_textsearch`（必要时结合 `assets\u002FPREFERENCE.md`，按执行前检查第 7 条处理）。\n2. 确认起终点：\n   - **单一精确匹配**（用户描述明确 + `maps_textsearch` 仅返回 1 个结果）→ 无需确认，直接使用；\n   - **多个候选**（`maps_textsearch` 返回 ≥2 个同名或近似地点）→ **必须列出至少前 3 个候选供用户选择**（如\"搜索到以下万达广场：1) 朝阳CBD店 2) 石景山店 3) 通州店，请问您要去哪个？\"），**不要自行代选或只展示一个**；\n   - **别名推断**（从 PREFERENCE.md 推断的起终点）→ 向用户确认 + 告知推断来源（如\"按偏好里「家」推断终点是望京 SOHO，对吗？\"）；\n   - 用户明确指定且文本精确匹配的地点 → 无需确认。用户纠正则按纠正内容重新解析。\n3. 价格预估：`taxi_estimate`，记录 `traceId`。\n4. 车型决策（优先级：**当前消息 > 偏好 > 询问用户**）：\n   - 用户在当前消息中明确指定车型（如\"叫快车\"\"帮我叫专车\"）→ 在 `taxi_estimate` 返回列表中**精确匹配**对应 `productCategory`（快车=1，专车=8），覆盖一切偏好设置；\n   - 用户未指定 → 使用 `assets\u002FPREFERENCE.md` 中场景车型偏好的精确 `productCategory` 值；\n   - 偏好也未配置 → 向用户询问车型，不要自行推荐；\n   - 注意：快车（1）和特惠快车（201）是**不同服务等级**，不可因价格更优而自动替换；\n   - 可用车型以 `taxi_estimate` API 返回为准。若不包含指定\u002F偏好的 `productCategory`，向用户说明并让其重新选择，不要默默用近似车型替代。\n   - ⚡ **简化原则（尤其对 reasoning 模型）**：用户在当前消息中说什么车型就用什么，不要进一步质疑或反复确认；偏好缺失时直接向用户问一次即可，不要在同一轮列出多个权衡选项让用户挑。规则很短，不要过度展开思考分支。\n5. 创建订单：`taxi_create_order`（使用最新 `traceId`）。\n   - 若此调用返回 `Streamable HTTP error: Unexpected content type: text\u002Fplain`，**立即停止流程**，按 `references\u002Ferror_handling.md` 的「taxi_create_order 调用失败」章节向用户输出固定文案。禁止重试、禁止切换 Key、禁止跳过此步继续往下。\n6. 结果输出：给出订单号、起终点、车型、预估价，末尾提示 `💡 发送「查询订单」可了解当前订单状态`，并告知 `⏱️ 将在 5 分钟后自动为您回查订单状态`。\n7. ⚠️ 自动回查（必做）：根据 `### 3.8 发单后自动回查` 中的 cron 指令内容，创建定时任务，参数信息严格遵循章节内要求。此步不可省略。\n\n### 3.5 偏好设置更新\n\n当用户要求设置\u002F记住\u002F记一下\u002F帮我记\u002F保存地址别名、车型偏好或手机号时，**必须**通过文件编辑工具（`Edit` \u002F `Write`）修改 `assets\u002FPREFERENCE.md` 对应的 markdown 表格行。**严禁**仅以文字回复\"记住了\u002F已保存\"而不调用文件编辑工具——偏好必须落盘到文件，口头承诺无效。\n\n**执行步骤**：\n1. `Read` 读取 `assets\u002FPREFERENCE.md` 完整内容（注意表格可能已有用户追加的行）；\n2. 定位要更新的表格行（地址别名表 \u002F 场景车型偏好表 \u002F 默认偏好表）；\n3. 对地址别名：先调用 `maps_textsearch` 获取坐标，再更新表格行；\n4. 调用 `Edit`（替换单行）或 `Write`（整表重写）写入新值；\n5. **回读验证**：再次 `Read` 确认新值已落盘。若未成功，告知用户并重试。\n\n- **地址别名**（\"我家在…\"、\"公司在…\"、\"儿子的学校是…\"、\"妈妈家在…\"）：先调用 `maps_textsearch` 解析地址获取坐标，然后更新「地址别名」表——已有别名更新对应行，新别名追加新行。别名由用户定义，不限于\"家\"\"公司\"。\n- **场景车型**（\"上班用快车\"、\"下班用特惠和快车\"）：更新「场景车型偏好」表对应行。品类代码参考表底注释，多车型用英文逗号分隔（如 `1,201`）。\n- **叫车手机号**（\"我的手机号是…\"）：更新「默认偏好」表中的叫车手机号行。\n- **创建订单时**：若 PREFERENCE.md 中配置了叫车手机号，将其作为 `caller_car_phone` 参数传入 `taxi_create_order`，`caller_car_phone` 为可选参数，若未配置则不传。\n\n### 3.6 查询订单\n\n触发词：`查询订单` \u002F `查询订单 \u003CorderId>`\n\n订单号来源（优先级从高到低）：\n1. 用户消息中明确给出；\n2. 当前对话上下文中最近一次创建的订单号；\n3. 以上均无时，向用户询问。\n\n调用命令：\n\n```bash\nMCP_URL=\"https:\u002F\u002Fmcp.didichuxing.com\u002Fmcp-servers?key=$DIDI_MCP_KEY\"\nmcporter call \"$MCP_URL\" taxi_query_order --args '{\"order_id\":\"ORDER_ID\"}'\n```\n\n#### 3.6.1 状态码与输出规则\n\n| code | 含义 | 必须输出 |\n|------|------|----------|\n| 0 | 匹配中 | ⏳ 正在为您匹配司机，请稍候 |\n| 1 | 司机已接单 | **必须展示**：司机姓名、车型、车牌、电话；距上车点距离和预计到达时间 |\n| 2 | 司机已到达 | 🔔 司机已到达上车点，请前往上车 |\n| 4 | 行程进行中 | 🚗 行程已开始 |\n| 5 | 订单完成 | ✅ 行程结束，展示费用（如有） |\n| 6 | 订单已被系统取消 | ❌ 订单已被系统取消 |\n| 7 | 订单已被取消 | ❌ 订单已取消 |\n| 3\u002F8-12 | 其他终态 | 显示对应状态描述 |\n\n### 3.7 预约出行规则\n\n当用户要求在特定时间叫车（如\"15分钟后\"、\"明天9点\"）：\n\n- 使用 cron 一次性任务（`--at`），到点由 isolated agent 独立执行完整打车流程；\n- ⚠️ `--message` 必须包含完整起终点（带城市前缀）和车型，isolated session 无历史上下文。起点或终点缺失时先从 `assets\u002FPREFERENCE.md` 推断并向用户确认，推断不了则必须先询问用户，**不要自行推断未知信息**；\n- 到点后 agent 自行执行：地址解析 → 价格预估（获取最新 traceId）→ 创建订单；\n- 如果无法获取当前会话的 metadata（channel\u002Fchat_id），**仅跳过 cron 创建步骤**，其余流程（地址解析 → 价格预估 → 展示结果）**正常执行不受影响**。在回复中提醒用户到时手动发消息叫车。metadata 不可用 ≠ 放弃整个打车流程；\n- 如果定时任务创建失败，必须在回复中提示用户，不能默默失败。\n\n\n```bash\n# ⚠️ 占位符替换规则：所有 \u003CXXX> 形式都是占位符，必须替换为真实值；\n#    禁止保留 \u003C> 字面、禁止当成 shell 变量加 $（不是 $TIME \u002F $CHAT_ID）。\n#   \u003CFROM_NAME>    → 带城市前缀的起点全称（如\"北京市西二旗地铁站\"）\n#   \u003CTO_NAME>      → 带城市前缀的终点全称（如\"北京市佰嘉城小区\"）\n#   \u003CVEHICLE>      → 车型（如\"快车\"）\n#   \u003CTIME>         → 见下方时间规则（如 \"10m\" \u002F \"2h\" \u002F ISO 时间）\n#   \u003CCHANNEL_NAME> → 当前会话 metadata 中的 channel 字段（如 feishu、telegram），命令行参数不带引号；不可用 last\n#   \u003CCHAT_ID>      → 当前会话 metadata 中的 chat_id 字段\n\nopenclaw cron add \\\n  --name \"didi-ride-skill:$(date +%s)\" \\\n  --at \"\u003CTIME>\" \\\n  --session isolated \\\n  --message \"执行定时打车：起点「\u003CFROM_NAME>」，终点「\u003CTO_NAME>」，车型「\u003CVEHICLE>」。请完整执行打车流程：地址解析 → 价格预估（获取最新 traceId）→ 创建订单。订单创建成功后，输出订单信息并提示用户可发送「查询订单」了解订单状态，同时创建 5 分钟后自动回查 cron（模板见 SKILL.md 第 3.8 节「发单后自动回查」）。\" \\\n  --announce \\\n  --channel \u003CCHANNEL_NAME> \\\n  --to \"\u003CCHAT_ID>\"\n```\n\n#### 3.7.1 TIME 填写规则\n\n| 场景 | 写法 | 示例 |\n|------|------|------|\n| 相对时间（X 分钟\u002F小时后） | duration 格式 | `15m` \u002F `2h` \u002F `1h30m` |\n| 绝对时间（具体时刻） | 本地时区 ISO 格式 | `$(date -d '明天 09:00' '+%Y-%m-%dT%H:%M:%S+08:00')` |\n\n- 相对时间（如 `15m`）无需格式化，直接使用\n- 绝对时间使用带时区的 ISO 8601 格式：`YYYY-MM-DDTHH:MM:SS+08:00`（北京时间东八区）\n\n**系统兼容性说明：**\n- Linux (GNU date): `date -d '明天 09:00' '+%Y-%m-%dT%H:%M:%S+08:00'`\n- macOS (BSD date): `TZ=Asia\u002FShanghai date -j -v+1d -f '%H:%M' '09:00' '+%Y-%m-%dT%H:%M:%S+08:00'`\n\n### 3.8 发单后自动回查\n\n发单成功后（实时单或预约单），根据本章节下文 \"openclaw cron add\" 命令，创建 cron 任务，务必按照本章节下文bash命令参数设置。\n- 如果无法获取当前会话的 metadata（channel\u002Fchat_id），**仅跳过 cron 创建步骤**，主流程正常完成（已出单则告知用户\"5 分钟后可发送'查询订单'了解最新状态\"）。\n- 如果定时任务创建失败（命令本身报错），必须在回复中提示用户，不能默默失败。\n\n```bash\n# ⚠️ 占位符替换规则：所有 \u003CXXX> 形式都是占位符，必须替换为真实值，禁止保留 \u003C> 字面或加 $ 当 shell 变量。\n#   \u003CORDER_ID>     → 实际订单号（taxi_create_order 返回）\n#   \u003CCHANNEL_NAME> \u002F \u003CCHAT_ID> → 同 §3.7，从会话 metadata 读取或用兜底值\n\nopenclaw cron add \\\n  --name \"didi-ride-skill:check:\u003CORDER_ID>\" \\\n  --at \"5m\" \\\n  --session isolated \\\n  --message \"查询滴滴订单状态：订单号 \u003CORDER_ID>。调用 taxi_query_order 查询并输出当前状态。如果司机已接单，输出司机姓名、车型、车牌、电话及预计到达时间；如果仍在匹配中，提示用户耐心等待。\" \\\n  --announce \\\n  --channel \u003CCHANNEL_NAME> \\\n  --to \"\u003CCHAT_ID>\"\n```\n\n### 3.9 MCP KEY 与配置\n\n> **术语说明**：滴滴平台称此凭证为「MCP KEY」，OpenClaw 配置字段统一叫 `apiKey`，注入后的环境变量为 `DIDI_MCP_KEY`——三者是同一个值。通过 `openclaw config set` 持久化后，OpenClaw 在每次 agent run 启动时自动注入为环境变量。\n\n#### 3.9.1 检查 Key 状态\n\n```bash\n# 仅用于判断 DIDI_MCP_KEY 是否已配置；输出不是 Key 值，不可代入 URL\nopenclaw config get skills.entries.didi-ride-skill.apiKey\n```\n结果输出为空 = 未配置；输出 `__OPENCLAW_REDACTED__` = 已配置，**必须用**环境变量 `$DIDI_MCP_KEY` 拼接 URL。\n\n⚠️ `openclaw config get`（含 `--raw`）永远不返回真实 Key——任何把哨兵值拼入 URL\u002Fheader\u002F参数的请求都会失败，见 error_handling.md「SSE error \u002F apiKey 占位符泄漏」。\n\n#### 3.9.2 持久化用户 Key\n\n⚠️ 当用户回复了 Key（如\"我的 Key 是 xxxxxx\"），**必须**执行以下命令持久化 & 在当前 Shell 生效：\n\n```bash\n#   YOUR_KEY → 实际的 MCP KEY\nopenclaw config set 'skills.entries.didi-ride-skill.apiKey' 'YOUR_KEY'\nexport DIDI_MCP_KEY='YOUR_KEY'\n```\n\n- 持久化后 OpenClaw 在所有后续 agent run（含 cron isolated session）中自动注入 `DIDI_MCP_KEY`\n- ⚠️⚠️⚠️ 命令输出 `\"Restart the gateway to apply.\"` ——**这是通用提示，必须忽略，禁止执行 restart**。`apiKey` 每次 agent run 动态读取，无需重启；强制重启会导致网关崩溃\n\n#### 3.9.3 Key 缺失或鉴权失败\n\n⚠️ Key 未配置**或** MCP 返回鉴权失败（`error.code: -32002`）时，依次执行：\n\n1. 发送二维码图片（`{CHAT_ID}` → metadata 的 chat_id，`{CHANNEL_NAME}` → metadata 的 channel）：\n\n```bash\nopenclaw message send --channel {CHANNEL_NAME} --target {CHAT_ID} --media \"https:\u002F\u002Fs3-yspu-cdn.didistatic.com\u002Fmcp-web\u002Fqrcode\u002Fdidi_ride_skill_qrcode.png\" --message \"滴滴出行APP扫码获取MCP Key，解锁一键打车\"\n```\n\n2. 输出文字：\n\n> 您还没有配置 DIDI_MCP_KEY 或 Key 已失效，请访问 [滴滴MCP平台](https:\u002F\u002Fmcp.didichuxing.com\u002Fclaw) 获取 MCP KEY，然后配置环境变量或在 OpenClaw 配置文件中设置。\n\n### 3.10 工具清单\n\n| 领域 | 工具 |\n|------|------|\n| 地图 | `maps_textsearch`, `maps_regeocode` |\n| 路线 | `maps_direction_driving`, `maps_direction_transit`, `maps_direction_walking`, `maps_direction_bicycling` |\n| 周边 | `maps_place_around` |\n| 打车 | `taxi_estimate`（预估）, `taxi_create_order`（下单）, `taxi_query_order`（查单+司机位置）, `taxi_cancel_order`（取消） |\n","# 滴滴出行服务 (DiDi Ride Skill)\n\n通过 DiDi MCP Server API 提供打车、查询订单、司机位置、预约叫车、路线规划、周边搜索能力。\n\n---\n\n## 1. 快速开始（2 分钟）\n\n### 1.1 获取 MCP KEY\n\n**方式一：用「滴滴出行App」扫码（推荐，最快）**\n\n![滴滴出行APP扫码获取MCP Key，解锁一键打车](https:\u002F\u002Fs3-yspu-cdn.didistatic.com\u002Fmcp-web\u002Fqrcode\u002Fdidi_ride_skill_qrcode.png)\n> ⚠️ **Agent 注意**：用户客户端无法渲染 Markdown 图片，**禁止直接输出上方图片语法**。需向用户发送二维码时，执行 `### 3.9 MCP KEY 与配置` 中的 `openclaw message send` 命令发图。\n\n打开滴滴出行 App，扫描二维码，即可快速获取 MCP Key。\n\n**方式二：访问官网**\n\n访问 https:\u002F\u002Fmcp.didichuxing.com\u002Fclaw 获取您的 MCP Key。\n\n### 1.2 配置 Key\n\n**方式一：对话中输入（推荐）**\n\n直接在对话中告诉我您的 MCP Key，我会帮您配置：\n\n```\n你: 我的 MCP Key 是 xxxxxx\n```\n\n**方式二：OpenClaw 配置文件**\n\n编辑 `~\u002F.openclaw\u002Fopenclaw.json`，添加：\n\n```json\n{\n  \"skills\": {\n    \"entries\": {\n      \"didi-ride-skill\": {\n        \"enabled\": true,\n        \"apiKey\": \"你的MCP_KEY\"  \u002F\u002F apiKey 是 OpenClaw 标准字段名，存储的值就是滴滴平台的 MCP KEY\n      }\n    }\n  }\n}\n```\n\n### 1.3 开始使用\n\n配置完成后，直接对话即可：\n\n```\n你: 打车去北京西站\n你: 帮我查一下从国贸到三里屯的路线\n你: 查询订单\n```\n\n首次使用时，OpenClaw 会提示安装 mcporter 工具。\n\n---\n\n## 2. 用户指南\n\n本 Skill 支持以下操作：\n\n- **打车**：直接说\"打车去[地点]\"、\"回家\"、\"上班\"\n- **查价**：查一下从 A 到 B 多少钱\n- **查询订单**：输入「查询订单」了解当前订单状态（司机位置、行程进度等）\n- **司机位置**：司机在哪里、多久到\n- **预约出行**：\"15分钟后打个车\"、\"明天9点去机场\"\n- **路线规划**：驾车\u002F公交\u002F步行\u002F骑行路线\n- **取消订单**：取消当前订单\n\n---\n\n## 3. Agent 执行指令\n\n以下内容为 AI 执行参考，用户可忽略。\n\n### 3.1 文件地图 \n\n按需读取以下文件，不要猜测未读过的内容：\n\n| 文件 | 用途 | 何时读取 |\n|------|------|----------|\n| `SKILL.md` | 触发、主流程、硬性门禁、查询订单规则、预约出行规则 | 每次触发必读 |\n| `references\u002Fworkflow.md` | 分阶段详细流程与命令范式 | 需要实现细节时读 |\n| `references\u002Fapi_references.md` | MCP 函数签名与参数定义 | 每次调用工具前**必须**核对 |\n| `references\u002Ferror_handling.md` | create_order 失败提示、mcporter 常见错误、统一错误码、参数错误排查、apiKey 占位符泄漏 | ⚠️ 遇到任何调用失败（HTTP error \u002F StatusCode=400 \u002F `-32xxx` 错误码 \u002F `Unknown MCP server` \u002F `Missing KEY parameter` \u002F `SSE error: Invalid content type`）必须读取此文件 |\n| `references\u002Fsetup.md` | 安装 mcporter、配置 MCP KEY 的完整步骤 | 用户询问安装\u002F配置问题时读 |\n| `assets\u002FPREFERENCE.md` | 地址别名\u002F车型\u002F手机号偏好 | 用户提到别名地址（家、公司、妈妈家等）、车型、手机号，或未明确给出起终点时**必须**读取。别名匹配规则见执行前检查第 7 条 |\n\n### 3.2 执行前检查\n\n1. **检查 mcporter**：若 `mcporter` 不存在（`command not found`），停止并引导用户阅读 `references\u002Fsetup.md`。没有 mcporter 就无法调用任何 MCP 工具，后续任何流程都无法执行。\n\n2. **检查 Key**：执行 `openclaw config get skills.entries.didi-ride-skill.apiKey`，若输出为空或非 `__OPENCLAW_REDACTED__`，按 `### 3.9 MCP KEY 与配置` 流程引导。Key 缺失时 mcporter 的报错信息具有误导性，不要尝试绕过。\n   - ⚠️ **若 Key 已配置（返回 `__OPENCLAW_REDACTED__`）但 mcporter 仍报 `Missing KEY parameter`**：**不是 Key 失效**，**禁止向用户索要 Key**。排查步骤见 `references\u002Ferror_handling.md` 中的「mcporter Missing KEY parameter」章节。\n   - ⚠️ **`__OPENCLAW_REDACTED__` 是\"已配置\"哨兵值、不是真实 Key**：禁止从 `openclaw config get`（含 `--raw`）提取 Key 字面量；URL 中 `?key=...` 必须固定用 `$DIDI_MCP_KEY`。误把哨兵拼进 URL 会触发 `SSE error: Invalid content type`，详见 error_handling.md 同名章节。\n\n3. **mcporter.json 注意事项**：本 skill 使用 URL 直连模式，**不依赖 `config\u002Fmcporter.json`**，**禁止创建或修改该文件**。如果 mcporter 启动时报 JSON 校验错误（`invalid_type` \u002F `Failed to parse JSON`），参见 `references\u002Ferror_handling.md` 中的「mcporter.json 校验错误」章节。\n\n4. **mcporter 调用格式**（固定写法，不要变形）：\n\n```bash\nMCP_URL=\"https:\u002F\u002Fmcp.didichuxing.com\u002Fmcp-servers?key=$DIDI_MCP_KEY\"\nmcporter call \"$MCP_URL\" \u003Ctool> --args '{\"key\":\"value\"}'\n```\n\n**必读注意事项**：\n- `MCP_URL` 赋值和 `\"$MCP_URL\"` 引用**都必须用英文双引号**，否则 `$DIDI_MCP_KEY` 不会被 shell 展开。禁止用单引号或中文引号。\n- **禁止添加 `--server` 标志**（如 `--server didi-mcp`）。`--server` 会让 mcporter 去查找已注册的命名 server，找不到直接报 `Unknown MCP server`；即使找到了也会和 URL 参数冲突导致 `Missing tool name`。\n- **参数名必须核对 `references\u002Fapi_references.md`**，不要凭记忆。常见致命错误：`keyword` → 应为 `keywords`；`region` → 应为 `city`；`from_lng\u002Ffrom_lat\u002Fto_lng\u002Fto_lat` → 应为 `from_name\u002Ffrom_lat\u002Ffrom_lng\u002Fto_name\u002Fto_lat\u002Fto_lng`（六字段，不是四字段）。\n- mcporter 对参数错误的报错信息为 `backend call failed: ... StatusCode=400`（**不会告诉你具体哪个参数错了**），遇到此错误第一反应是核对参数名，详见 `references\u002Ferror_handling.md`。\n- 遇到不确定的参数名时，执行 `mcporter list \"$MCP_URL\"` 可以查看所有工具的完整签名。\n\n5. **参数值必须加引号**（字符串格式），包括经纬度和 `product_category` 等数字语义字段——API 只接受字符串，否则会报\"缺少必填参数\"。\n6. **先预估再下单**：`taxi_create_order` 依赖 `taxi_estimate` 返回的 `traceId`，没有 traceId 下单会失败。traceId 有时效性，过期（`-32021` 错误）需重新预估。\n7. **起终点处理**：\n\n   **坐标来源**：坐标必须来自 `maps_textsearch`，不要凭空猜测。**禁止用对话历史记忆补充起终点**——用户可能已换了地方。\n\n   **缺失补全**（按优先级）：① 读 `assets\u002FPREFERENCE.md`，有地址别名**且值非空**则按场景推断（早晨→起点\"家\"、下班→起点\"公司\"；别名行存在但地址为空 = 未配置）→ ② 无可用别名则直接询问用户。\n\n   **别名匹配**：精确优先——\"家\"只匹配\"家\"，不匹配\"妈妈家\"；需明确含\"妈妈\"语义才匹配\"妈妈家\"。读取时**必须扫描整张表格**（到下一个 `##` 为止），不要只看默认的前两行——用户可能已追加\"妈妈家\"\"儿子学校\"\"健身房\"等自定义别名。\n\n   **确认规则**：推断的起终点、或 `maps_textsearch` 返回多个候选时，必须在主流程 step 2 向用户确认；用户明确指定且精确匹配的地点无需确认。\n\n8. **`taxi_create_order` 参数约束**：\n- 只接受三个字段：`estimate_trace_id`、`product_category`、`caller_car_phone`（可选）\n- `taxi_create_order` 的 `caller_car_phone` 未由用户提供时，从 `assets\u002FPREFERENCE.md` 的「默认偏好」表读取；都没有就**不传该参数**，禁止在对话中反复向用户索要手机号——skill 级别已允许没有手机号直接发单，口头询问一次若用户未答应即视为\"用默认\u002F不传\"。\n- 不要把 `taxi_estimate` 的坐标\u002F名称字段（`from_lat` \u002F `from_lng` \u002F `from_name` \u002F `to_lat` \u002F `to_lng` \u002F `to_name`）带入。\n\n### 3.3 用户确认策略\n\n| 场景 | 规则 |\n|------|------|\n| 打车（实时\u002F预约） | 推断的地址或搜索返回多个候选时必须确认起终点（见主流程 step 2），用户明确指定且精确匹配时无需确认，确认后再预估下单 |\n| 取消订单 | 即使用户说了\"取消订单\"，仍必须先明确询问\"确认取消吗？\"，等用户回复确认后才能调用 `taxi_cancel_order`。用户的取消意图 ≠ 取消确认。 |\n\n### 3.4 主流程（最小可执行）\n\n1. 地址解析：`maps_textsearch`（必要时结合 `assets\u002FPREFERENCE.md`，按执行前检查第 7 条处理）。\n2. 确认起终点：\n   - **单一精确匹配**（用户描述明确 + `maps_textsearch` 仅返回 1 个结果）→ 无需确认，直接使用；\n   - **多个候选**（`maps_textsearch` 返回 ≥2 个同名或近似地点）→ **必须列出至少前 3 个候选供用户选择**（如\"搜索到以下万达广场：1) 朝阳CBD店 2) 石景山店 3) 通州店，请问您要去哪个？\"），**不要自行代选或只展示一个**；\n   - **别名推断**（从 PREFERENCE.md 推断的起终点）→ 向用户确认 + 告知推断来源（如\"按偏好里「家」推断终点是望京 SOHO，对吗？\"）；\n   - 用户明确指定且文本精确匹配的地点 → 无需确认。用户纠正则按纠正内容重新解析。\n3. 价格预估：`taxi_estimate`，记录 `traceId`。\n4. 车型决策（优先级：**当前消息 > 偏好 > 询问用户**）：\n   - 用户在当前消息中明确指定车型（如\"叫快车\"\"帮我叫专车\"）→ 在 `taxi_estimate` 返回列表中**精确匹配**对应 `productCategory`（快车=1，专车=8），覆盖一切偏好设置；\n   - 用户未指定 → 使用 `assets\u002FPREFERENCE.md` 中场景车型偏好的精确 `productCategory` 值；\n   - 偏好也未配置 → 向用户询问车型，不要自行推荐；\n   - 注意：快车（1）和特惠快车（201）是**不同服务等级**，不可因价格更优而自动替换；\n   - 可用车型以 `taxi_estimate` API 返回为准。若不包含指定\u002F偏好的 `productCategory`，向用户说明并让其重新选择，不要默默用近似车型替代。\n   - ⚡ **简化原则（尤其对 reasoning 模型）**：用户在当前消息中说什么车型就用什么，不要进一步质疑或反复确认；偏好缺失时直接向用户问一次即可，不要在同一轮列出多个权衡选项让用户挑。规则很短，不要过度展开思考分支。\n5. 创建订单：`taxi_create_order`（使用最新 `traceId`）。\n   - 若此调用返回 `Streamable HTTP error: Unexpected content type: text\u002Fplain`，**立即停止流程**，按 `references\u002Ferror_handling.md` 的「taxi_create_order 调用失败」章节向用户输出固定文案。禁止重试、禁止切换 Key、禁止跳过此步继续往下。\n6. 结果输出：给出订单号、起终点、车型、预估价，末尾提示 `💡 发送「查询订单」可了解当前订单状态`，并告知 `⏱️ 将在 5 分钟后自动为您回查订单状态`。\n7. ⚠️ 自动回查（必做）：根据 `### 3.8 发单后自动回查` 中的 cron 指令内容，创建定时任务，参数信息严格遵循章节内要求。此步不可省略。\n\n### 3.5 偏好设置更新\n\n当用户要求设置\u002F记住\u002F记一下\u002F帮我记\u002F保存地址别名、车型偏好或手机号时，**必须**通过文件编辑工具（`Edit` \u002F `Write`）修改 `assets\u002FPREFERENCE.md` 对应的 markdown 表格行。**严禁**仅以文字回复\"记住了\u002F已保存\"而不调用文件编辑工具——偏好必须落盘到文件，口头承诺无效。\n\n**执行步骤**：\n1. `Read` 读取 `assets\u002FPREFERENCE.md` 完整内容（注意表格可能已有用户追加的行）；\n2. 定位要更新的表格行（地址别名表 \u002F 场景车型偏好表 \u002F 默认偏好表）；\n3. 对地址别名：先调用 `maps_textsearch` 获取坐标，再更新表格行；\n4. 调用 `Edit`（替换单行）或 `Write`（整表重写）写入新值；\n5. **回读验证**：再次 `Read` 确认新值已落盘。若未成功，告知用户并重试。\n\n- **地址别名**（\"我家在…\"、\"公司在…\"、\"儿子的学校是…\"、\"妈妈家在…\"）：先调用 `maps_textsearch` 解析地址获取坐标，然后更新「地址别名」表——已有别名更新对应行，新别名追加新行。别名由用户定义，不限于\"家\"\"公司\"。\n- **场景车型**（\"上班用快车\"、\"下班用特惠和快车\"）：更新「场景车型偏好」表对应行。品类代码参考表底注释，多车型用英文逗号分隔（如 `1,201`）。\n- **叫车手机号**（\"我的手机号是…\"）：更新「默认偏好」表中的叫车手机号行。\n- **创建订单时**：若 PREFERENCE.md 中配置了叫车手机号，将其作为 `caller_car_phone` 参数传入 `taxi_create_order`，`caller_car_phone` 为可选参数，若未配置则不传。\n\n### 3.6 查询订单\n\n触发词：`查询订单` \u002F `查询订单 \u003CorderId>`\n\n订单号来源（优先级从高到低）：\n1. 用户消息中明确给出；\n2. 当前对话上下文中最近一次创建的订单号；\n3. 以上均无时，向用户询问。\n\n调用命令：\n\n```bash\nMCP_URL=\"https:\u002F\u002Fmcp.didichuxing.com\u002Fmcp-servers?key=$DIDI_MCP_KEY\"\nmcporter call \"$MCP_URL\" taxi_query_order --args '{\"order_id\":\"ORDER_ID\"}'\n```\n\n#### 3.6.1 状态码与输出规则\n\n| code | 含义 | 必须输出 |\n|------|------|----------|\n| 0 | 匹配中 | ⏳ 正在为您匹配司机，请稍候 |\n| 1 | 司机已接单 | **必须展示**：司机姓名、车型、车牌、电话；距上车点距离和预计到达时间 |\n| 2 | 司机已到达 | 🔔 司机已到达上车点，请前往上车 |\n| 4 | 行程进行中 | 🚗 行程已开始 |\n| 5 | 订单完成 | ✅ 行程结束，展示费用（如有） |\n| 6 | 订单已被系统取消 | ❌ 订单已被系统取消 |\n| 7 | 订单已被取消 | ❌ 订单已取消 |\n| 3\u002F8-12 | 其他终态 | 显示对应状态描述 |\n\n### 3.7 预约出行规则\n\n当用户要求在特定时间叫车（如\"15分钟后\"、\"明天9点\"）：\n\n- 使用 cron 一次性任务（`--at`），到点由 isolated agent 独立执行完整打车流程；\n- ⚠️ `--message` 必须包含完整起终点（带城市前缀）和车型，isolated session 无历史上下文。起点或终点缺失时先从 `assets\u002FPREFERENCE.md` 推断并向用户确认，推断不了则必须先询问用户，**不要自行推断未知信息**；\n- 到点后 agent 自行执行：地址解析 → 价格预估（获取最新 traceId）→ 创建订单；\n- 如果无法获取当前会话的 metadata（channel\u002Fchat_id），**仅跳过 cron 创建步骤**，其余流程（地址解析 → 价格预估 → 展示结果）**正常执行不受影响**。在回复中提醒用户到时手动发消息叫车。metadata 不可用 ≠ 放弃整个打车流程；\n- 如果定时任务创建失败，必须在回复中提示用户，不能默默失败。\n\n\n```bash\n# ⚠️ 占位符替换规则：所有 \u003CXXX> 形式都是占位符，必须替换为真实值；\n#    禁止保留 \u003C> 字面、禁止当成 shell 变量加 $（不是 $TIME \u002F $CHAT_ID）。\n#   \u003CFROM_NAME>    → 带城市前缀的起点全称（如\"北京市西二旗地铁站\"）\n#   \u003CTO_NAME>      → 带城市前缀的终点全称（如\"北京市佰嘉城小区\"）\n#   \u003CVEHICLE>      → 车型（如\"快车\"）\n#   \u003CTIME>         → 见下方时间规则（如 \"10m\" \u002F \"2h\" \u002F ISO 时间）\n#   \u003CCHANNEL_NAME> → 当前会话 metadata 中的 channel 字段（如 feishu、telegram），命令行参数不带引号；不可用 last\n#   \u003CCHAT_ID>      → 当前会话 metadata 中的 chat_id 字段\n\nopenclaw cron add \\\n  --name \"didi-ride-skill:$(date +%s)\" \\\n  --at \"\u003CTIME>\" \\\n  --session isolated \\\n  --message \"执行定时打车：起点「\u003CFROM_NAME>」，终点「\u003CTO_NAME>」，车型「\u003CVEHICLE>」。请完整执行打车流程：地址解析 → 价格预估（获取最新 traceId）→ 创建订单。订单创建成功后，输出订单信息并提示用户可发送「查询订单」了解订单状态，同时创建 5 分钟后自动回查 cron（模板见 SKILL.md 第 3.8 节「发单后自动回查」）。\" \\\n  --announce \\\n  --channel \u003CCHANNEL_NAME> \\\n  --to \"\u003CCHAT_ID>\"\n```\n\n#### 3.7.1 TIME 填写规则\n\n| 场景 | 写法 | 示例 |\n|------|------|------|\n| 相对时间（X 分钟\u002F小时后） | duration 格式 | `15m` \u002F `2h` \u002F `1h30m` |\n| 绝对时间（具体时刻） | 本地时区 ISO 格式 | `$(date -d '明天 09:00' '+%Y-%m-%dT%H:%M:%S+08:00')` |\n\n- 相对时间（如 `15m`）无需格式化，直接使用\n- 绝对时间使用带时区的 ISO 8601 格式：`YYYY-MM-DDTHH:MM:SS+08:00`（北京时间东八区）\n\n**系统兼容性说明：**\n- Linux (GNU date): `date -d '明天 09:00' '+%Y-%m-%dT%H:%M:%S+08:00'`\n- macOS (BSD date): `TZ=Asia\u002FShanghai date -j -v+1d -f '%H:%M' '09:00' '+%Y-%m-%dT%H:%M:%S+08:00'`\n\n### 3.8 发单后自动回查\n\n发单成功后（实时单或预约单），根据本章节下文 \"openclaw cron add\" 命令，创建 cron 任务，务必按照本章节下文bash命令参数设置。\n- 如果无法获取当前会话的 metadata（channel\u002Fchat_id），**仅跳过 cron 创建步骤**，主流程正常完成（已出单则告知用户\"5 分钟后可发送'查询订单'了解最新状态\"）。\n- 如果定时任务创建失败（命令本身报错），必须在回复中提示用户，不能默默失败。\n\n```bash\n# ⚠️ 占位符替换规则：所有 \u003CXXX> 形式都是占位符，必须替换为真实值，禁止保留 \u003C> 字面或加 $ 当 shell 变量。\n#   \u003CORDER_ID>     → 实际订单号（taxi_create_order 返回）\n#   \u003CCHANNEL_NAME> \u002F \u003CCHAT_ID> → 同 §3.7，从会话 metadata 读取或用兜底值\n\nopenclaw cron add \\\n  --name \"didi-ride-skill:check:\u003CORDER_ID>\" \\\n  --at \"5m\" \\\n  --session isolated \\\n  --message \"查询滴滴订单状态：订单号 \u003CORDER_ID>。调用 taxi_query_order 查询并输出当前状态。如果司机已接单，输出司机姓名、车型、车牌、电话及预计到达时间；如果仍在匹配中，提示用户耐心等待。\" \\\n  --announce \\\n  --channel \u003CCHANNEL_NAME> \\\n  --to \"\u003CCHAT_ID>\"\n```\n\n### 3.9 MCP KEY 与配置\n\n> **术语说明**：滴滴平台称此凭证为「MCP KEY」，OpenClaw 配置字段统一叫 `apiKey`，注入后的环境变量为 `DIDI_MCP_KEY`——三者是同一个值。通过 `openclaw config set` 持久化后，OpenClaw 在每次 agent run 启动时自动注入为环境变量。\n\n#### 3.9.1 检查 Key 状态\n\n```bash\n# 仅用于判断 DIDI_MCP_KEY 是否已配置；输出不是 Key 值，不可代入 URL\nopenclaw config get skills.entries.didi-ride-skill.apiKey\n```\n结果输出为空 = 未配置；输出 `__OPENCLAW_REDACTED__` = 已配置，**必须用**环境变量 `$DIDI_MCP_KEY` 拼接 URL。\n\n⚠️ `openclaw config get`（含 `--raw`）永远不返回真实 Key——任何把哨兵值拼入 URL\u002Fheader\u002F参数的请求都会失败，见 error_handling.md「SSE error \u002F apiKey 占位符泄漏」。\n\n#### 3.9.2 持久化用户 Key\n\n⚠️ 当用户回复了 Key（如\"我的 Key 是 xxxxxx\"），**必须**执行以下命令持久化 & 在当前 Shell 生效：\n\n```bash\n#   YOUR_KEY → 实际的 MCP KEY\nopenclaw config set 'skills.entries.didi-ride-skill.apiKey' 'YOUR_KEY'\nexport DIDI_MCP_KEY='YOUR_KEY'\n```\n\n- 持久化后 OpenClaw 在所有后续 agent run（含 cron isolated session）中自动注入 `DIDI_MCP_KEY`\n- ⚠️⚠️⚠️ 命令输出 `\"Restart the gateway to apply.\"` ——**这是通用提示，必须忽略，禁止执行 restart**。`apiKey` 每次 agent run 动态读取，无需重启；强制重启会导致网关崩溃\n\n#### 3.9.3 Key 缺失或鉴权失败\n\n⚠️ Key 未配置**或** MCP 返回鉴权失败（`error.code: -32002`）时，依次执行：\n\n1. 发送二维码图片（`{CHAT_ID}` → metadata 的 chat_id，`{CHANNEL_NAME}` → metadata 的 channel）：\n\n```bash\nopenclaw message send --channel {CHANNEL_NAME} --target {CHAT_ID} --media \"https:\u002F\u002Fs3-yspu-cdn.didistatic.com\u002Fmcp-web\u002Fqrcode\u002Fdidi_ride_skill_qrcode.png\" --message \"滴滴出行APP扫码获取MCP Key，解锁一键打车\"\n```\n\n2. 输出文字：\n\n> 您还没有配置 DIDI_MCP_KEY 或 Key 已失效，请访问 [滴滴MCP平台](https:\u002F\u002Fmcp.didichuxing.com\u002Fclaw) 获取 MCP KEY，然后配置环境变量或在 OpenClaw 配置文件中设置。\n\n### 3.10 工具清单\n\n| 领域 | 工具 |\n|------|------|\n| 地图 | `maps_textsearch`, `maps_regeocode` |\n| 路线 | `maps_direction_driving`, `maps_direction_transit`, `maps_direction_walking`, `maps_direction_bicycling` |\n| 周边 | `maps_place_around` |\n| 打车 | `taxi_estimate`（预估）, `taxi_create_order`（下单）, `taxi_query_order`（查单+司机位置）, `taxi_cancel_order`（取消） |\n",{"name":5,"homepage":25,"metadata":26,"description":7},"https:\u002F\u002Fmcp.didichuxing.com",{"openclaw":27},{"emoji":28,"always":29,"install":30,"requires":36,"primaryEnv":38},"🚕",true,[31],{"id":32,"bins":33,"kind":32,"label":35,"package":34},"node",[34],"mcporter","Install mcporter (node)",{"env":37,"bins":39},[38],"DIDI_MCP_KEY",[40,34],"openclaw","main","b08d387cde83fdd23ca4a75f0a74173f810967ec","resources\u002Fecosystem\u002Fupstream\u002Fdidi-ride-skill-official\u002Feaaaf96d4e60","https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent","https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O","https:\u002F\u002Fjane-zz.me\u002F","金张政 Jane-zz | Agent Engineer · AI Native Builder | Runtime · Context · Evals · GraphRAG | 官方作品集 jane-zz.me","2026-10-04 16:27:52",{"source":8,"skillName":5,"commands":50,"prompt":60,"zipAvailable":29},[51,54,57],{"tool":52,"command":53},"npx","npx skills add Jane-o-O-o-O\u002Fpersonal-agent --skill didi-ride-skill",{"tool":55,"command":56},"bunx","bunx skills add Jane-o-O-o-O\u002Fpersonal-agent --skill didi-ride-skill",{"tool":58,"command":59},"pnpm","pnpm dlx skills add Jane-o-O-o-O\u002Fpersonal-agent --skill didi-ride-skill","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent\u002Fblob\u002Fmain\u002Fresources\u002Fecosystem\u002Fupstream\u002Fdidi-ride-skill-official\u002Feaaaf96d4e60\u002FSKILL.md",[62,68,72,78,82,86,90,94,98],{"path":63,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":66,"sourceHtmlUrl":67},"assets\u002FPREFERENCE.md","ASSET","资产文件",3155,"https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent\u002Fblob\u002Fmain\u002Fresources\u002Fecosystem\u002Fupstream\u002Fdidi-ride-skill-official\u002Feaaaf96d4e60\u002Fassets\u002FPREFERENCE.md",{"path":69,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":71,"sourceHtmlUrl":16},"LICENSE","许可证",1061,{"path":73,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":76,"sourceHtmlUrl":77},"package.json","REFERENCE","参考文档",323,"https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent\u002Fblob\u002Fmain\u002Fresources\u002Fecosystem\u002Fupstream\u002Fdidi-ride-skill-official\u002Feaaaf96d4e60\u002Fpackage.json",{"path":79,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":80,"sourceHtmlUrl":81},"README.en.md",12904,"https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent\u002Fblob\u002Fmain\u002Fresources\u002Fecosystem\u002Fupstream\u002Fdidi-ride-skill-official\u002Feaaaf96d4e60\u002FREADME.en.md",{"path":83,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":84,"sourceHtmlUrl":85},"README.md",12670,"https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent\u002Fblob\u002Fmain\u002Fresources\u002Fecosystem\u002Fupstream\u002Fdidi-ride-skill-official\u002Feaaaf96d4e60\u002FREADME.md",{"path":87,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":88,"sourceHtmlUrl":89},"references\u002Fapi_references.md",8174,"https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent\u002Fblob\u002Fmain\u002Fresources\u002Fecosystem\u002Fupstream\u002Fdidi-ride-skill-official\u002Feaaaf96d4e60\u002Freferences\u002Fapi_references.md",{"path":91,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":92,"sourceHtmlUrl":93},"references\u002Ferror_handling.md",9901,"https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent\u002Fblob\u002Fmain\u002Fresources\u002Fecosystem\u002Fupstream\u002Fdidi-ride-skill-official\u002Feaaaf96d4e60\u002Freferences\u002Ferror_handling.md",{"path":95,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":96,"sourceHtmlUrl":97},"references\u002Fsetup.md",2478,"https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent\u002Fblob\u002Fmain\u002Fresources\u002Fecosystem\u002Fupstream\u002Fdidi-ride-skill-official\u002Feaaaf96d4e60\u002Freferences\u002Fsetup.md",{"path":99,"resourceType":74,"resourceTypeDesc":75,"sizeBytes":100,"sourceHtmlUrl":101},"references\u002Fworkflow.md",6533,"https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent\u002Fblob\u002Fmain\u002Fresources\u002Fecosystem\u002Fupstream\u002Fdidi-ride-skill-official\u002Feaaaf96d4e60\u002Freferences\u002Fworkflow.md",[103,110,117,124,131,138],{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":20},"01M7EA3ZT5SZYH1DMJ9XHGK0JK","style-extract","Analyze Yuque documents to extract vocabulary, sentence, and tone patterns into a reusable writing-style profile. Use when the user wants to understand or reproduce their voice or keep documents consistent; trigger phrases include “分析一下我的写作风格”, “用我的风格写一篇...”, “帮我生成一个风格画像”, “extract my writing style”, and “write like me”.","https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent\u002Fblob\u002Fmain\u002Fresources\u002Fecosystem\u002Fupstream\u002Fyuque-skills\u002F2959228ad3e8\u002Fskills\u002Fstyle-extract\u002FSKILL.md",[],[],{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":114,"categories":115,"keywords":116,"publishedAt":20},"01M7EA3TK8GT3V1E166QX3B0G0","stale-detector","Scan a Yuque knowledge base for stale or outdated documents and recommend updates or archiving. Use when the user is cleaning up, maintaining, or periodically reviewing a knowledge base; trigger phrases include “帮我检查哪些文档过期了”, “知识库体检”, and “find stale docs”.","https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent\u002Fblob\u002Fmain\u002Fresources\u002Fecosystem\u002Fupstream\u002Fyuque-skills\u002F2959228ad3e8\u002Fskills\u002Fstale-detector\u002FSKILL.md",[],[],{"skillNo":118,"name":119,"nameZh":6,"description":120,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":121,"categories":122,"keywords":123,"publishedAt":20},"01M7EA3PEWR596VVPAN0XW3ZFR","smart-summary","Summarize a Yuque document or knowledge base at one-line, key-point, or detailed granularity. Use when the user wants a quick overview of a document or repo; trigger phrases include “帮我总结一下这篇文档”, “这个知识库讲了什么”, and “summarize this doc”.","https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent\u002Fblob\u002Fmain\u002Fresources\u002Fecosystem\u002Fupstream\u002Fyuque-skills\u002F2959228ad3e8\u002Fskills\u002Fsmart-summary\u002FSKILL.md",[],[],{"skillNo":125,"name":126,"nameZh":6,"description":127,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":128,"categories":129,"keywords":130,"publishedAt":20},"01M7EA3JCBX7BVSSF0TEZXDJ47","smart-search","Search personal Yuque knowledge bases with natural-language queries and synthesize answers with source links. Use when the user wants to find information in their own documents; trigger phrases include “搜一下我的文档”, “我的知识库里有没有...”, “搜索我的语雀\u002F知识库”, and “search my Yuque”.","https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent\u002Fblob\u002Fmain\u002Fresources\u002Fecosystem\u002Fupstream\u002Fyuque-skills\u002F2959228ad3e8\u002Fskills\u002Fsmart-search\u002FSKILL.md",[],[],{"skillNo":132,"name":133,"nameZh":6,"description":134,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":135,"categories":136,"keywords":137,"publishedAt":20},"01M7EA3DDETPJYVCDHAXFBRRG6","reading-digest","Extract core insights, golden quotes, and action items from articles, then create structured Yuque reading notes. Use when the user wants key takeaways or a personal reading-notes base; trigger phrases include “帮我做阅读笔记”, “读书笔记”, and “extract key points from this article”.","https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent\u002Fblob\u002Fmain\u002Fresources\u002Fecosystem\u002Fupstream\u002Fyuque-skills\u002F2959228ad3e8\u002Fskills\u002Freading-digest\u002FSKILL.md",[],[],{"skillNo":139,"name":140,"nameZh":6,"description":141,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":142,"categories":143,"keywords":144,"publishedAt":20},"01M7EA37RF6AY0KCX9KQC1Q2YY","note-refine","Polish rough Yuque notes into structured, readable documents while preserving their meaning. Use when the user wants to clean up a draft, improve layout, or turn fragments into a document; trigger phrases include “帮我整理一下这篇笔记”, “把这个文档排版优化一下”, and “polish my notes”.","https:\u002F\u002Fgithub.com\u002FJane-o-O-o-O\u002Fpersonal-agent\u002Fblob\u002Fmain\u002Fresources\u002Fecosystem\u002Fupstream\u002Fyuque-skills\u002F2959228ad3e8\u002Fskills\u002Fnote-refine\u002FSKILL.md",[],[]]