技能介绍

要解决什么问题

销售与运营同学经常在 OpenClaw CRM 里查拜访纪要、客户全貌、商机阶段和报价版本，但这些数据分散在多个 Controller 接口里，参数还不统一（分页用 pageNum/pageSize，详情只认 id，列表默认还带 startAt/endAt 时间窗）。若让模型「凭记忆」拼 URL，很容易漏 Authorization 或把时间筛得过窄导致空结果。

技能如何工作

本技能与 OpenClaw 侧的 CrmFollowRecordController 及 CRM 子模块文档一一对应：在需要处理 CRM 拜访/跟进记录 时触发，先向用户索取登录后的访问令牌，并以 Authorization 请求 gzzjl.hardyne.com/prod-api。

跟进记录：主列表走 GET /tenant/operLog/data，可按 startDate、endDate 等条件分页筛选。

关联实体查询：其余能力按 https://…/ai/ + 技能名访问（如 crm/customer.md、crm/followRecord.md）。列表类工具默认支持 keyword 及时间范围；带 Detail 后缀的工具仅接受实体主键 id。典型链路包括：

客户：列表、详情（含联系人/商机/报价/订单/项目/跟进嵌套字段）、交互统计、联系人、信用评分
跟进与目标：followRecord、salesTarget 及对应 Detail
商机与竞品：opportunity、competitor 及 Detail
报价与条款：quote、clauseTemplate 等

适用边界与注意点

所有请求依赖有效 Token；未提供时应先问用户，不要猜测。
列表若带 startAt/endAt 查不到预期数据，二次尝试可去掉时间参数做全量模糊搜索（文档中的明确建议）。
SKILL 正文侧重 查询与记录管理 的接口约定；写操作、导入导出若未在当次对话资料中展开，不要假设已覆盖。

截图预览

使用场景

销售周会前，按 `startDate`/`endDate` 从跟进主列表拉拜访记录，核对每条记录的下次行动与客户名称。
客户来电追问报价进度时，用 `keyword` 查报价列表，再带 `id` 打开 `quoteDetail` 看版本、折扣与明细行。
商机评审会上，对单一商机调用 `opportunityDetail`，对照嵌套的联系人、报价单号与竞争对手字段做阶段判断。
复盘某重点客户时，先查 `customerInteractionStats` 看拜访/报价/商机次数，再进 `customerDetail` 串联系人、项目与跟进记录。