# 腾讯出行服务 — 打车技能
# 一、概述
AI 助手通过 Skill 学习新技能，OpenClaw 安装不同 Skill 即可获得专业能力，在对话中自动识别用户意图并调用对应 Skill。
腾讯出行服务 Skill（tencent-ride-skill） 是一款基于腾讯出行服务平台的打车技能，支持在 AI 对话中完成叫车、询价、查单、取消订单、查看司机位置等全流程操作，无需切换应用，一句话即可出行。
# 1.1Skill 一览
| Skill 名称 | 定位 | 核心能力 | 下载地址 |
|---|---|---|---|
| tencent-ride-skill | 一站式打车服务 | POI 地址搜索、推荐上下车点、多车型询价比价、快捷叫车、订单管理、司机位置追踪 | 点击下载 (opens new window) |
# 1.2核心特性
| 特性 | 说明 |
|---|---|
| 🗺️ 智能地址搜索 | 基于 POI 检索 + 推荐上下车点，精准定位上车/下车位置 |
| 💰 多车型询价 | 同时获取快车、舒适型、商务型、豪华型、出租车等多种车型价格 |
| ⚡ 快捷叫车 | "回家""去公司"等场景词一键叫车，记忆常用地址与偏好 |
| 📋 全流程订单管理 | 查询订单状态、取消订单、查看司机实时位置 |
| 🎯 偏好识别 | 自动理解"30 元以内""舒服一点的""想要电车"等偏好表达 |
# 二、基础能力介绍
# 2.1 地址搜索与推荐
Skill 集成腾讯位置服务 POI 检索能力，并提供智能推荐上下车点：
| 能力 | 说明 |
|---|---|
| 关键词搜索 | 输入地名/地址/楼宇名，返回匹配的 POI 列表 |
| 城市限定 | 支持按城市筛选结果，默认使用常住城市 |
| 推荐上车点 | 基于 POI 坐标推荐最近的上车点（如楼宇内部上车点、东大门等） |
| 推荐下车点 | 基于 POI 坐标推荐最佳下车点（如航站楼出入口、小区门等） |
| 分页查询 | 支持翻页浏览更多搜索结果 |
示例交互：
用户：从武汉腾讯研发中心打车去南车花园 3 号门
AI → 搜索"腾讯武汉研发中心" → 返回候选列表：
📍 1. 腾讯武汉研发中心: 湖北省武汉市江夏区羊子山街1号
🅿️ 腾讯武汉研发中心-内部上车点
📍 2. 腾讯武汉研发中心-1号楼: 湖北省武汉市江夏区腾讯大道1号腾讯武汉研发中心
🅿️ 腾讯武汉研发中心-内部上车点
📍 3. 中百罗森(腾讯大厦店): 湖北省武汉市江夏区羊子山街腾讯武汉研发中心
🅿️ 腾讯武汉研发中心-内部上车点
地址搜索示例图：
# 2.2 打车询价
基于起终点进行打车价格预估，支持多种车型同时比价：
| 信息项 | 说明 |
|---|---|
| 预估里程 | 起终点间的距离（米） |
| 预估时长 | 预计行程时间（秒） |
| 车型列表 | 经济型 / 舒适型 / 商务型 / 豪华型 / 出租车 |
| 运力商 | 万顺叫车、阳光出行、T3出行、滴滴出行、首汽约车、曹操出行等 |
| 预估价格 | 每种车型的预估费用（分） |
| 优惠信息 | 优惠券减免金额、折扣力度 |
询价结果示例：
📋 行程预估
- 预估里程：6.6 公里
- 预估时长：12 分钟
🚗 可选车型
| 序号 | 车型 | 运力商 | 预估价格 | 优惠 |
|------|------|--------|----------|------|
| 1 | 实惠之选·快速便捷 | 万顺叫车 | ¥12.00 | 减¥3.00 |
| 2 | 舒适之选·宽敞舒适 | 滴滴出行 | ¥12.88 | 减¥3.00 |
| 3 | 商务之选·宽敞空间 | 阳光出行 | ¥18.04 | 减¥3.00 |
询价结果示例图：
# 2.3 快捷叫车
支持场景词触发固定路线叫车，自动记忆常用地址和偏好：
| 场景词 | 归一化场景 | 说明 |
|---|---|---|
| 回家、回去、回住处 | 回家 | 从当前位置 → 家 |
| 去公司、上班、去单位 | 去公司 | 从当前位置 → 公司 |
| 接孩子、去接娃、接小孩 | 接孩子 | 从当前位置 → 孩子学校 |
快捷叫车流程：
用户说"回家"
↓
场景归一化为「回家」
↓
查找快捷场景记录 → 命中？
├─ 否 → 引导设置快捷场景（搜索地址 → 保存偏好）
└─ 是 → 读取起终点 + 偏好车型
↓
自动询价 + 下单（无需二次确认车型）
# 2.4 订单管理
提供完整的订单生命周期管理：
| 功能 | 说明 | 命令示例 |
|---|---|---|
| 查询订单 | 查看当前订单状态、司机车辆信息、预估费用 | "帮我查下订单" / "订单到哪一步了" |
| 取消订单 | 取消进行中的订单，支持取消费确认 | "帮我取消当前订单" / "不坐了，取消吧" |
| 查看司机位置 | 实时查询司机位置、预计到达时间 | "司机到哪了" / "看下司机位置" |
订单状态流转：
| 状态 | 说明 |
|---|---|
| 正在派单 | 系统正在分配司机 |
| 等待接驾 | 司机已接单，正在前往 |
| 司机已到达 | 司机已到达上车点 |
| 行程中 | 正在前往目的地 |
| 行程结束 | 到达目的地，等待支付 |
| 已完成 | 订单已完成 |
# 2.5 偏好智能识别
Skill 能自动从用户的自然语言中提取打车偏好：
| 偏好类型 | 示例 | 处理阶段 |
|---|---|---|
| 💰 价格偏好 | "30 元以内""便宜点的" | 询价阶段筛选车型 |
| 🚗 车型偏好 | "舒服一点的""后排宽敞的" | 询价阶段筛选车型 |
| 👥 座位偏好 | "我们有 5 个人" | 询价阶段筛选车型 |
| ⏱️ 接驾速度 | "快点来""尽快" | 下单阶段参数 |
| 🔋 能源偏好 | "想要电车""油车" | 下单阶段参数 |
# 三、场景演示
# 场景一：标准叫车
用户：从亚洲金融大厦打车去深圳北站
完整流程：
1️⃣ 确定上车点
用户：从亚洲金融大厦打车去深圳北站
AI：搜索"亚洲金融大厦" → 返回候选列表 → 用户选择
2️⃣ 确定下车点
AI：搜索"深圳北站" → 返回候选下车点（含各出站口） → 用户选择
3️⃣ 询价与车型确认
AI：展示预估里程/时长 + 多车型价格表
用户：确认叫车 / 选择特定序号
4️⃣ 下单
AI：创建订单 → 返回订单号 + 预估信息
# 场景二：快捷叫车
用户：我下班了，帮我回家
完整流程：
1️⃣ 场景识别
AI：归一化为「回家」场景 → 查找快捷场景记录
2️⃣ 首次使用（未设置快捷场景）
AI：引导设置 → 搜索"家"的地址 → 保存地址别名 + 快捷场景
3️⃣ 再次使用（已有快捷场景）
AI：自动读取起终点 → 静默询价 → 直接下单
🧾 订单号：1123380121037004934
📍 腾讯武汉研发中心 → 南车花园(3号门)
🚗 车型：实惠之选·快速便捷
# 场景三：订单查询与取消
用户：帮我查下订单 → 司机到哪了 → 不坐了，取消吧
完整流程：
1️⃣ 用户表达订单相关诉求（查询订单状态/进度/详情等）
AI：进入订单查询流程
2️⃣ 查询司机位置（司机到哪了/司机位置/司机在哪/还有多远等）
AI：进入司机位置查询流程
3️⃣ 用户表达取消订单诉求（取消/不做了/取消订单/乘车计划取消等）
AI：进去取消订单流程
# 四、安全与鉴权
# 4.1 Token 获取
Skill 通过用户 Token 进行身份鉴权，Token 从腾讯出行服务微信小程序获取：
获取路径
方法一：微信 → 我 → 服务 → 出行服务 → 我的 → 头像/昵称 → Token 信息
方法二：扫描二维码获取
# 4.2 Token 管理
| 操作 | 命令 |
|---|---|
| 保存 Token | python3 ./scripts/tms_takecar.py save-token |
| 清除 Token | python3 ./scripts/tms_takecar.py delete-token |
| 环境检查 | python3 ./scripts/tms_takecar.py preflight |
鉴权错误处理
| 错误码 | 说明 | 处理方式 |
|---|---|---|
errCode = 10 | Token 无效 | 引导用户重新获取 Token |
errCode = 35 | Token 过期 | 引导用户重新获取 Token |
# 五、暂不支持的功能
以下功能需引导用户前往腾讯出行服务小程序操作：
| 功能 | 说明 |
|---|---|
| 联系司机 / 催促司机 | 需通过小程序拨打电话 |
| 代叫车 | 需通过小程序操作 |
| 接送机 | 需通过小程序操作 |
| 开发票 | 需通过小程序操作 |
| 拼车 / 顺风车 / 自动驾驶 | 当前 Skill 不支持 |
# 六、安装教程
# 前置要求
| 项目 | 要求 |
|---|---|
| Python | >= 3.6 |
| Token | 腾讯出行服务用户 Token（微信扫码获取）参考 四、安全与鉴权 - token 获取 |
| 常住城市 | 首次使用时配置（如"武汉市"） |
# 方式 A：WorkBuddy 技能市场安装
第一步：打开 WorkBuddy → 点击左侧边栏 → 「技能」
第二步：搜索「腾讯出行服务」- 点击「+」安装
第三步：点击左侧边栏 → 点击「新建任务」→ 输入「我要打车」
第四步：根据提示通过「扫描二维码」或自行前往「腾讯出行服务小程序」申领 token
小程序 token 获取示例：
第五步：将「 token」（注意严格保密） 及「常驻城市」发送给 AI
完成配置：
1. 打开 WorkBuddy
2. 左侧边栏 → 「专家」→「技能中心」
3. 搜索 "打车" 或 "tms-takecar"
4. 点击安装
5. 配置 Token（首次使用时自动引导）
# 方式 B：OpenClaw 安装
前置准备
确认你已安装 OpenClaw,然后安装 ClawHub CLI:
npm install -g clawhub
验证安装:
clawhub --version
第一步: 在 ClawHub 上找到 Skill
访问 Skill 页面查看详情:https://clawhub.ai/tencent-adm/tencen-ride-skill (opens new window)
第二步: 安装 Skill
在终端中运行:
clawhub install tencent-ride-skill
安装完成后,Skill 文件会出现在你的 OpenClaw workspace 的 skills/ 目录下。
备注: 由于近期 Clawhub 使用人数过多和国内网络限制,建议可以直接下载skill并放置在 workspace/skill 目录下面。
第三步: 验证安装
查看已安装的 Skill 列表:
clawhub list
你应该能看到 Skill 出现在列表中。
第四步: 注册配置Key
请按以下方法申请:
方法一：微信 → 我 → 服务 → 出行服务 → 我的 → 头像/昵称 → Token 信息
方法二：扫描二维码获取
最后将生成的 Key 保存到 openclaw skill 配置中。
第五步: 开始使用
直接在 OpenClaw 对话中使用这个 Skill 的能力,例如:
“我要从北京故宫打车去北京火车站”
OpenClaw 会自动识别并调用对应的 Skill,按SKILL.md (opens new window)中的指引为你生成代码或执行操作。
# 更新 Skill
未来如果 Skill 有新版本,运行:
clawhub update
更新全部已安装的 Skill:
clawhub update --all
# 卸载 / 管理
目前通过删除 skills// 目录即可移除该 Skill。
首次使用引导
安装后首次使用，Skill 会自动检查环境并引导配置：
1️⃣ 环境检查 → preflight
2️⃣ 配置 Token → 扫码获取 → save-token
3️⃣ 配置常住城市 → set-resident-city 武汉市
4️⃣ 再次检查 → preflight → 环境就绪 ✅
# 七、Skill 文件结构
tms-takecar/
├── SKILL.md # Skill 主文档（元数据 + 核心约束 + 流程选择器）
├── LICENSE.txt # 开源协议
├── scripts/
│ ├── tms_takecar.py # CLI 入口脚本（21 个子命令）
│ └── tms_takecar_api.py # API 请求封装
└── references/
├── api-contract.md # 接口契约（所有子命令的参数与返回定义）
├── quick-start-workflow.md # Quick Start 流程
├── takecar-workflow.md # 打车主流程（4 步）
├── short-cut-workflow.md # 快捷叫车流程
├── short-cut-setup-workflow.md # 快捷场景设置流程
├── short-cut-schema.md # 快捷场景数据结构
├── addr-schema.md # 常用地址数据结构
├── state-schema.md # 会话状态数据结构
├── order-workflow.md # 订单管理流程
└── error_handling.md # 异常处理流程