ClawHub

wxb-assistant

Other

查询旺小宝系统的录音、接访、客户、盘客等数据。当你需要查看客户画像、盘客分析、录音详情时，使用此技能。适用于销售顾问、经理需要快速查询旺小宝数据的场景。当用户提到"录音"、"接访"、"客户画像"、"盘客"、"旺小宝"、"工牌接访"等相关术语时，或需要查询销售分析、客户数据时，应该触发此技能。

Install

openclaw skills install wxb-assistant

旺小宝数据助手

这是一个让AI能够查询旺小宝系统数据的技能。通过扫码授权后，你可以让AI帮你查询录音、客户、盘客等各类数据。

首次使用 - 授权流程

在使用此技能查询数据之前，需要先完成授权：

  1. 发起授权：告诉我你想查询的数据（如"查看客户列表"）
  2. 扫码授权：我会生成一个二维码，你用旺小宝 App 扫描它
  3. 自动完成：App 会自动获取当前登录的 token 并返回
  4. 开始使用：授权完成后，我就可以帮你查询数据了

授权信息会保存在 ~/.wxb-auth-token 文件中，下次使用时无需重新授权。

可以查询的数据

录音查询

  • 录音详情 - 获取单条录音的基础信息
  • 录音文本 - 获取录音的转写文本内容
  • 录音摘要 - 获取录音的AI摘要和问答
  • 录音扩展 - 获取录音的扩展信息
  • 录音评论 - 查看录音的评论列表
  • 录音修改 - 修改录音显示名称
  • 重新分析 - 重新进行语音识别(ASR)

使用示例：

  • "查看录音 xxx 的详情"
  • "查看录音 xxx 的文本内容"
  • "查看录音 xxx 的摘要"
  • "查看录音 xxx 的评论"

客户相关

  • 客户列表 - 查看客户列表，支持多维度筛选
  • 客户详情 - 查看指定客户的详细信息
  • 客户画像 - 查看客户画像预测结果
  • 客户旅程 - 查看客户综合来访跟进轨迹
  • 关注点/抗性点 - 查看客户的关注点和抗性点

使用示例：

  • "显示客户列表"
  • "查看客户 xxx 的画像"
  • "查看客户 xxx 的关注点"
  • "查看客户的来访轨迹"

工牌接访

  • 接访列表 - 查看工牌接访记录列表，支持分页和时间筛选
  • 接访详情 - 查看指定工牌接访的详细信息
  • 客户列表 - 查看工牌客户列表
  • 搜索功能 - 搜索来访、客户、录音
  • 看板数据 - 查看团队数据统计
  • 接待管理 - 开始/结束接待、查询WiFi状态等

使用示例：

  • "显示工牌接访列表"
  • "查看工牌接访详情"
  • "搜索工牌客户"

客户中心

  • 客户管理 - 客户列表、详情、搜索
  • 客户画像 - 查看画像预测结果、重新预测
  • 客户轨迹 - 查看客户综合来访跟进轨迹
  • 关注点/抗性点 - 查看客户的关注点和抗性点
  • 虚拟接访 - 虚拟接访列表、详情、绑定录音等

使用示例：

  • "显示客户中心列表"
  • "查看虚拟接访记录"

盘客分析

  • 盘客列表 - 分页查询盘客记录，支持筛选
  • 盘客详情 - 查看盘客详情（含画像、买点、风控、关注点）
  • 收集表 - 查看/提交/编辑盘客收集表
  • AI辅助回想 - 获取AI辅助回想内容
  • 金句内容 - 根据录音ID查询金句内容
  • 金句认可 - 金句内容认可操作
  • 分析任务 - 创建金句分析任务
  • 销售意向 - 获取/更新销售意向级别
  • 事件查询 - 通过客户ID获取事件ID
  • 评论 - 查看/新增盘客评论

使用示例：

  • "显示盘客列表"
  • "查看盘客详情"
  • "查看盘客画像"
  • "查看盘客金句"

用户与项目

  • 当前用户 - 查看当前登录用户的详细信息
  • 租户项目列表 - 查看当前用户有权限的所有租户和项目
  • 切换项目 - 切换到指定的项目

技术实现

此技能使用以下技术实现：

  1. 授权管理 (scripts/auth-manager.js)

    • 启动本地 HTTP 服务器接收授权回调
    • 生成授权二维码
    • 管理 token 的存储和验证

  2. API 客户端 (scripts/api-client.js)

    • 主入口文件，提供统一访问接口
    • 自动处理认证头（X-Auth-Token, X-Platform-Client）
    • 统一的错误处理

  3. 模块化 API (scripts/api/)

    • visit-api.js - 工牌接访相关接口
    • customer-api.js - 客户中心相关接口
    • audio-api.js - 录音查询相关接口
    • panke-api.js - 盘客相关接口
    • other-api.js - 其他功能（今日代办等）

API 端点

技能使用以下旺小宝后端 API：

录音查询

