OpenClaw CRM Follow Record Skill

This skill allows the AI to manage CRM follow-up records (visit records) in the OpenClaw system. It maps one-to-one with the CrmFollowRecordController.

Prerequisites

Authorization Token: Required for all requests.
- Action: Ask the user for their token if not already provided.
- host: gzzjl.hardyne.com/prod-api
- Header: Authorization: <token> token 为用户登录后获取的访问令牌,可以问客户拿

Actions

1. List Records (Main)

Query the main list of follow-up records with pagination and filters.

URL: /tenant/operLog/data
Method: GET
Parameters:
- startDate: (Query) Start date (e.g., 2026-02-10)
- endDate: (Query) End date (e.g., 2026-02-13)
- Other entity fields as needed

Example:

curl -X GET "https://<host>/tenant/operLog/data?startDate=2026-02-10&endDate=2026-02-13" \
  -H "Authorization: <token>"

3. CRM 核心业务模块工具

3.1 客户管理模块 (Customer)

以下技能访问为 https://<host>/ai/ + skill-name 如: https://<host>/ai/crm/customer.md

1.1 分页查询类工具参数规范

无特殊说明的列表查询类工具，均默认接受格式的参数：

| 字段名 | 类型 | 必填 | 默认值 | 描述 | | :--------- | :-- | :- | :--- | :------------------------------- | | pageNum | 整数 | 否 | 1 | 页码，用于分页 | | pageSize | 整数 | 否 | 10 | 每页显示的数据条数 | | keyword | 字符串 | 否 | 无 | 搜索关键词（公司名称 / 订单编号 / 订单名称 / 商机名称） | | startAt | 字符串 | 否 | 30天前 | 筛选开始时间，格式：yyyy-MM-dd HH:mm:ss | | endAt | 字符串 | 否 | 当前时间 | 筛选结束时间，格式：yyyy-MM-dd HH:mm:ss | Example:

curl -X GET "https://<host>/ai/crm/customer.md?keyword=张三&pageNum=1&pageSize=10&startAt=2026-02-10 00:00:00&endAt=2026-02-13 23:59:59" \
  -H "Authorization: <token>"

调用建议：若带有时间参数查询不到预期数据，建议在二次尝试时移除 startAt 和 endAt 进行全量模糊搜索。

1.2 详情查询类工具参数规范

所有带有 Detail 后缀的详情查询工具，均只接受业务实体的唯一主键参数：

| 字段名 | 类型 | 必填 | 默认值 | 描述 | | :--- | :-- | :---- | :-- | :------------------------ | | id | 长整数 | 是 | 无 | 对应业务实体的唯一 ID（如客户ID、订单ID等） | Example:

curl -X GET "https://<host>/ai/crm/customerDetail.md?id=1" \
  -H "Authorization: <token>"

| 工具名称 | 参数规范 | 功能说明 | 业务场景 | | :-------------------------------- | :----------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------- | | crm/customer.md | 分页查询类 | 查询客户概要信息列表。返回字段: 客户ID、客户名称、客户编码、统一社会信用代码、国家、分管片区、地址、客户行业、主负责人、主负责人姓名、所属部门Id、所属部门名称、创建时间、编辑时间 | 查找目标客户，或根据名称模糊搜索客户基础信息 | | crm/customerDetail.md | 详情查询类 (id) | 获取客户全貌详细信息。返回字段: 客户ID、客户名称、客户编码、统一社会信用代码、客户行业、客户等级、客户状态、审批状态、国家、分管片区、详细地址、主负责人、主负责人姓名、所属部门ID、所属部门名称、跟进天数、下次跟进时间、下次逾期时间、是否逾期、逾期自动进入公海、进入公海时间、审批时间、备注、联系人信息ID、姓名、职务、部门、电话、邮箱、是否主要、对接人ID、角色、商机ID、商机主题、商机编号、预计成交金额、预计成交金额(不含税)、预计成交日期、渠道、完成原因、状态、报价信息ID、报价编号、关联商机ID、报价主题、联系人ID、总金额(含税)、总金额(不含税)、有效期至、订单信息ID、订单编号、订单名称、总金额、订单类型、交付日期、生产进度、项目ID、项目名称、项目编号、项目类型、项目状态、开始时间、结束时间、记录ID、跟进方式、跟进内容、跟进时间、下一步行动、创建人 | 需全面了解某客户的所有关联信息 | | crm/customerInteractionStats.md | 分页查询类 | 查询客户交互统计列表。返回字段: 客户ID、客户编号、客户名称、订单次数、报价次数、跟进拜访次数、商机次数、最后触达时间 | 统计或分析客户最近的拜访、报价、商机等交互频率与热度 | | crm/customerContract.md | 分页查询类 | 查询客户联系人信息列表。返回字段: 联系人ID、客户ID、客户名称、用户ID、部门名称、职位、角色、名称、电话、邮箱、客户类型、在职状态、特征标签、是否主联系人、备注、创建人、创建时间、编辑用户、编辑时间 | 寻找客户对接人、关键决策人信息 | | crm/customerContractDetail.md | 详情查询类 (id) | 获取联系人详细信息。返回字段: 联系人ID、客户ID、客户名称、用户ID、姓名、角色、部门、职务、在职状态、是否主要联系人、联系电话、邮箱、可联系时间段、客户分类、互动频率、性格标签、用户画像、组装的用户画像、拓展信息、备注、偏好主题Key、偏好主题值、偏好主题标签、创建人、创建时间、编辑人、编辑时间 | 查看特定联系人的职务、联系方式及偏好细节 | | crm/customerScore.md | 分页查询类 | 查询客户评价与信用评分列表。返回字段: 评级ID、供应商ID、评估周期开始、评估周期结束、评估得分、评级编号、供应商类型、等级、备注、审批流程ID、审批时间、审批状态、创建人、创建时间、编辑用户、编辑时间 | 筛选高优客户，评估客户的整体信誉水平 | | crm/customerScoreDetail.md | 详情查询类 (id) | 获取客户信用评分详细指标。返回字段: 评级记录ID、供应商ID、供应商名称、审批单号、供应商类型、等级、评估得分、评估周期开始、评估周期结束、审批状态、审批流程ID、审批时间、备注、明细ID、评级单ID、项目名称、权重占比、类型、评分标准参考、评分分数、创建人、创建时间、编辑人、编辑时间 | 查看某个客户具体的信用扣分、加分项明细 |

