clawbot通过四种方式实现与crm系统客户信息同步：一、webhook实时推送结构化工单数据；二、直连mysql/postgresql执行数据库写入；三、对接简道云等低代码平台http api；四、基于csv文件的离线同步方案。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
ClawBot 能与 CRM 系统打通并同步客户信息，其核心机制依赖本地化数据路由与事件驱动推送，不经过第三方云中转。以下是实现客户信息同步的具体路径：
一、通过Webhook自动推送客户工单
ClawBot 汉化版内置 Webhook 发送模块，可在识别客户咨询意图后，将结构化数据（含客户企微ID、对话快照、意向等级、时间戳）以 JSON 格式实时推送到 CRM 的接收端点。该方式无需修改 CRM 原有数据库，仅需在 CRM 侧配置一个可公开访问的 HTTP 接口。
1、确认 ClawBot 配置文件中 webhook.url 字段已填写 CRM 接收地址，例如 https://your-crm.com/api/v1/clawbot-ticket。
2、确保 CRM 接口支持 POST 方法，并能正确解析 Content-Type 为 application/json 的请求体。
3、在 ClawBot 的 intent_rules.yaml 中定义触发条件，例如当客户消息包含“怎么买”“立即下单”“价格多少”等关键词时，自动启用 high_intent 标签并激活 Webhook。
4、启动服务后，任意客户在企业微信中发送匹配语句，ClawBot 即向 CRM 接口发起一次带签名验证的推送请求。
二、直连 MySQL/PostgreSQL 同步客户字段
ClawBot 支持原生数据库写入能力，可绕过 API 层，直接将客户信息插入或更新至 CRM 所用的关系型数据库表中。适用于简道云、明道云自建 MySQL 表，或企业自研 CRM 的底层数据表。
1、在 config.yaml 的 database.mysql 区块中配置目标 CRM 数据库连接参数，包括 host、port、username、password 和 database 名称。
2、确保 ClawBot 所用数据库账号具备对目标表的 INSERT ON DUPLICATE KEY UPDATE 权限，且目标表存在唯一键（如 customer_wecom_id）用于冲突识别。
3、编写 SQL 模板文件 insert_customer_ticket.sql，其中使用 {{wecom_id}}、{{intent_level}}、{{raw_text}} 等占位符映射 ClawBot 提取的变量。
4、在业务逻辑中调用 node dist/index.js db --template insert_customer_ticket.sql --context '{"wecom_id":"wm_abc123","intent_level":"high"}' 触发写入。
三、对接低代码平台的 HTTP API 插件
针对使用简道云、明道云、氚云等低代码 CRM 的企业，ClawBot 可通过其开放的 HTTP API 插件机制完成双向同步。此类平台通常提供标准 token 认证和字段 ID 映射机制，适配性高且无需开发后端接口。
1、登录简道云后台，在「应用设置」→「API 管理」中创建一个新的 API Token，并记录 AppId 与 Secret。
2、在 ClawBot 的 wecom/intent_handler.js 中引入简道云 SDK 封装模块，传入上述凭证及目标应用 ID。
3、构造 payload 对象，将 ClawBot 提取的客户企微 ID 映射至简道云客户档案中的「企微用户ID」字段，将意向等级映射至「销售阶段」下拉选项值。
4、调用 sdk.createRecord() 方法提交，返回成功响应即表示客户信息已写入简道云对应数据表。
四、基于文件中转的离线同步方案
在安全合规要求极高的场景（如金融、政务类客户），可禁用网络外联，改用本地文件作为数据交换媒介。ClawBot 定期生成标准化 CSV 文件，CRM 系统定时读取并导入，实现物理隔离下的准实时同步。
1、在 ClawBot 配置中启用 file_export 模块，设定输出路径为 /opt/clawbot/export/tickets/，文件名格式为 ticket_%Y%m%d_%H%M%S.csv。
2、确保每行 CSV 包含固定字段：wecom_id, nickname, intent_level, timestamp, raw_message, summary。
3、CRM 侧部署一个轻量级监听脚本（如 Python + inotify），监控该目录内新增文件，触发解析与数据库批量 INSERT。
4、ClawBot 每生成一个新文件，自动将前序文件移入 /opt/clawbot/archive/ 并压缩归档，防止磁盘溢出。
