Clawhub Package Full

核心用法

Odoo ERP Connector 是面向 OpenClaw 的全功能 Odoo 19 集成工具，允许用户通过自然语言聊天命令自主控制企业资源规划系统。核心架构包含三层：底层 OdooClient 通过 XML-RPC 与 Odoo 通信；中层业务逻辑类（如 SaleOrderOps、InventoryOps、ManufacturingOps）封装各模块操作；顶层 SmartActionHandler 提供自然语言接口，实现模糊匹配与自动创建工作流。

用户可直接用口语化指令执行复杂业务操作，例如「为 Acme Corp 创建报价单，包含 10 个 Widget 单价 $50」，系统自动完成客户查找/创建、产品匹配、报价单生成并返回结构化摘要。支持 153+ Odoo 模块，涵盖销售 CRM、采购、库存、财务、项目、人力资源、车队、制造 MRP、日历、电商等全流程。

显著优点

自然语言驱动：无需记忆 Odoo ID 或复杂字段名，用名称即可完成操作；智能模糊匹配：大小写不敏感的 ilike 搜索，缺失记录自动创建；事务透明：每次操作返回详细摘要，说明哪些记录被创建、哪些被复用；完整业务覆盖：从报价到收款、从采购到入库、从 BOM 到生产工单的全链条支持；灵活配置：支持 config.json 或 .env 环境变量，API Key 认证安全可靠。

潜在缺点与局限性

单线程限制：并发请求需自行队列化处理；搜索上限：默认返回 100 条记录，大数据量需分页；模糊匹配风险：同名记录返回首个匹配项，可能误操作关键数据；Odoo 版本锁定：明确针对 Odoo 19 设计，旧版本兼容性未验证；网络依赖：XML-RPC 调用对延迟敏感，超时默认 60 秒；字段变更风险：Odoo 模型字段升级可能导致映射失效。

适合人群

• 中小企业管理者：快速查询库存、审批订单、监控现金流
• 销售/采购团队：移动场景下语音创建报价、采购单
• 仓库/生产主管：实时库存预警、工单状态追踪
• ERP 实施顾问：快速演示 Odoo 功能、批量初始化数据
• 开发者：基于 SmartAction API 构建上层业务应用

常规风险

数据误操作：自动创建逻辑可能在模糊匹配时关联错误客户或产品，建议关键业务启用人工确认流程；权限扩散：API Key 持有者获得配置用户的全部 Odoo 权限，需严格遵循最小权限原则；审计追踪：虽然 Odoo 本身记录变更日志，但自然语言指令的原始意图需额外保存以便审计回溯；生产环境压力：大量智能操作可能触发 Odoo 速率限制，高并发场景应配置缓存与队列。

核心用法

Odoo ERP Connector 是一款面向 OpenClaw 平台的企业级集成技能，通过 XML-RPC 协议与 Odoo 19 实例建立双向通信通道。用户可通过自然语言对话完成全链路业务操作，无需掌握 Odoo 原生界面或技术细节。核心交互模式分为三层：Smart Actions 智能动作层支持模糊匹配与自动创建，如"为Acme创建报价"系统自动检索或新建客户；Ops API 业务操作层提供模块级精细控制，支持按ID精准操作；Client 基础连接层处理认证、重试与错误恢复。覆盖销售CRM、采购库存、生产制造、项目人力、车队电商等九大业务域，153+官方模块即装即用。

显著优点

自然语言驱动彻底消除ERP学习门槛，非技术人员可秒级完成报价单创建、库存查询、工单派发等复杂操作；智能Find-or-Create机制自动处理依赖关系，创建报价时若客户或产品不存在则自动新建并回显操作摘要；模块化架构支持按需加载，从微型企业到跨国制造集团均可弹性扩展；企业级可靠性内置3次自动重试、60秒超时保护、完整异常分级（OdooAuthError/OdooNotFoundError）；配置灵活支持config.json与.env双模式，Webhook实时事件推送打通业务流程闭环。

潜在局限

单线程架构并发请求需自行队列化，高并发场景可能成为瓶颈；模糊匹配局限仅检索name字段且取首条匹配，多同名记录场景存在误操作风险；字段强耦合依赖Odoo 19精确字段名（如product_tmpl_id），版本升级需同步适配；网络依赖XML-RPC往返延迟敏感，跨地域部署建议配合边缘节点；权限边界继承Odoo原生前端权限体系，无法突破用户级API权限限制。

适合人群

中小企业管理者：希望以对话方式快速获取销售漏斗、库存预警、项目进度；ERP实施顾问：需要快速原型验证或客户演示环境搭建；供应链/采购专员：高频处理询价、比价、到货跟踪等重复操作；远程办公团队：移动端通过IM工具直接操作核心业务流程；Odoo开发者：作为自动化测试、数据迁移、批量运维的脚本工具集。

使用风险

配置泄露风险：config.json存储API密钥，需严格文件权限控制（建议600）并排除版本控制；Webhook暴露风险：默认0.0.0.0绑定可能扩大攻击面，生产环境务必改为127.0.0.1或启用反向代理；数据误操作风险：Smart Actions自动创建依赖记录，批量操作前建议在测试库验证；依赖服务可用性：Odoo服务器故障或网络中断将直接导致技能不可用，关键业务建议配置降级预案；版本锁定风险：当前针对Odoo 19优化，重大版本升级可能存在兼容性断裂。