3.2 销售跟进与目标模块 (Follow-up & Target)

3.3 商机与竞品模块 (Opportunity & Competitor)

| 工具名称 | 参数规范 | 功能说明 | 业务场景 | | :------------------------- | :----------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------- | | crm/opportunity.md | 分页查询类 | 查询潜在销售商机列表。返回字段: 商机ID、商机编号、客户ID、客户名称、渠道、阶段、成功率(%)、优先级、来源、预计成交日期、完成时间、完成类型、完成原因、含税金额、税率(%)、不含税金额、币种、汇率、人民币含税金额、人民币不含税金额、区域、行业、产品线、合同地址、附件地址、备注、变更原因、主版本、子版本、生效版本、负责人、审批任务ID、审批时间、审批人、审批状态、创建人、创建时间、更新人、更新时间、商机主题 | 追踪销售线索，评估各商机的所处阶段及预计金额 | | crm/opportunityDetail.md | 详情查询类 (id) | 获取商机详细信息。返回字段: 商机ID、商机编号、客户ID、客户名称、客户电话、客户地址、客户邮箱、渠道、阶段、成功率(%)、优先级、来源、预计成交日期、完成时间、完成类型、完成原因、含税金额、税率(%)、不含税金额、币种、汇率、人民币含税金额、人民币不含税金额、区域、行业、产品线、合同地址、附件地址、备注、变更原因、主版本、子版本、生效版本、负责人、审批任务ID、审批时间、审批人、审批状态、创建人、创建时间、更新人、更新时间、记录ID、联系人ID、联系人姓名、联系人电话、职务、角色、邮箱、生效版本ID、报价单号、报价主题、交付方式、交付周期、付款方式、有效期、含税总金额、不含税总金额、成本金额、毛利、整单折扣、状态、版本号、竞争对手ID、竞争对手名称、产品名称、产品编码、产品规格、产品单位、团队成员ID、成员昵称、部门编码、部门名称 | 深入分析单一商机关联的产品、团队、对手及报价历史 | | crm/competitor.md | 分页查询类 | 查询市场竞争对手信息列表。返回字段: 竞品ID、竞品编号、统一社会信用代码类型、统一社会信用代码、所属行业、所在区域、公司规模、官网、风险等级、主联系人ID、主版本、子版本、生效版本、创建人、创建时间、编辑人、编辑时间、审批流程ID、审批时间、审批人、审批状态、竞品公司 | 收集市场情报，监控主要竞争对手动态 | | crm/competitorDetail.md | 详情查询类 (id) | 获取竞争对手详细分析。返回字段: 竞品ID、竞品编码、公司名称、统一社会信用类型、统一社会信用代码、行业、区域、规模、官网、风险等级、备注、主联系人ID、主版本、子版本、生效版本、审批任务ID、审批时间、审批人、审批状态、创建人、创建时间、更新人、更新时间、产品信息ID、产品线、规格型号、功能特性、适配场景、计价方式、标准价、服务条款、优势点、劣势点、替代方案、情报信息ID、来源、主题、内容摘要、可信度评分、采集日期、影响范围、有效期、证据附件、联系人信息ID、姓名、职位、部门、手机号码、邮箱、影响力角色、关系说明、是否关键人 | 查看特定对手的产品优劣势、市占率及我方应对策略 |

3.4 报价与条款模板模块 (Quote & Clause)