功能方法端点
录音列表POST/ai-voice/app/audio/page
录音详情GET/ai-voice/audio/detail/{audioId}
录音视频GET/ai-voice/audio/video/{audioId}
录音分析GET/ai-voice/app/audio/nlp-result/{audioId}
录音文本搜索POST/ai-voice/app/visit/audio-split-text
编辑录音POST/ai-voice/audio/edit/valid
绑定接访POST/ai-voice/audio/bind-visit
解绑录音POST/ai-voice/visit/unbind-audios
基础信息GET/audio/app/v2/audio/base/{id}
录音文本GET/audio/app/v2/audio/base/text/{id}
录音评论GET/audio/app/v2/audio/commentary/{id}
评论文本GET/audio/app/v2/commentary/text/{audioId}
摘要问答GET/audio/app/v2/audio/agi/summary/dialogue/{id}
录音扩展GET/audio/app/v2/audio/expand/{id}
录音卡片GET/audio/app/v2/audio/base/card/{id}
音频分享POST/audio/app/v2/audio/share

客户中心

功能方法端点
客户列表POST/customer/customer/list
单个客户GET/customer/customer/list/one
搜索客户GET/customer/customer/search
客户详情GET/customer/customer/detail/{wangId}
客户轨迹GET/customer/customer/trajectory
关注点GET/customer/customer/focus/wang/list
抗性点GET/customer/customer/point/wang/list
画像预测GET/customer/predict/can-view
重新预测POST/customer/predict/re-predict/{wangId}

工牌接访

功能方法端点
接访列表POST/ai-voice/app/visit/page
客户列表POST/ai-voice/app/customer/page
接访详情GET/ai-voice/app/visit/{id}
搜索来访GET/ai-voice/app/search/visit/page
搜索客户GET/ai-voice/app/search/customer/page
搜索录音GET/ai-voice/app/search/audio/page
看板来访列表POST/ai-voice/board/visit:page
团队用户统计POST/ai-voice/board/user:stat
团队统计POST/ai-voice/board/team:stat
WiFi状态GET/ai-voice/app/visit/manager/wifi-status
开始接待POST/ai-voice/app/visit/manager/start
结束接访POST/ai-voice/app/visit/manager/end
开始录音GET/ai-voice/app/visit/manager/start-visit-audio
结束录音GET/ai-voice/app/visit/manager/stop-visit-audio

盘客

功能方法端点
盘客列表POST/panke/app/panke/page
盘客进度率POST/panke/app/panke/page/score
盘客筛选条件GET/panke/common/searchCondition
盘客权限GET/panke/permission
盘客详情GET/panke/app/panke/detail
盘客详情V2GET/panke/app/panke/v2/detail
客户中心盘客详情GET/panke/app/panke/wang/v2/detail
盘客画像GET/panke/app/panke/complete-table
盘客画像V2GET/panke/app/panke/v2/complete-table
盘客买点GET/panke/app/panke/customer/selling-point-reach
盘客风控GET/panke/risk/list
盘客关注点GET/panke/focus/list
客户来访信息POST/panke/app/panke/tableCusVisitInfo
收集表GET/panke/app/panke/table
提交收集表POST/panke/app/panke/table
编辑收集表字段POST/panke/app/panke/table/field
收集表校验GET/panke/app/panke/check-table
标记特殊来访POST/panke/app/panke/mark-special-visits
AI辅助回想GET/panke/app/panke/ai-assisted-recall
金句内容POST/panke/panke/new/sop/getGoldenContentByAudioId
金句认可POST/panke/panke/new/sop/goldenContentAccept
创建分析任务POST/panke/panke/sop/createGoldenAnalysisTask
销售意向级别GET/panke/panke/sop/v1/options/salesPitchIntent
更新销售意向POST/panke/panke/sop/v1/options/salesPitchIntent/update
SOP2阶段状态GET/panke/panke/new/sop/two/stage/result/status
SOP2阶段概览GET/panke/panke/new/sop/two/stage/sketch
评论列表GET/panke/comment/list
新增评论POST/panke/comment/add
获取事件IDGET/panke/app/panke/wang/event/detail
获取盘客IDGET/panke/app/panke/get-pankeId-by-visitId

今日代办

功能方法端点
待办统计GET/ai-voice/app/virtually/visit/virtually-today-todo:count
待办列表GET/ai-voice/app/virtually/visit/virtually-today-todo:all
待办详情GET/ai-voice/app/virtually/visit/virtually-today-todo/{id}

用户与项目

功能方法端点
用户信息GET/saas/v2/user/info
租户项目列表GET/saas/v2/estate/tenant-and-estate/by-user-id
切换项目POST/session/switch-project
切换租户POST/session/switch-tenant

注意事项

  1. 授权有效期：授权 token 会持久化保存，直到手动清除
  2. 数据安全：token 存储在本地文件中，权限设为仅用户可读写
  3. 网络要求：需要能够访问 wangkeapp.wangxiaobao.com 和 www.wangxiaobao.com
  4. App 版本：需要旺小宝 App 支持扫码授权功能
  5. 模块化调用：支持传统调用方式和模块化调用方式两种

清除授权

如果需要重新授权或更换账号，可以删除授权文件：

rm ~/.wxb-auth-token

或告诉我"清除授权"，我会帮你处理。

常见问题

Q: 授权失败怎么办？ A: 确保 App 已登录，网络连接正常，重新扫描二维码即可。

Q: Token 过期了怎么办？ A: 删除 ~/.wxb-auth-token 文件，重新进行授权即可。

Q: 如何使用模块化 API？ A: 可以直接调用 api-client.js 中对应的模块，如 visit.getVisitPage()、customer.getCustomerPage() 等。

Q: 可以同时使用多个账号吗？ A: 目前不支持，每次授权会覆盖之前的 token。