核心用法
本技能为OpenClaw与Pipedrive CRM v1 API的桥接工具，提供完整的CRUD操作能力，覆盖persons、organizations、deals、leads、activities、notes、pipelines等核心实体。用户可通过标准化CLI命令直接操作CRM数据，或利用request命令发起任意自定义端点调用，补全官方未封装的API能力。
显著优点
1. 双认证模式灵活：支持API Token（快速部署）与OAuth Access Token（企业级安全）两种鉴权方式
2. 实体覆盖全面：10+核心CRM对象原生支持，从线索捕获到商机成交的全链路可操作
3. 管道自动化：move_deal_stage原生支持阶段推进与状态变更（open/won/lost/deleted），消除手动拖拽依赖
4. 安全设计：内置令牌脱敏规则，禁止在输出中回显敏感凭证；读写分离的确认机制降低误操作风险
5. 扩展逃生舱：request命令提供原始HTTP通道，应对API版本演进或边缘业务场景
潜在缺点与局限性
- v1 API锁定：当前仅支持Pipedrive API v1，若官方逐步弃用需技能迭代
- 无内置限流处理：高频操作可能触发Pipedrive速率限制（100 requests/10s per token），需调用方自行控制并发
- JSON Payload手工构造：创建/更新操作依赖手写JSON，缺乏字段校验或自动补全，易因格式错误导致失败
- 无变更事件监听：单向操作模式，无法替代Webhook实现实时数据同步
适合人群
- 需将Pipedrive集成至自动化工作流的技术销售/RevOps团队
- 已使用OpenClaw生态、希望统一CLI入口管理多SaaS工具的开发者
- 频繁执行批量数据清洗、迁移或报表导出的CRM管理员
常规风险
- 凭证泄露：
PIPEDRIVE_API_TOKEN为长期有效凭证，环境变量配置不当可能导致跨项目暴露 - 数据误删：
delete命令无软删除确认，执行即物理移除；建议配合--limit与search先行验证目标数据 - 阶段状态不一致：
move_deal_stage若指定非法stage_id或冲突的状态组合，可能导致商机数据异常 - API限流中断：未处理429响应的自动化脚本可能中断关键业务流程