| 工具名称 | 参数规范 | 功能说明 | 业务场景 | | :---------------------------- | :----------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------- | | crm/quote.md | 分页查询类 | 查询报价单信息列表。返回字段: 报价版本id、报价编号、商机id、客户id、客户名称、联系人id、联系人姓名、币种、汇率、税率、交付方式、交付周期、付款方式id、有效期、总价含税、不含税总金额、成本、毛利、整单折扣、创建人、创建时间、编辑用户、编辑时间、状态、审批流程id、审批时间、审批人、审批人姓名、版本号、报价主题 | 搜索历史发给客户的报价记录，对比报价版本 | | crm/quoteDetail.md | 详情查询类 (id) | 获取报价单详细信息。返回字段: 报价主题、报价版本id、报价编号、商机id、客户id、客户名称、联系人id、联系人姓名、币种、汇率、税率、交付方式、交付周期、付款方式id、有效期、总价含税、不含税总金额、成本、毛利、整单折扣、创建人、创建时间、编辑用户、编辑时间、状态、审批流程id、审批时间、审批人、审批人姓名、版本号、是否删除、明细ID、产品ID、规格、数量、单位、单价、折扣、税额、小计、不含税金额、成本金额、交付批次、条款ID、条款标题、条款内容、条款版本、排序、生效日期、失效日期、是否非常规条款、费用ID、费用名称、费用类型、费用金额、BOM ID、是否打印 | 查阅特定报价单的折扣力度、包含产品明细及总金额 | | crm/clauseTemplate.md | 分页查询类 | 查询合同条款和审批流模板列表。返回字段: 条款模版id、名称、内容、状态、版本号、UUID、编辑用户、编辑时间、条款模版名称 | 草拟合同时检索适用的标准条款或审批流程 | | crm/clauseTemplateDetail.md | 详情查询类 (id) | 获取条款模板具体内容。返回字段: 记录ID、唯一ID (UUID)、名称、状态、版本号、是否删除、条款内容、创建人、创建时间、编辑人、编辑时间 | 查看某个合同模板的细则条款与合规要求 |

3.5 订单、发货与回款模块 (Order, Outbound & Refund)

| 工具名称 | 参数规范 | 功能说明 | 业务场景 | | :--------------------------- | :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------- | | crm/order.md | 分页查询类 | 查询销售订单信息列表。返回字段: 订单ID、订单编码、订单名称、客户订单号、签单日期、预期交付日期、实际交付日期、客户名称、客户编号、负责人名称、紧急程度、部门名称、订单数量、成本金额、含税订单金额、不含税订单金额、毛利率、状态、排产状态、审批状态、收货地址、客户联系人、创建时间、编辑时间、销售出库记录数 | 检索成单记录，统计特定条件下的订单总额 | | crm/orderDetail.md | 详情查询类 (id) | 获取订单详细信息。返回字段: 订单ID、订单编码、订单名称、客户订单号、签单日期、预期交付日期、实际交付日期、客户名称、客户编号、负责人名称、紧急程度、状态、排产状态、审批状态、收货地址、客户联系人、创建时间、编辑时间、销售出库记录数、客户ID、关联ID、产品编号、产品名称、规格型号、订单数量、产品单位、销售价、成本价、单价、折扣、税率、含税金额、不含税金额、已发货数量、计划下发数量、计划委外数量、款项明细、回款金额、回款日期、回款方式、审批ID、拓展信息、附件、备注、计划回款金额、计划回款日期、是否发送、费用名称、费用类型、费用金额、模板ID、条款标题、条款内容、排序顺序、版本、生效日期、失效日期、是否非标、发货单号、销售交期、发货数量、实际数量、库位名称、出库单号、物流单号、运输公司、车牌、司机联系人、司机电话、创建人、指定发货时间、实际到货时间 | 查看具体订单的商品清单、成交金额及订单状态 | | crm/orderOutbound.md | 分页查询类 | 查询订单出库和发货状态列表。返回字段: ID、订单编号、客户名称、销售交期、产品名称、发货数量、实发数量、库位名称、收货地址、审批状态、发货单号 | 跟踪货物出仓进度与整体物流状态 | | crm/orderOutboundDetail.md | 详情查询类 (id) | 获取详细出库和物流信息。返回字段: 发货单ID、订单ID、出库单号、客户名称、状态、是否质检、审批状态、创建人、创建时间、更新时间、联系人姓名、联系人电话、收货地址、物流单号、运输公司、车牌、货运司机联系人、司机联系电话、指定发货时间、指定到货时间、实际发货时间、实际到货时间、明细ID、产品ID、发货数量、销售数量、运装数量、仓库地址、库位、批次、备注 | 确认某笔发货单的具体承运方、单号及实时物流进展 | | crm/orderRefundList.md | 分页查询类 | 查询回款记录报表。返回字段: 销售订单、客户名称、签单日期、实收金额、实收日期、回款方式、状态、备注 | 财务或销售核对账单的实际回款金额与支付状态 |

3.6 数据统计报表模块 (Report)

本模块用于宏观数据分析与聚合展示。

3.7 系统管理模块 (System)