ClawHub

众安车险自助投保

API key required
Other

众安车险投保 — 车辆信息 → 报价 → 确认核保 → 支付 → 出单。

Install

openclaw skills install za-car-insurance

众安车险投保skill

服务域名

⚠️ 使用前将全文所有 <gateway域名> 替换为如下取值。

gateway 域名：car.zhongan.com

所有接口（鉴权、报价、核保、出单查询）均走此单一域名，无其他依赖服务。

固定配置（首次使用必填）

⚠️ 占位符护栏：以下字段若为 xx，视为未配置。启动时逐一检查，未配置则立即停止向用户索取真实值，严禁猜测。

  • car_api_key：xx（首次获取后写入，当日有效）
  • 手机号：xx（首次使用后写入）
  • 车主姓名：xx（首次使用后写入）
  • 车主证件号：xx（首次使用后写入）
  • 投保人/被保人：默认与车主相同

支持的能力

能力说明参考文件
验证码登录手机号+验证码获取 car_api_keyauth.md
快速报价一键完成绑车+询价+报价quote.md
方案调整修改险种、保额、不计免赔quote.md
核保+支付自动完成核保并获取支付链接proposal.md
出单查询支付后查询保单号proposal.md

主流程概览

Step 0：检查 car_api_key
    ├─ $CAR_API_KEY 存在 → 继续
    └─ 不存在或过期（401）→ 发验证码 → 用户填验证码 → 获取 car_api_key
    详见 auth.md

Step 1：占位符校验
    检查固定配置中手机号、车主姓名、车主证件号是否已填写
    详见 auth.md

Step 2：快速报价（核心）
    POST <gateway域名>/api/quickInsure/quickQuote
    一键完成绑车+填表+询价+报价
    详见 quote.md

Step 3：用户确认/调整方案
    详见 quote.md

Step 4：核保+获取支付链接
    POST <gateway域名>/api/quickInsure/quickConfirmAndPay
    详见 proposal.md

Step 5：打开支付页面
    Chrome DevTools MCP 打开 zaPayUrl
    详见 proposal.md

Step 6：出单结果查询
    POST <gateway域名>/api/quickInsure/getCreatePolicy
    详见 proposal.md

通用规则

详见 auth.md「通用规则」章节。核心要点：

  1. 静默执行：调用接口时不在对话中打印请求参数、响应原文；仅输出面向用户的结论或下一步提示；出错时只展示简洁的错误描述，不暴露原始报文。
  2. 鉴权：每次请求带 car_api_key: $CAR_API_KEY，401 时重新走验证码流程
  3. 上下文保持：vehicleNo、insureFlowCode、投保人信息对话中缓存
  4. 每次操作实时调接口
  5. 接口传参按文档，禁止猜测字段含义
  6. 错误重试：同一报错每阶段最多 3 次；接口繁忙时直接展示返回的提示文案，不重试
  7. 客服引导：接口报错无法自动恢复、或流程阻塞无法继续时，告知用户可联系专属客服，并询问"是否在浏览器中打开客服链接？"，仅在用户确认后才调用 Chrome DevTools MCP 打开客服页面
  8. 终止性错误：P11002、已投保 立即终止
  9. 用户指定车辆不得替换

用户数据交互汇总

环节用户需提供备注
首次登录手机号 + 验证码获取 car_api_key，写入配置
快速报价（已绑车）车牌号投保地后端自动推断
快速报价（未绑车）车牌号车主信息自动从配置获取
车五项补全VIN/发动机号/注册日期/品牌型号按 missingFiveInfoFields 引导
确认方案回复「确认投保」或调整—
支付无（点击支付链接）浏览器内完成

最少交互路径（已绑车 + 配置已填写）：车牌 → 确认核保 → 支付，共 2 轮对话。

场景索引

Step场景关键接口参考文件
0获取 car_api_keyPOST /api/quickInsure/open/auth/sendCode + verifyCodeauth.md
1占位符校验—auth.md
2快速报价POST /api/quickInsure/quickQuotequote.md
3确认/调整方案—quote.md
4核保+支付POST /api/quickInsure/quickConfirmAndPayproposal.md
5出单查询POST /api/quickInsure/getCreatePolicyproposal.md