核心用法
Odoo ERP Connector 是面向 OpenClaw 平台的 TypeScript 插件，通过 XML-RPC 协议连接 Odoo 17/18/19 实例，将 153+ 个业务模块转化为自然语言可执行的对话指令。用户无需记忆复杂的 ERP 操作界面，只需用日常语言描述需求（如"为 Acme Corp 创建包含 10 个 Widgets 的报价单"），系统即可自动完成客户查找/创建、产品匹配、订单生成及状态确认。
插件采用三层架构：底层 OdooClient 封装 XML-RPC 调用与重试机制；中层按模块划分 12 个 Ops 类（Sales/CRM/Purchase/Inventory/Projects/HR/Fleet/MRP 等）；顶层 SmartActionHandler 实现智能工作流——模糊匹配名称、自动创建缺失依赖、透明反馈操作结果。所有操作支持批量执行，单次调用可完成多记录关联创建。
显著优点
- 自然语言驱动：将 ERP 复杂操作抽象为对话指令，大幅降低使用门槛
- 智能容错机制：大小写不敏感搜索、自动创建缺失客户/产品/项目、无需硬编码 ID
- 全模块覆盖：销售、采购、库存、制造、人力资源、车队、会计、电商等 9 大业务线
- 强类型安全：TypeScript 全栈实现，含完整类型定义与 18 项单元测试
- 企业级健壮性：内置 3 次自动重试、60 秒超时、连接状态检测、分级错误处理
- 版本兼容：同时支持 Odoo 17/18/19，持续跟进官方 API 变更
潜在局限
- 单线程限制：未实现并发请求队列，高频率调用可能产生阻塞
- 搜索深度限制：默认仅返回 100 条记录，复杂报表场景需多次分页
- 模糊匹配风险：按名称首条匹配可能导致多义词误关联（如同名不同客户）
- 字段变更敏感：Odoo 版本升级时模型字段变更需同步更新插件
- 网络依赖重：XML-RPC 长连接对网络稳定性要求高，弱网环境体验下降
适合人群
- 中小企业管理者：需快速查询库存、审批订单、监控项目进度
- 销售/采购团队：移动端即时创建报价单、PO、跟踪客户线索
- 财务人员：语音/文字指令生成发票、追踪逾期账款
- HR 管理员：批量处理员工信息、假期申请、费用报销
- 制造业调度员：通过对话创建 BOM、下达生产指令、查询工单状态
常规风险
- 数据误操作风险：自然语言指令可能存在歧义，建议关键操作（删除、过账）二次确认
- 权限越界风险：需严格配置 Odoo 用户 API 权限，避免对话触发越权操作
- API 密钥泄露：配置文件中
apiKey需加密存储，避免提交至代码仓库 - 业务逻辑冲突：自动创建工作流可能产生脏数据（如重复客户），需定期数据治理
- 版本兼容性：Odoo 大版本升级后需验证插件兼容性，建议沙箱环境先行测试