\n\n| 🏫 教学机构 | 👨🏫 讲师 | 📧 联系方式 | 💬 QQ群 | 📺 配套视频 |\n|:-----------:|:--------:|:------------------:|:-----------:|:-----------------------------------:|\n| 逸寻智库 | Job | support@huo15.com | 1093992108 | [📺 B站视频](https://space.bilibili.com/400418085) |\n\n
\n---\n\n## 简介\n\n**火一五·辉火云企业套件插件** 是 [OpenClaw](https://github.com/nicepkg/openclaw) 的辉火云企业套件适配插件，让你用自然语言全面操作辉火云企业套件。尤其适合**实施经理、项目经理、销售经理**的日常工作场景。\n\n连接后，龙虾 AI Agent 即可帮你管理待办、跟进商机、查看工单、核对账款、记录工时、查库存、看员工——一句话搞定。\n\n### 核心特性\n\n- **Per-Agent 凭据隔离** — 搭配 WeCom 动态 agent，每个企微用户拥有独立的辉火云凭据，互不干扰\n- **智能连接引导** — 首次使用自动引导输入系统地址、用户名、密码；数据库自动检测\n- **实施经理每日概况** — 一句\"今天有什么工作？\"汇总任务、活动、工单、逾期账款、商机、未读消息\n- **待办 & 任务** — 创建、列表、更新状态/优先级/截止日期\n- **CRM 商机管道** — 查看/创建/推进/赢单/输单\n- **项目 & 里程碑** — 项目进度总览、里程碑完成率、工时记录\n- **客服工单** — 查看/创建 Helpdesk 工单\n- **销售 & 采购** — 查看销售订单、采购订单\n- **财务发票** — 发票查询、逾期应收账款筛选\n- **联系人/客户** — 查询/创建联系人、客户、供应商\n- **库存管理** — 库存水平查询、调拨单/出入库单\n- **HR 人事** — 员工查询、考勤打卡记录、请假记录\n- **审批流** — 查看审批请求\n- **活动提醒** — 创建活动、查看今日到期/逾期活动\n- **日历会议** — 创建日历事件\n- **消息 & 邮件** — 未读消息查看、Chatter 消息发送\n- **通用搜索** — 搜索任意辉火云数据模型（客户、产品、员工、库存...）\n- **后台通知同步** — 自动轮询推送新任务/活动/消息/邮件/日历变更\n\n---\n\n## 一键安装\n\n```bash\nopenclaw plugins install @huo15/huo15-huihuoyun-odoo\n```\n\n重启 OpenClaw 生效：\n\n```bash\nopenclaw restart\n```\n\n---\n\n## 首次配置\n\n### 方式一：通过对话连接（推荐）\n\n用户只需说一句话，插件会自动引导：\n\n> 帮我连接公司系统\n\n龙虾会依次询问：系统地址、用户名、密码。数据库自动检测（单库自动连接，多库让你选择）。\n\n连接信息按 agent 隔离保存，下次使用自动恢复，无需重新输入。\n\n### 方式二：通过 openclaw.plugin.json 预配置\n\n```json\n{\n \"odoo\": {\n \"url\": \"https://www.huo15.com\",\n \"db\": \"huo15\",\n \"username\": \"admin@huo15.com\",\n \"password\": \"your-password\"\n },\n \"sync\": {\n \"enabled\": true,\n \"intervalSeconds\": 30,\n \"channels\": [\"todo\", \"activity\", \"message\", \"email\", \"calendar\"]\n }\n}\n```\n\n---\n\n## 工具列表（32 个）\n\n### 基础\n| 工具 | 说明 |\n|------|------|\n| `odoo_connect` | 连接辉火云企业套件（db 可选，自动检测） |\n| `odoo_status` | 检查连接状态和轮询状态 |\n| `odoo_disconnect` | 断开连接并清除已保存凭据 |\n\n### 任务 & 活动\n| 工具 | 说明 |\n|------|------|\n| `odoo_create_task` | 创建待办任务 |\n| `odoo_list_tasks` | 查看待办列表（支持 today_only/state 筛选） |\n| `odoo_update_task` | 更新任务（状态/阶段/截止日期/优先级） |\n| `odoo_create_activity` | 创建活动提醒（关联到记录） |\n| `odoo_list_activities` | 查看今日及逾期活动 |\n| `odoo_activity_types` | 查询活动类型列表 |\n| `odoo_create_event` | 创建日历事件/会议 |\n\n### 消息\n| 工具 | 说明 |\n|------|------|\n| `odoo_get_messages` | 查看未读消息/邮件通知 |\n| `odoo_send_message` | 向记录发送 Chatter 消息 |\n\n### CRM\n| 工具 | 说明 |\n|------|------|\n| `odoo_crm_pipeline` | 查看商机管道 |\n| `odoo_crm_create` | 创建商机/线索 |\n| `odoo_crm_update` | 更新商机信息 |\n| `odoo_crm_won` | 标记赢单 |\n| `odoo_crm_lost` | 标记输单 |\n\n### 项目 & 工时\n| 工具 | 说明 |\n|------|------|\n| `odoo_project_overview` | 项目列表 + 里程碑进度 |\n| `odoo_timesheet_log` | 记录工时 |\n\n### 销售 & 采购 & 财务\n| 工具 | 说明 |\n|------|------|\n| `odoo_sale_orders` | 查看销售订单 |\n| `odoo_purchase_orders` | 查看采购订单 |\n| `odoo_invoices` | 查看发票/账单（支持逾期筛选） |\n\n### 客服\n| 工具 | 说明 |\n|------|------|\n| `odoo_tickets` | 查看客服工单 |\n| `odoo_ticket_create` | 创建客服工单 |\n\n### 联系人（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_contacts` | 查询联系人/客户/供应商 |\n| `odoo_contact_create` | 创建联系人/客户/供应商 |\n\n### 库存（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_stock_levels` | 查看库存水平 |\n| `odoo_stock_pickings` | 查看调拨单/出入库单 |\n\n### HR 人事（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_employees` | 查询员工列表 |\n| `odoo_leaves` | 查看请假记录 |\n| `odoo_attendances` | 查看考勤打卡记录 |\n\n### 审批（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_approvals` | 查看审批请求 |\n\n### 助手\n| 工具 | 说明 |\n|------|------|\n| `odoo_search` | 通用搜索（任意模型任意条件） |\n| `odoo_daily_briefing` | 实施经理每日工作概况 |\n\n---\n\n## WeCom 动态 Agent 多用户隔离\n\n搭配 `@huo15/wecom` 插件的动态 agent 能力，每个企微用户/群组拥有独立的辉火云连接：\n\n1. **凭据隔离** — 用户 A 的辉火云账号密码，用户 B 看不到也用不了\n2. **Session 隔离** — 每个用户各自的辉火云 session，互不干扰\n3. **数据隔离** — 每个用户看到的是自己辉火云账号的数据\n4. **自动恢复** — 每个用户的凭据独立持久化，重启后自动恢复\n\n**实现原理**：\n- 工具通过 `ctx.agentId` 获取当前用户的动态 agent ID（如 `wecom-acct-ws-dm-zhangsan`）\n- 配置持久化到 `~/.openclaw/plugin-configs/odoo/{agentId}.json`\n- OdooClient 和 NotificationPoller 均按 agentId 隔离存储\n\n---\n\n## 使用示例\n\n```\n👤 帮我连接公司系统\n🦞 好的，请提供：1) 系统地址 2) 用户名 3) 密码\n\n👤 地址 https://erp.huo15.com，用户名 zhang@huo15.com，密码 xxx\n🦞 已成功连接到 erp.huo15.com（数据库: huo15），欢迎使用辉火云企业套件！\n\n👤 今天有什么工作？\n🦞 汇总：3个待办任务、2个到期活动、1个紧急工单、华为商机需跟进...\n\n👤 帮我创建任务：明天发报价单给华为\n🦞 已创建任务 #456，截止日期 2026-04-13\n\n👤 查看我的商机\n🦞 你有 5 个活跃商机：华为ERP项目（报价阶段，50万）...\n\n👤 商机 #88 赢了\n🦞 已标记商机 #88 为赢单\n\n👤 有哪些客户还没付款\n🦞 3张未付发票：华为 ¥12,000（逾期15天）...\n\n👤 查下产品A还有多少库存\n🦞 产品A 库存：上海仓 120 件、北京仓 45 件\n\n👤 研发部有哪些员工\n🦞 研发部共 8 人：张三（前端）、李四（后端）...\n```\n\n---\n\n## 通知同步\n\n插件连接后自动轮询（默认 30 秒），推送以下变更：\n\n| 通道 | 触发条件 |\n|------|---------|\n| todo | 我的任务有新增或更新 |\n| activity | 今日到期活动 |\n| message | 新 Chatter 消息 |\n| email（可选）| 新邮件通知 |\n| calendar（可选）| 今明两天内的新日历事件 |\n\n---\n\n## 技术架构\n\n- **JSON-RPC 对接** — 通过 `/web/session/authenticate` 和 `/web/dataset/call_kw` 与辉火云后端通信\n- **Per-Agent 隔离** — 按 `ctx.agentId` 隔离 OdooClient / Poller / Config，兼容 WeCom 动态 agent\n- **数据库自动检测** — `/web/database/list` 查询可用数据库，单库自动选择\n- **Session 自动重连** — `ensureAuthenticated()` 在轮询前自动检查并恢复 session\n- **高水位线去重** — 消息/邮件用 `id > highWaterMark` 去重，避免时钟偏差问题\n- **基线初始化** — 首次启动静默建立水位线，不推送历史数据\n- **OpenClaw 插件规范** — `definePluginEntry` + `api.registerTool()` + `api.on(\"before_prompt_build\")`\n\n---\n\n## 常见问题\n\n**Q: 连接失败怎么办？**\nA: 检查 URL（末尾不带斜杠）、账号密码。用 `odoo_status` 查看当前状态。数据库名一般不用手动填，插件会自动检测。\n\n**Q: WeCom 多用户场景下，每个用户都要单独连接吗？**\nA: 是的。每个企微用户首次使用辉火云企业套件功能时会被引导输入自己的系统地址和账号密码，之后自动保存，无需重复输入。\n\n**Q: 每日概况失败提示没有 helpdesk 模块？**\nA: 系统中未安装 Helpdesk 模块时，工单部分会自动跳过，其他项正常返回。\n\n**Q: 商机阶段 ID 怎么获取？**\nA: 通过 `odoo_search(model=\"crm.stage\")` 查询所有 CRM 阶段及其 ID。\n\n**Q: 如何断开连接并清除保存的密码？**\nA: 告诉龙虾\"断开辉火云连接\"，会调用 `odoo_disconnect` 清除当前用户的凭据。\n\n---\n\n## Changelog\n\n- **v1.2.0** — Per-agent 凭据隔离（WeCom 多用户）、智能连接引导、数据库自动检测、联系人/客户管理、库存查询（stock.quant/stock.picking）、HR 员工/考勤/请假、审批流查询、odoo_disconnect 工具。共 32 个工具\n- **v1.1.0** — CRM 商机管道、项目里程碑、工时记录、销售/采购订单、Helpdesk 工单、发票/逾期账款查询、任务状态更新、活动类型查询、实施经理每日概况\n- **v1.0.0** — 基础版：待办/任务、活动提醒、日历事件、消息/邮件、通用搜索、后台轮询\n\n---\n\n## License\n\nMIT\n\n---\n\n\n\n| 🏫 教学机构 | 👨🏫 讲师 | 📧 联系方式 | 💬 QQ群 | 📺 配套视频 |\n|:-----------:|:--------:|:------------------:|:-----------:|:-----------------------------------:|\n| 逸寻智库 | Job | support@huo15.com | 1093992108 | [📺 B站视频](https://space.bilibili.com/400418085) |\n\n
\n---\n\n## 简介\n\n**火一五·辉火云企业套件插件** 是 [OpenClaw](https://github.com/nicepkg/openclaw) 的辉火云企业套件适配插件，让你用自然语言全面操作辉火云企业套件。尤其适合**实施经理、项目经理、销售经理**的日常工作场景。\n\n连接后，龙虾 AI Agent 即可帮你管理待办、跟进商机、查看工单、核对账款、记录工时、查库存、看员工——一句话搞定。\n\n### 核心特性\n\n- **Per-Agent 凭据隔离** — 搭配 WeCom 动态 agent，每个企微用户拥有独立的辉火云凭据，互不干扰\n- **智能连接引导** — 首次使用自动引导输入系统地址、用户名、密码；数据库自动检测\n- **实施经理每日概况** — 一句\"今天有什么工作？\"汇总任务、活动、工单、逾期账款、商机、未读消息\n- **待办 & 任务** — 创建、列表、更新状态/优先级/截止日期\n- **CRM 商机管道** — 查看/创建/推进/赢单/输单\n- **项目 & 里程碑** — 项目进度总览、里程碑完成率、工时记录\n- **客服工单** — 查看/创建 Helpdesk 工单\n- **销售 & 采购** — 查看销售订单、采购订单\n- **财务发票** — 发票查询、逾期应收账款筛选\n- **联系人/客户** — 查询/创建联系人、客户、供应商\n- **库存管理** — 库存水平查询、调拨单/出入库单\n- **HR 人事** — 员工查询、考勤打卡记录、请假记录\n- **审批流** — 查看审批请求\n- **活动提醒** — 创建活动、查看今日到期/逾期活动\n- **日历会议** — 创建日历事件\n- **消息 & 邮件** — 未读消息查看、Chatter 消息发送\n- **通用搜索** — 搜索任意辉火云数据模型（客户、产品、员工、库存...）\n- **后台通知同步** — 自动轮询推送新任务/活动/消息/邮件/日历变更\n\n---\n\n## 一键安装\n\n```bash\nopenclaw plugins install @huo15/huo15-huihuoyun-odoo\n```\n\n重启 OpenClaw 生效：\n\n```bash\nopenclaw restart\n```\n\n---\n\n## 首次配置\n\n### 方式一：通过对话连接（推荐）\n\n用户只需说一句话，插件会自动引导：\n\n> 帮我连接公司系统\n\n龙虾会依次询问：系统地址、用户名、密码。数据库自动检测（单库自动连接，多库让你选择）。\n\n连接信息按 agent 隔离保存，下次使用自动恢复，无需重新输入。\n\n### 方式二：通过 openclaw.plugin.json 预配置\n\n```json\n{\n \"odoo\": {\n \"url\": \"https://www.huo15.com\",\n \"db\": \"huo15\",\n \"username\": \"admin@huo15.com\",\n \"password\": \"your-password\"\n },\n \"sync\": {\n \"enabled\": true,\n \"intervalSeconds\": 30,\n \"channels\": [\"todo\", \"activity\", \"message\", \"email\", \"calendar\"]\n }\n}\n```\n\n---\n\n## 工具列表（32 个）\n\n### 基础\n| 工具 | 说明 |\n|------|------|\n| `odoo_connect` | 连接辉火云企业套件（db 可选，自动检测） |\n| `odoo_status` | 检查连接状态和轮询状态 |\n| `odoo_disconnect` | 断开连接并清除已保存凭据 |\n\n### 任务 & 活动\n| 工具 | 说明 |\n|------|------|\n| `odoo_create_task` | 创建待办任务 |\n| `odoo_list_tasks` | 查看待办列表（支持 today_only/state 筛选） |\n| `odoo_update_task` | 更新任务（状态/阶段/截止日期/优先级） |\n| `odoo_create_activity` | 创建活动提醒（关联到记录） |\n| `odoo_list_activities` | 查看今日及逾期活动 |\n| `odoo_activity_types` | 查询活动类型列表 |\n| `odoo_create_event` | 创建日历事件/会议 |\n\n### 消息\n| 工具 | 说明 |\n|------|------|\n| `odoo_get_messages` | 查看未读消息/邮件通知 |\n| `odoo_send_message` | 向记录发送 Chatter 消息 |\n\n### CRM\n| 工具 | 说明 |\n|------|------|\n| `odoo_crm_pipeline` | 查看商机管道 |\n| `odoo_crm_create` | 创建商机/线索 |\n| `odoo_crm_update` | 更新商机信息 |\n| `odoo_crm_won` | 标记赢单 |\n| `odoo_crm_lost` | 标记输单 |\n\n### 项目 & 工时\n| 工具 | 说明 |\n|------|------|\n| `odoo_project_overview` | 项目列表 + 里程碑进度 |\n| `odoo_timesheet_log` | 记录工时 |\n\n### 销售 & 采购 & 财务\n| 工具 | 说明 |\n|------|------|\n| `odoo_sale_orders` | 查看销售订单 |\n| `odoo_purchase_orders` | 查看采购订单 |\n| `odoo_invoices` | 查看发票/账单（支持逾期筛选） |\n\n### 客服\n| 工具 | 说明 |\n|------|------|\n| `odoo_tickets` | 查看客服工单 |\n| `odoo_ticket_create` | 创建客服工单 |\n\n### 联系人（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_contacts` | 查询联系人/客户/供应商 |\n| `odoo_contact_create` | 创建联系人/客户/供应商 |\n\n### 库存（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_stock_levels` | 查看库存水平 |\n| `odoo_stock_pickings` | 查看调拨单/出入库单 |\n\n### HR 人事（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_employees` | 查询员工列表 |\n| `odoo_leaves` | 查看请假记录 |\n| `odoo_attendances` | 查看考勤打卡记录 |\n\n### 审批（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_approvals` | 查看审批请求 |\n\n### 助手\n| 工具 | 说明 |\n|------|------|\n| `odoo_search` | 通用搜索（任意模型任意条件） |\n| `odoo_daily_briefing` | 实施经理每日工作概况 |\n\n---\n\n## WeCom 动态 Agent 多用户隔离\n\n搭配 `@huo15/wecom` 插件的动态 agent 能力，每个企微用户/群组拥有独立的辉火云连接：\n\n1. **凭据隔离** — 用户 A 的辉火云账号密码，用户 B 看不到也用不了\n2. **Session 隔离** — 每个用户各自的辉火云 session，互不干扰\n3. **数据隔离** — 每个用户看到的是自己辉火云账号的数据\n4. **自动恢复** — 每个用户的凭据独立持久化，重启后自动恢复\n\n**实现原理**：\n- 工具通过 `ctx.agentId` 获取当前用户的动态 agent ID（如 `wecom-acct-ws-dm-zhangsan`）\n- 配置持久化到 `~/.openclaw/plugin-configs/odoo/{agentId}.json`\n- OdooClient 和 NotificationPoller 均按 agentId 隔离存储\n\n---\n\n## 使用示例\n\n```\n👤 帮我连接公司系统\n🦞 好的，请提供：1) 系统地址 2) 用户名 3) 密码\n\n👤 地址 https://erp.huo15.com，用户名 zhang@huo15.com，密码 xxx\n🦞 已成功连接到 erp.huo15.com（数据库: huo15），欢迎使用辉火云企业套件！\n\n👤 今天有什么工作？\n🦞 汇总：3个待办任务、2个到期活动、1个紧急工单、华为商机需跟进...\n\n👤 帮我创建任务：明天发报价单给华为\n🦞 已创建任务 #456，截止日期 2026-04-13\n\n👤 查看我的商机\n🦞 你有 5 个活跃商机：华为ERP项目（报价阶段，50万）...\n\n👤 商机 #88 赢了\n🦞 已标记商机 #88 为赢单\n\n👤 有哪些客户还没付款\n🦞 3张未付发票：华为 ¥12,000（逾期15天）...\n\n👤 查下产品A还有多少库存\n🦞 产品A 库存：上海仓 120 件、北京仓 45 件\n\n👤 研发部有哪些员工\n🦞 研发部共 8 人：张三（前端）、李四（后端）...\n```\n\n---\n\n## 通知同步\n\n插件连接后自动轮询（默认 30 秒），推送以下变更：\n\n| 通道 | 触发条件 |\n|------|---------|\n| todo | 我的任务有新增或更新 |\n| activity | 今日到期活动 |\n| message | 新 Chatter 消息 |\n| email（可选）| 新邮件通知 |\n| calendar（可选）| 今明两天内的新日历事件 |\n\n---\n\n## 技术架构\n\n- **JSON-RPC 对接** — 通过 `/web/session/authenticate` 和 `/web/dataset/call_kw` 与辉火云后端通信\n- **Per-Agent 隔离** — 按 `ctx.agentId` 隔离 OdooClient / Poller / Config，兼容 WeCom 动态 agent\n- **数据库自动检测** — `/web/database/list` 查询可用数据库，单库自动选择\n- **Session 自动重连** — `ensureAuthenticated()` 在轮询前自动检查并恢复 session\n- **高水位线去重** — 消息/邮件用 `id > highWaterMark` 去重，避免时钟偏差问题\n- **基线初始化** — 首次启动静默建立水位线，不推送历史数据\n- **OpenClaw 插件规范** — `definePluginEntry` + `api.registerTool()` + `api.on(\"before_prompt_build\")`\n\n---\n\n## 常见问题\n\n**Q: 连接失败怎么办？**\nA: 检查 URL（末尾不带斜杠）、账号密码。用 `odoo_status` 查看当前状态。数据库名一般不用手动填，插件会自动检测。\n\n**Q: WeCom 多用户场景下，每个用户都要单独连接吗？**\nA: 是的。每个企微用户首次使用辉火云企业套件功能时会被引导输入自己的系统地址和账号密码，之后自动保存，无需重复输入。\n\n**Q: 每日概况失败提示没有 helpdesk 模块？**\nA: 系统中未安装 Helpdesk 模块时，工单部分会自动跳过，其他项正常返回。\n\n**Q: 商机阶段 ID 怎么获取？**\nA: 通过 `odoo_search(model=\"crm.stage\")` 查询所有 CRM 阶段及其 ID。\n\n**Q: 如何断开连接并清除保存的密码？**\nA: 告诉龙虾\"断开辉火云连接\"，会调用 `odoo_disconnect` 清除当前用户的凭据。\n\n---\n\n## Changelog\n\n- **v1.2.0** — Per-agent 凭据隔离（WeCom 多用户）、智能连接引导、数据库自动检测、联系人/客户管理、库存查询（stock.quant/stock.picking）、HR 员工/考勤/请假、审批流查询、odoo_disconnect 工具。共 32 个工具\n- **v1.1.0** — CRM 商机管道、项目里程碑、工时记录、销售/采购订单、Helpdesk 工单、发票/逾期账款查询、任务状态更新、活动类型查询、实施经理每日概况\n- **v1.0.0** — 基础版：待办/任务、活动提醒、日历事件、消息/邮件、通用搜索、后台轮询\n\n---\n\n## License\n\nMIT\n\n---\n\n\n\n| 🏫 教学机构 | 👨🏫 讲师 | 📧 联系方式 | 💬 QQ群 | 📺 配套视频 |\n|:-----------:|:--------:|:------------------:|:-----------:|:-----------------------------------:|\n| 逸寻智库 | Job | support@huo15.com | 1093992108 | [📺 B站视频](https://space.bilibili.com/400418085) |\n\n
\n---\n\n## 简介\n\n**火一五·辉火云企业套件插件** 是 [OpenClaw](https://github.com/nicepkg/openclaw) 的辉火云企业套件适配插件，让你用自然语言全面操作辉火云企业套件。尤其适合**实施经理、项目经理、销售经理**的日常工作场景。\n\n连接后，龙虾 AI Agent 即可帮你管理待办、跟进商机、查看工单、核对账款、记录工时、查库存、看员工——一句话搞定。\n\n### 核心特性\n\n- **Per-Agent 凭据隔离** — 搭配 WeCom 动态 agent，每个企微用户拥有独立的辉火云凭据，互不干扰\n- **智能连接引导** — 首次使用自动引导输入系统地址、用户名、密码；数据库自动检测\n- **实施经理每日概况** — 一句\"今天有什么工作？\"汇总任务、活动、工单、逾期账款、商机、未读消息\n- **待办 & 任务** — 创建、列表、更新状态/优先级/截止日期\n- **CRM 商机管道** — 查看/创建/推进/赢单/输单\n- **项目 & 里程碑** — 项目进度总览、里程碑完成率、工时记录\n- **客服工单** — 查看/创建 Helpdesk 工单\n- **销售 & 采购** — 查看销售订单、采购订单\n- **财务发票** — 发票查询、逾期应收账款筛选\n- **联系人/客户** — 查询/创建联系人、客户、供应商\n- **库存管理** — 库存水平查询、调拨单/出入库单\n- **HR 人事** — 员工查询、考勤打卡记录、请假记录\n- **审批流** — 查看审批请求\n- **活动提醒** — 创建活动、查看今日到期/逾期活动\n- **日历会议** — 创建日历事件\n- **消息 & 邮件** — 未读消息查看、Chatter 消息发送\n- **通用搜索** — 搜索任意辉火云数据模型（客户、产品、员工、库存...）\n- **后台通知同步** — 自动轮询推送新任务/活动/消息/邮件/日历变更\n\n---\n\n## 一键安装\n\n```bash\nopenclaw plugins install @huo15/huo15-huihuoyun-odoo\n```\n\n重启 OpenClaw 生效：\n\n```bash\nopenclaw restart\n```\n\n---\n\n## 首次配置\n\n### 方式一：通过对话连接（推荐）\n\n用户只需说一句话，插件会自动引导：\n\n> 帮我连接公司系统\n\n龙虾会依次询问：系统地址、用户名、密码。数据库自动检测（单库自动连接，多库让你选择）。\n\n连接信息按 agent 隔离保存，下次使用自动恢复，无需重新输入。\n\n### 方式二：通过 openclaw.plugin.json 预配置\n\n```json\n{\n \"odoo\": {\n \"url\": \"https://www.huo15.com\",\n \"db\": \"huo15\",\n \"username\": \"admin@huo15.com\",\n \"password\": \"your-password\"\n },\n \"sync\": {\n \"enabled\": true,\n \"intervalSeconds\": 30,\n \"channels\": [\"todo\", \"activity\", \"message\", \"email\", \"calendar\"]\n }\n}\n```\n\n---\n\n## 工具列表（32 个）\n\n### 基础\n| 工具 | 说明 |\n|------|------|\n| `odoo_connect` | 连接辉火云企业套件（db 可选，自动检测） |\n| `odoo_status` | 检查连接状态和轮询状态 |\n| `odoo_disconnect` | 断开连接并清除已保存凭据 |\n\n### 任务 & 活动\n| 工具 | 说明 |\n|------|------|\n| `odoo_create_task` | 创建待办任务 |\n| `odoo_list_tasks` | 查看待办列表（支持 today_only/state 筛选） |\n| `odoo_update_task` | 更新任务（状态/阶段/截止日期/优先级） |\n| `odoo_create_activity` | 创建活动提醒（关联到记录） |\n| `odoo_list_activities` | 查看今日及逾期活动 |\n| `odoo_activity_types` | 查询活动类型列表 |\n| `odoo_create_event` | 创建日历事件/会议 |\n\n### 消息\n| 工具 | 说明 |\n|------|------|\n| `odoo_get_messages` | 查看未读消息/邮件通知 |\n| `odoo_send_message` | 向记录发送 Chatter 消息 |\n\n### CRM\n| 工具 | 说明 |\n|------|------|\n| `odoo_crm_pipeline` | 查看商机管道 |\n| `odoo_crm_create` | 创建商机/线索 |\n| `odoo_crm_update` | 更新商机信息 |\n| `odoo_crm_won` | 标记赢单 |\n| `odoo_crm_lost` | 标记输单 |\n\n### 项目 & 工时\n| 工具 | 说明 |\n|------|------|\n| `odoo_project_overview` | 项目列表 + 里程碑进度 |\n| `odoo_timesheet_log` | 记录工时 |\n\n### 销售 & 采购 & 财务\n| 工具 | 说明 |\n|------|------|\n| `odoo_sale_orders` | 查看销售订单 |\n| `odoo_purchase_orders` | 查看采购订单 |\n| `odoo_invoices` | 查看发票/账单（支持逾期筛选） |\n\n### 客服\n| 工具 | 说明 |\n|------|------|\n| `odoo_tickets` | 查看客服工单 |\n| `odoo_ticket_create` | 创建客服工单 |\n\n### 联系人（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_contacts` | 查询联系人/客户/供应商 |\n| `odoo_contact_create` | 创建联系人/客户/供应商 |\n\n### 库存（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_stock_levels` | 查看库存水平 |\n| `odoo_stock_pickings` | 查看调拨单/出入库单 |\n\n### HR 人事（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_employees` | 查询员工列表 |\n| `odoo_leaves` | 查看请假记录 |\n| `odoo_attendances` | 查看考勤打卡记录 |\n\n### 审批（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_approvals` | 查看审批请求 |\n\n### 助手\n| 工具 | 说明 |\n|------|------|\n| `odoo_search` | 通用搜索（任意模型任意条件） |\n| `odoo_daily_briefing` | 实施经理每日工作概况 |\n\n---\n\n## WeCom 动态 Agent 多用户隔离\n\n搭配 `@huo15/wecom` 插件的动态 agent 能力，每个企微用户/群组拥有独立的辉火云连接：\n\n1. **凭据隔离** — 用户 A 的辉火云账号密码，用户 B 看不到也用不了\n2. **Session 隔离** — 每个用户各自的辉火云 session，互不干扰\n3. **数据隔离** — 每个用户看到的是自己辉火云账号的数据\n4. **自动恢复** — 每个用户的凭据独立持久化，重启后自动恢复\n\n**实现原理**：\n- 工具通过 `ctx.agentId` 获取当前用户的动态 agent ID（如 `wecom-acct-ws-dm-zhangsan`）\n- 配置持久化到 `~/.openclaw/plugin-configs/odoo/{agentId}.json`\n- OdooClient 和 NotificationPoller 均按 agentId 隔离存储\n\n---\n\n## 使用示例\n\n```\n👤 帮我连接公司系统\n🦞 好的，请提供：1) 系统地址 2) 用户名 3) 密码\n\n👤 地址 https://erp.huo15.com，用户名 zhang@huo15.com，密码 xxx\n🦞 已成功连接到 erp.huo15.com（数据库: huo15），欢迎使用辉火云企业套件！\n\n👤 今天有什么工作？\n🦞 汇总：3个待办任务、2个到期活动、1个紧急工单、华为商机需跟进...\n\n👤 帮我创建任务：明天发报价单给华为\n🦞 已创建任务 #456，截止日期 2026-04-13\n\n👤 查看我的商机\n🦞 你有 5 个活跃商机：华为ERP项目（报价阶段，50万）...\n\n👤 商机 #88 赢了\n🦞 已标记商机 #88 为赢单\n\n👤 有哪些客户还没付款\n🦞 3张未付发票：华为 ¥12,000（逾期15天）...\n\n👤 查下产品A还有多少库存\n🦞 产品A 库存：上海仓 120 件、北京仓 45 件\n\n👤 研发部有哪些员工\n🦞 研发部共 8 人：张三（前端）、李四（后端）...\n```\n\n---\n\n## 通知同步\n\n插件连接后自动轮询（默认 30 秒），推送以下变更：\n\n| 通道 | 触发条件 |\n|------|---------|\n| todo | 我的任务有新增或更新 |\n| activity | 今日到期活动 |\n| message | 新 Chatter 消息 |\n| email（可选）| 新邮件通知 |\n| calendar（可选）| 今明两天内的新日历事件 |\n\n---\n\n## 技术架构\n\n- **JSON-RPC 对接** — 通过 `/web/session/authenticate` 和 `/web/dataset/call_kw` 与辉火云后端通信\n- **Per-Agent 隔离** — 按 `ctx.agentId` 隔离 OdooClient / Poller / Config，兼容 WeCom 动态 agent\n- **数据库自动检测** — `/web/database/list` 查询可用数据库，单库自动选择\n- **Session 自动重连** — `ensureAuthenticated()` 在轮询前自动检查并恢复 session\n- **高水位线去重** — 消息/邮件用 `id > highWaterMark` 去重，避免时钟偏差问题\n- **基线初始化** — 首次启动静默建立水位线，不推送历史数据\n- **OpenClaw 插件规范** — `definePluginEntry` + `api.registerTool()` + `api.on(\"before_prompt_build\")`\n\n---\n\n## 常见问题\n\n**Q: 连接失败怎么办？**\nA: 检查 URL（末尾不带斜杠）、账号密码。用 `odoo_status` 查看当前状态。数据库名一般不用手动填，插件会自动检测。\n\n**Q: WeCom 多用户场景下，每个用户都要单独连接吗？**\nA: 是的。每个企微用户首次使用辉火云企业套件功能时会被引导输入自己的系统地址和账号密码，之后自动保存，无需重复输入。\n\n**Q: 每日概况失败提示没有 helpdesk 模块？**\nA: 系统中未安装 Helpdesk 模块时，工单部分会自动跳过，其他项正常返回。\n\n**Q: 商机阶段 ID 怎么获取？**\nA: 通过 `odoo_search(model=\"crm.stage\")` 查询所有 CRM 阶段及其 ID。\n\n**Q: 如何断开连接并清除保存的密码？**\nA: 告诉龙虾\"断开辉火云连接\"，会调用 `odoo_disconnect` 清除当前用户的凭据。\n\n---\n\n## Changelog\n\n- **v1.2.0** — Per-agent 凭据隔离（WeCom 多用户）、智能连接引导、数据库自动检测、联系人/客户管理、库存查询（stock.quant/stock.picking）、HR 员工/考勤/请假、审批流查询、odoo_disconnect 工具。共 32 个工具\n- **v1.1.0** — CRM 商机管道、项目里程碑、工时记录、销售/采购订单、Helpdesk 工单、发票/逾期账款查询、任务状态更新、活动类型查询、实施经理每日概况\n- **v1.0.0** — 基础版：待办/任务、活动提醒、日历事件、消息/邮件、通用搜索、后台轮询\n\n---\n\n## License\n\nMIT\n\n---\n\n\n\n| 🏫 教学机构 | 👨🏫 讲师 | 📧 联系方式 | 💬 QQ群 | 📺 配套视频 |\n|:-----------:|:--------:|:------------------:|:-----------:|:-----------------------------------:|\n| 逸寻智库 | Job | support@huo15.com | 1093992108 | [📺 B站视频](https://space.bilibili.com/400418085) |\n\n
\n---\n\n## 简介\n\n**火一五·辉火云企业套件插件** 是 [OpenClaw](https://github.com/nicepkg/openclaw) 的辉火云企业套件适配插件，让你用自然语言全面操作辉火云企业套件。尤其适合**实施经理、项目经理、销售经理**的日常工作场景。\n\n连接后，龙虾 AI Agent 即可帮你管理待办、跟进商机、查看工单、核对账款、记录工时、查库存、看员工——一句话搞定。\n\n### 核心特性\n\n- **Per-Agent 凭据隔离** — 搭配 WeCom 动态 agent，每个企微用户拥有独立的辉火云凭据，互不干扰\n- **智能连接引导** — 首次使用自动引导输入系统地址、用户名、密码；数据库自动检测\n- **实施经理每日概况** — 一句\"今天有什么工作？\"汇总任务、活动、工单、逾期账款、商机、未读消息\n- **待办 & 任务** — 创建、列表、更新状态/优先级/截止日期\n- **CRM 商机管道** — 查看/创建/推进/赢单/输单\n- **项目 & 里程碑** — 项目进度总览、里程碑完成率、工时记录\n- **客服工单** — 查看/创建 Helpdesk 工单\n- **销售 & 采购** — 查看销售订单、采购订单\n- **财务发票** — 发票查询、逾期应收账款筛选\n- **联系人/客户** — 查询/创建联系人、客户、供应商\n- **库存管理** — 库存水平查询、调拨单/出入库单\n- **HR 人事** — 员工查询、考勤打卡记录、请假记录\n- **审批流** — 查看审批请求\n- **活动提醒** — 创建活动、查看今日到期/逾期活动\n- **日历会议** — 创建日历事件\n- **消息 & 邮件** — 未读消息查看、Chatter 消息发送\n- **通用搜索** — 搜索任意辉火云数据模型（客户、产品、员工、库存...）\n- **后台通知同步** — 自动轮询推送新任务/活动/消息/邮件/日历变更\n\n---\n\n## 一键安装\n\n```bash\nopenclaw plugins install @huo15/huo15-huihuoyun-odoo\n```\n\n重启 OpenClaw 生效：\n\n```bash\nopenclaw restart\n```\n\n---\n\n## 首次配置\n\n### 方式一：通过对话连接（推荐）\n\n用户只需说一句话，插件会自动引导：\n\n> 帮我连接公司系统\n\n龙虾会依次询问：系统地址、用户名、密码。数据库自动检测（单库自动连接，多库让你选择）。\n\n连接信息按 agent 隔离保存，下次使用自动恢复，无需重新输入。\n\n### 方式二：通过 openclaw.plugin.json 预配置\n\n```json\n{\n \"odoo\": {\n \"url\": \"https://www.huo15.com\",\n \"db\": \"huo15\",\n \"username\": \"admin@huo15.com\",\n \"password\": \"your-password\"\n },\n \"sync\": {\n \"enabled\": true,\n \"intervalSeconds\": 30,\n \"channels\": [\"todo\", \"activity\", \"message\", \"email\", \"calendar\"]\n }\n}\n```\n\n---\n\n## 工具列表（32 个）\n\n### 基础\n| 工具 | 说明 |\n|------|------|\n| `odoo_connect` | 连接辉火云企业套件（db 可选，自动检测） |\n| `odoo_status` | 检查连接状态和轮询状态 |\n| `odoo_disconnect` | 断开连接并清除已保存凭据 |\n\n### 任务 & 活动\n| 工具 | 说明 |\n|------|------|\n| `odoo_create_task` | 创建待办任务 |\n| `odoo_list_tasks` | 查看待办列表（支持 today_only/state 筛选） |\n| `odoo_update_task` | 更新任务（状态/阶段/截止日期/优先级） |\n| `odoo_create_activity` | 创建活动提醒（关联到记录） |\n| `odoo_list_activities` | 查看今日及逾期活动 |\n| `odoo_activity_types` | 查询活动类型列表 |\n| `odoo_create_event` | 创建日历事件/会议 |\n\n### 消息\n| 工具 | 说明 |\n|------|------|\n| `odoo_get_messages` | 查看未读消息/邮件通知 |\n| `odoo_send_message` | 向记录发送 Chatter 消息 |\n\n### CRM\n| 工具 | 说明 |\n|------|------|\n| `odoo_crm_pipeline` | 查看商机管道 |\n| `odoo_crm_create` | 创建商机/线索 |\n| `odoo_crm_update` | 更新商机信息 |\n| `odoo_crm_won` | 标记赢单 |\n| `odoo_crm_lost` | 标记输单 |\n\n### 项目 & 工时\n| 工具 | 说明 |\n|------|------|\n| `odoo_project_overview` | 项目列表 + 里程碑进度 |\n| `odoo_timesheet_log` | 记录工时 |\n\n### 销售 & 采购 & 财务\n| 工具 | 说明 |\n|------|------|\n| `odoo_sale_orders` | 查看销售订单 |\n| `odoo_purchase_orders` | 查看采购订单 |\n| `odoo_invoices` | 查看发票/账单（支持逾期筛选） |\n\n### 客服\n| 工具 | 说明 |\n|------|------|\n| `odoo_tickets` | 查看客服工单 |\n| `odoo_ticket_create` | 创建客服工单 |\n\n### 联系人（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_contacts` | 查询联系人/客户/供应商 |\n| `odoo_contact_create` | 创建联系人/客户/供应商 |\n\n### 库存（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_stock_levels` | 查看库存水平 |\n| `odoo_stock_pickings` | 查看调拨单/出入库单 |\n\n### HR 人事（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_employees` | 查询员工列表 |\n| `odoo_leaves` | 查看请假记录 |\n| `odoo_attendances` | 查看考勤打卡记录 |\n\n### 审批（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_approvals` | 查看审批请求 |\n\n### 助手\n| 工具 | 说明 |\n|------|------|\n| `odoo_search` | 通用搜索（任意模型任意条件） |\n| `odoo_daily_briefing` | 实施经理每日工作概况 |\n\n---\n\n## WeCom 动态 Agent 多用户隔离\n\n搭配 `@huo15/wecom` 插件的动态 agent 能力，每个企微用户/群组拥有独立的辉火云连接：\n\n1. **凭据隔离** — 用户 A 的辉火云账号密码，用户 B 看不到也用不了\n2. **Session 隔离** — 每个用户各自的辉火云 session，互不干扰\n3. **数据隔离** — 每个用户看到的是自己辉火云账号的数据\n4. **自动恢复** — 每个用户的凭据独立持久化，重启后自动恢复\n\n**实现原理**：\n- 工具通过 `ctx.agentId` 获取当前用户的动态 agent ID（如 `wecom-acct-ws-dm-zhangsan`）\n- 配置持久化到 `~/.openclaw/plugin-configs/odoo/{agentId}.json`\n- OdooClient 和 NotificationPoller 均按 agentId 隔离存储\n\n---\n\n## 使用示例\n\n```\n👤 帮我连接公司系统\n🦞 好的，请提供：1) 系统地址 2) 用户名 3) 密码\n\n👤 地址 https://erp.huo15.com，用户名 zhang@huo15.com，密码 xxx\n🦞 已成功连接到 erp.huo15.com（数据库: huo15），欢迎使用辉火云企业套件！\n\n👤 今天有什么工作？\n🦞 汇总：3个待办任务、2个到期活动、1个紧急工单、华为商机需跟进...\n\n👤 帮我创建任务：明天发报价单给华为\n🦞 已创建任务 #456，截止日期 2026-04-13\n\n👤 查看我的商机\n🦞 你有 5 个活跃商机：华为ERP项目（报价阶段，50万）...\n\n👤 商机 #88 赢了\n🦞 已标记商机 #88 为赢单\n\n👤 有哪些客户还没付款\n🦞 3张未付发票：华为 ¥12,000（逾期15天）...\n\n👤 查下产品A还有多少库存\n🦞 产品A 库存：上海仓 120 件、北京仓 45 件\n\n👤 研发部有哪些员工\n🦞 研发部共 8 人：张三（前端）、李四（后端）...\n```\n\n---\n\n## 通知同步\n\n插件连接后自动轮询（默认 30 秒），推送以下变更：\n\n| 通道 | 触发条件 |\n|------|---------|\n| todo | 我的任务有新增或更新 |\n| activity | 今日到期活动 |\n| message | 新 Chatter 消息 |\n| email（可选）| 新邮件通知 |\n| calendar（可选）| 今明两天内的新日历事件 |\n\n---\n\n## 技术架构\n\n- **JSON-RPC 对接** — 通过 `/web/session/authenticate` 和 `/web/dataset/call_kw` 与辉火云后端通信\n- **Per-Agent 隔离** — 按 `ctx.agentId` 隔离 OdooClient / Poller / Config，兼容 WeCom 动态 agent\n- **数据库自动检测** — `/web/database/list` 查询可用数据库，单库自动选择\n- **Session 自动重连** — `ensureAuthenticated()` 在轮询前自动检查并恢复 session\n- **高水位线去重** — 消息/邮件用 `id > highWaterMark` 去重，避免时钟偏差问题\n- **基线初始化** — 首次启动静默建立水位线，不推送历史数据\n- **OpenClaw 插件规范** — `definePluginEntry` + `api.registerTool()` + `api.on(\"before_prompt_build\")`\n\n---\n\n## 常见问题\n\n**Q: 连接失败怎么办？**\nA: 检查 URL（末尾不带斜杠）、账号密码。用 `odoo_status` 查看当前状态。数据库名一般不用手动填，插件会自动检测。\n\n**Q: WeCom 多用户场景下，每个用户都要单独连接吗？**\nA: 是的。每个企微用户首次使用辉火云企业套件功能时会被引导输入自己的系统地址和账号密码，之后自动保存，无需重复输入。\n\n**Q: 每日概况失败提示没有 helpdesk 模块？**\nA: 系统中未安装 Helpdesk 模块时，工单部分会自动跳过，其他项正常返回。\n\n**Q: 商机阶段 ID 怎么获取？**\nA: 通过 `odoo_search(model=\"crm.stage\")` 查询所有 CRM 阶段及其 ID。\n\n**Q: 如何断开连接并清除保存的密码？**\nA: 告诉龙虾\"断开辉火云连接\"，会调用 `odoo_disconnect` 清除当前用户的凭据。\n\n---\n\n## Changelog\n\n- **v1.2.0** — Per-agent 凭据隔离（WeCom 多用户）、智能连接引导、数据库自动检测、联系人/客户管理、库存查询（stock.quant/stock.picking）、HR 员工/考勤/请假、审批流查询、odoo_disconnect 工具。共 32 个工具\n- **v1.1.0** — CRM 商机管道、项目里程碑、工时记录、销售/采购订单、Helpdesk 工单、发票/逾期账款查询、任务状态更新、活动类型查询、实施经理每日概况\n- **v1.0.0** — 基础版：待办/任务、活动提醒、日历事件、消息/邮件、通用搜索、后台轮询\n\n---\n\n## License\n\nMIT\n\n---\n\n\n\n| 🏫 教学机构 | 👨🏫 讲师 | 📧 联系方式 | 💬 QQ群 | 📺 配套视频 |\n|:-----------:|:--------:|:------------------:|:-----------:|:-----------------------------------:|\n| 逸寻智库 | Job | support@huo15.com | 1093992108 | [📺 B站视频](https://space.bilibili.com/400418085) |\n\n
\n---\n\n## 简介\n\n**火一五·辉火云企业套件插件** 是 [OpenClaw](https://github.com/nicepkg/openclaw) 的辉火云企业套件适配插件，让你用自然语言全面操作辉火云企业套件。尤其适合**实施经理、项目经理、销售经理**的日常工作场景。\n\n连接后，龙虾 AI Agent 即可帮你管理待办、跟进商机、查看工单、核对账款、记录工时、查库存、看员工——一句话搞定。\n\n### 核心特性\n\n- **Per-Agent 凭据隔离** — 搭配 WeCom 动态 agent，每个企微用户拥有独立的辉火云凭据，互不干扰\n- **智能连接引导** — 首次使用自动引导输入系统地址、用户名、密码；数据库自动检测\n- **实施经理每日概况** — 一句\"今天有什么工作？\"汇总任务、活动、工单、逾期账款、商机、未读消息\n- **待办 & 任务** — 创建、列表、更新状态/优先级/截止日期\n- **CRM 商机管道** — 查看/创建/推进/赢单/输单\n- **项目 & 里程碑** — 项目进度总览、里程碑完成率、工时记录\n- **客服工单** — 查看/创建 Helpdesk 工单\n- **销售 & 采购** — 查看销售订单、采购订单\n- **财务发票** — 发票查询、逾期应收账款筛选\n- **联系人/客户** — 查询/创建联系人、客户、供应商\n- **库存管理** — 库存水平查询、调拨单/出入库单\n- **HR 人事** — 员工查询、考勤打卡记录、请假记录\n- **审批流** — 查看审批请求\n- **活动提醒** — 创建活动、查看今日到期/逾期活动\n- **日历会议** — 创建日历事件\n- **消息 & 邮件** — 未读消息查看、Chatter 消息发送\n- **通用搜索** — 搜索任意辉火云数据模型（客户、产品、员工、库存...）\n- **后台通知同步** — 自动轮询推送新任务/活动/消息/邮件/日历变更\n\n---\n\n## 一键安装\n\n```bash\nopenclaw plugins install @huo15/huo15-huihuoyun-odoo\n```\n\n重启 OpenClaw 生效：\n\n```bash\nopenclaw restart\n```\n\n---\n\n## 首次配置\n\n### 方式一：通过对话连接（推荐）\n\n用户只需说一句话，插件会自动引导：\n\n> 帮我连接公司系统\n\n龙虾会依次询问：系统地址、用户名、密码。数据库自动检测（单库自动连接，多库让你选择）。\n\n连接信息按 agent 隔离保存，下次使用自动恢复，无需重新输入。\n\n### 方式二：通过 openclaw.plugin.json 预配置\n\n```json\n{\n \"odoo\": {\n \"url\": \"https://www.huo15.com\",\n \"db\": \"huo15\",\n \"username\": \"admin@huo15.com\",\n \"password\": \"your-password\"\n },\n \"sync\": {\n \"enabled\": true,\n \"intervalSeconds\": 30,\n \"channels\": [\"todo\", \"activity\", \"message\", \"email\", \"calendar\"]\n }\n}\n```\n\n---\n\n## 工具列表（32 个）\n\n### 基础\n| 工具 | 说明 |\n|------|------|\n| `odoo_connect` | 连接辉火云企业套件（db 可选，自动检测） |\n| `odoo_status` | 检查连接状态和轮询状态 |\n| `odoo_disconnect` | 断开连接并清除已保存凭据 |\n\n### 任务 & 活动\n| 工具 | 说明 |\n|------|------|\n| `odoo_create_task` | 创建待办任务 |\n| `odoo_list_tasks` | 查看待办列表（支持 today_only/state 筛选） |\n| `odoo_update_task` | 更新任务（状态/阶段/截止日期/优先级） |\n| `odoo_create_activity` | 创建活动提醒（关联到记录） |\n| `odoo_list_activities` | 查看今日及逾期活动 |\n| `odoo_activity_types` | 查询活动类型列表 |\n| `odoo_create_event` | 创建日历事件/会议 |\n\n### 消息\n| 工具 | 说明 |\n|------|------|\n| `odoo_get_messages` | 查看未读消息/邮件通知 |\n| `odoo_send_message` | 向记录发送 Chatter 消息 |\n\n### CRM\n| 工具 | 说明 |\n|------|------|\n| `odoo_crm_pipeline` | 查看商机管道 |\n| `odoo_crm_create` | 创建商机/线索 |\n| `odoo_crm_update` | 更新商机信息 |\n| `odoo_crm_won` | 标记赢单 |\n| `odoo_crm_lost` | 标记输单 |\n\n### 项目 & 工时\n| 工具 | 说明 |\n|------|------|\n| `odoo_project_overview` | 项目列表 + 里程碑进度 |\n| `odoo_timesheet_log` | 记录工时 |\n\n### 销售 & 采购 & 财务\n| 工具 | 说明 |\n|------|------|\n| `odoo_sale_orders` | 查看销售订单 |\n| `odoo_purchase_orders` | 查看采购订单 |\n| `odoo_invoices` | 查看发票/账单（支持逾期筛选） |\n\n### 客服\n| 工具 | 说明 |\n|------|------|\n| `odoo_tickets` | 查看客服工单 |\n| `odoo_ticket_create` | 创建客服工单 |\n\n### 联系人（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_contacts` | 查询联系人/客户/供应商 |\n| `odoo_contact_create` | 创建联系人/客户/供应商 |\n\n### 库存（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_stock_levels` | 查看库存水平 |\n| `odoo_stock_pickings` | 查看调拨单/出入库单 |\n\n### HR 人事（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_employees` | 查询员工列表 |\n| `odoo_leaves` | 查看请假记录 |\n| `odoo_attendances` | 查看考勤打卡记录 |\n\n### 审批（v1.2 新增）\n| 工具 | 说明 |\n|------|------|\n| `odoo_approvals` | 查看审批请求 |\n\n### 助手\n| 工具 | 说明 |\n|------|------|\n| `odoo_search` | 通用搜索（任意模型任意条件） |\n| `odoo_daily_briefing` | 实施经理每日工作概况 |\n\n---\n\n## WeCom 动态 Agent 多用户隔离\n\n搭配 `@huo15/wecom` 插件的动态 agent 能力，每个企微用户/群组拥有独立的辉火云连接：\n\n1. **凭据隔离** — 用户 A 的辉火云账号密码，用户 B 看不到也用不了\n2. **Session 隔离** — 每个用户各自的辉火云 session，互不干扰\n3. **数据隔离** — 每个用户看到的是自己辉火云账号的数据\n4. **自动恢复** — 每个用户的凭据独立持久化，重启后自动恢复\n\n**实现原理**：\n- 工具通过 `ctx.agentId` 获取当前用户的动态 agent ID（如 `wecom-acct-ws-dm-zhangsan`）\n- 配置持久化到 `~/.openclaw/plugin-configs/odoo/{agentId}.json`\n- OdooClient 和 NotificationPoller 均按 agentId 隔离存储\n\n---\n\n## 使用示例\n\n```\n👤 帮我连接公司系统\n🦞 好的，请提供：1) 系统地址 2) 用户名 3) 密码\n\n👤 地址 https://erp.huo15.com，用户名 zhang@huo15.com，密码 xxx\n🦞 已成功连接到 erp.huo15.com（数据库: huo15），欢迎使用辉火云企业套件！\n\n👤 今天有什么工作？\n🦞 汇总：3个待办任务、2个到期活动、1个紧急工单、华为商机需跟进...\n\n👤 帮我创建任务：明天发报价单给华为\n🦞 已创建任务 #456，截止日期 2026-04-13\n\n👤 查看我的商机\n🦞 你有 5 个活跃商机：华为ERP项目（报价阶段，50万）...\n\n👤 商机 #88 赢了\n🦞 已标记商机 #88 为赢单\n\n👤 有哪些客户还没付款\n🦞 3张未付发票：华为 ¥12,000（逾期15天）...\n\n👤 查下产品A还有多少库存\n🦞 产品A 库存：上海仓 120 件、北京仓 45 件\n\n👤 研发部有哪些员工\n🦞 研发部共 8 人：张三（前端）、李四（后端）...\n```\n\n---\n\n## 通知同步\n\n插件连接后自动轮询（默认 30 秒），推送以下变更：\n\n| 通道 | 触发条件 |\n|------|---------|\n| todo | 我的任务有新增或更新 |\n| activity | 今日到期活动 |\n| message | 新 Chatter 消息 |\n| email（可选）| 新邮件通知 |\n| calendar（可选）| 今明两天内的新日历事件 |\n\n---\n\n## 技术架构\n\n- **JSON-RPC 对接** — 通过 `/web/session/authenticate` 和 `/web/dataset/call_kw` 与辉火云后端通信\n- **Per-Agent 隔离** — 按 `ctx.agentId` 隔离 OdooClient / Poller / Config，兼容 WeCom 动态 agent\n- **数据库自动检测** — `/web/database/list` 查询可用数据库，单库自动选择\n- **Session 自动重连** — `ensureAuthenticated()` 在轮询前自动检查并恢复 session\n- **高水位线去重** — 消息/邮件用 `id > highWaterMark` 去重，避免时钟偏差问题\n- **基线初始化** — 首次启动静默建立水位线，不推送历史数据\n- **OpenClaw 插件规范** — `definePluginEntry` + `api.registerTool()` + `api.on(\"before_prompt_build\")`\n\n---\n\n## 常见问题\n\n**Q: 连接失败怎么办？**\nA: 检查 URL（末尾不带斜杠）、账号密码。用 `odoo_status` 查看当前状态。数据库名一般不用手动填，插件会自动检测。\n\n**Q: WeCom 多用户场景下，每个用户都要单独连接吗？**\nA: 是的。每个企微用户首次使用辉火云企业套件功能时会被引导输入自己的系统地址和账号密码，之后自动保存，无需重复输入。\n\n**Q: 每日概况失败提示没有 helpdesk 模块？**\nA: 系统中未安装 Helpdesk 模块时，工单部分会自动跳过，其他项正常返回。\n\n**Q: 商机阶段 ID 怎么获取？**\nA: 通过 `odoo_search(model=\"crm.stage\")` 查询所有 CRM 阶段及其 ID。\n\n**Q: 如何断开连接并清除保存的密码？**\nA: 告诉龙虾\"断开辉火云连接\"，会调用 `odoo_disconnect` 清除当前用户的凭据。\n\n---\n\n## Changelog\n\n- **v1.2.0** — Per-agent 凭据隔离（WeCom 多用户）、智能连接引导、数据库自动检测、联系人/客户管理、库存查询（stock.quant/stock.picking）、HR 员工/考勤/请假、审批流查询、odoo_disconnect 工具。共 32 个工具\n- **v1.1.0** — CRM 商机管道、项目里程碑、工时记录、销售/采购订单、Helpdesk 工单、发票/逾期账款查询、任务状态更新、活动类型查询、实施经理每日概况\n- **v1.0.0** — 基础版：待办/任务、活动提醒、日历事件、消息/邮件、通用搜索、后台轮询\n\n---\n\n## License\n\nMIT\n\n---\n\n\n\n| 🏫 教学机构 | 👨🏫 讲师 | 📧 联系方式 | 💬 QQ群 | 📺 配套视频 |\n|:-----------:|:--------:|:------------------:|:-----------:|:-----------------------------------:|\n| 逸寻智库 | Job | support@huo15.com\n\nArchive v1.1.1: 12 files, 31225 bytes\n\nFiles: index.ts (47848b), openclaw.plugin.json (1854b), package.json (1030b), README.md (7330b), SKILL.md (8995b), src/modules/config-manager.ts (1868b), src/modules/notification-poller.ts (9267b), src/modules/odoo-client.ts (22021b), src/types/index.ts (1898b), src/utils/date-utils.ts (2296b), tsconfig.json (483b), _meta.json (139b)\n\nArchive v1.1.0: 11 files, 26794 bytes\n\nFiles: index.ts (46412b), openclaw.plugin.json (1854b), package.json (1027b), SKILL.md (8995b), src/modules/config-manager.ts (1868b), src/modules/notification-poller.ts (9267b), src/modules/odoo-client.ts (21210b), src/types/index.ts (1898b), src/utils/date-utils.ts (2296b), tsconfig.json (483b), _meta.json (139b)","readmeExcerpt":"Skill: Huo15 Huihuoyun Odoo Owner: zhaobod1 Summary: 自然语言操作 辉火云企业套件 — 实施经理助手，覆盖任务/CRM/项目/工单/财务/销售/HR/库存/生产/客服/知识/Studio 元编程 13 业务域 204 个工具。v1.23.0 默认权限模型反转：odoo_connect 默认按 sender_id 隔离（每个企微/钉钉/飞书成员配自己的 Odoo 账号... Tags: latest:1.23.2, plugin:1.23.0 Version history: v1.23.2 | 2026-05-10T18:40:32.216Z | auto - 新增 CHANGELOG.md 文件，便于追踪历史变更 - 更新 package.json（细节未公开） - 文档完整性增强，历史版本变更信息更清晰可查 v1.23.0 | 2026-05-07T09:19:51.849","codeSnippets":[],"executableExamples":[{"language":"json","snippet":"{\n \"odoo\": {\n \"url\": \"https://www.huo15.com\",\n \"db\": \"huo15\",\n \"username\": \"admin@huo15.com\",\n \"password\": \"your-password\"\n },\n \"sync\": {\n \"enabled\": true,\n \"intervalSeconds\": 30,\n \"channels\": [\"todo\", \"activity\", \"message\", \"email\", \"calendar\"]\n }\n}"},{"language":"bash","snippet":"openclaw plugins install @huo15/huo15-huihuoyun-odoo"},{"language":"bash","snippet":"openclaw restart"},{"language":"json","snippet":"{\n \"odoo\": {\n \"url\": \"https://www.huo15.com\",\n \"db\": \"huo15\",\n \"username\": \"admin@huo15.com\",\n \"password\": \"your-password\"\n },\n \"sync\": {\n \"enabled\": true,\n \"intervalSeconds\": 30,\n \"channels\": [\"todo\", \"activity\", \"message\", \"email\", \"calendar\"]\n }\n}"},{"language":"text","snippet":"👤 帮我连接公司系统\n🦞 好的，请提供：1) 系统地址 2) 用户名 3) 密码\n\n👤 地址 https://erp.huo15.com，用户名 zhang@huo15.com，密码 xxx\n🦞 已成功连接到 erp.huo15.com（数据库: huo15），欢迎使用辉火云企业套件！\n\n👤 今天有什么工作？\n🦞 汇总：3个待办任务、2个到期活动、1个紧急工单、华为商机需跟进...\n\n👤 帮我创建任务：明天发报价单给华为\n🦞 已创建任务 #456，截止日期 2026-04-13\n\n👤 查看我的商机\n🦞 你有 5 个活跃商机：华为ERP项目（报价阶段，50万）...\n\n👤 商机 #88 赢了\n🦞 已标记商机 #88 为赢单\n\n👤 有哪些客户还没付款\n🦞 3张未付发票：华为 ¥12,000（逾期15天）...\n\n👤 查下产品A还有多少库存\n🦞 产品A 库存：上海仓 120 件、北京仓 45 件\n\n👤 研发部有哪些员工\n🦞 研发部共 8 人：张三（前端）、李四（后端）..."},{"language":"ts","snippet":"const ODOO_TOOL_TIERS = {\n minimal: new Set([...]), // 10 个：连接 + 最核心任务\n core: new Set([...]), // 30 个：覆盖 80% 日常需求（默认）\n // extended: null = 全部 190 个（v1.19 行为）\n};"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: huo15-claude-odoo\ndisplayName: 火一五·辉火云企业套件插件\ndescription: 自然语言操作 辉火云企业套件 — 实施经理助手，覆盖任务/CRM/项目/工单/财务/销售/HR/库存/生产/客服/知识/Studio 元编程 13 业务域 204 个工具。v1.23.0 默认权限模型反转：odoo_connect 默认按 sender_id 隔离（每个企微/钉钉/飞书成员配自己的 Odoo 账号，与内部 RBAC 对齐 — 销售看销售的、管理员看管理员的）；旧 private 参数标 deprecated，新参数 shared（默认 false）；prompt 加附件硬规则（不替用户判断附件内容相符性）。继承 v1.22 record_id+include_lines / v1.21 hook RPC 永久挂修复 / v1.20 审批工作流。Use when：接 Odoo/辉火云、企业 ERP 操作、CRM/任务/财务/销售/工单管理、自然语言企微/钉钉调用 ERP、写销售/采购合同需要订单明细。\nversion: 1.23.0\n---\n\n# 辉火云企业套件插件使用指南\n\nOpenClaw 龙虾的辉火云企业套件插件。连接后即可用自然语言全面操作辉火云系统，\n尤其适合**实施经理、项目经理、销售经理**的日常工作场景。\n\n---\n\n## 首次配置（v1.23 默认按 sender_id 隔离 — 每人配自己的）\n\n### 方式一：通过对话连接（推荐）\n\n每位同事 @ 机器人时各自配一次自己的辉火云账号：\n\n> 帮我连接辉火云企业套件，地址 https://www.huo15.com，数据库 huo15，账号 你自己的邮箱@huo15.com，密码 xxxxxx\n\n龙虾自动调 `odoo_connect`，**默认按当前 sender_id 隔离保存**到 `~/.openclaw/plugin-configs/odoo/{agentId}.json`，与 Odoo 内部 RBAC 对齐 —— 销售看销售的、管理员看管理员的，不再共用同一账号。\n\n### 「为什么不默认全员共用？」\n\nv1.10–v1.22 默认全员共享一套凭据，结果 Odoo 内部权限失效（不管你是销售还是管理员，看到的数据完全一样）。v1.23 起反转：**每个 sender_id 用自己的账号 = 权限按 Odoo 用户区分**。这是绝大多数企业期望的协作模型。\n\n### 方式二：组织共用一个公共账号（少数场景）\n\n仅当组织内只有一个 Odoo 公共只读账号、所有同事都用它访问相同数据时：\n\n> 帮我连接辉火云，组织内大家共用这个账号：…，请保存为共享配置\n\nLLM 会调 `odoo_connect(shared=true)` 写入 `default.json`，作为兜底 fallback。**注意**：此时 Odoo RBAC 失效，所有人看到的数据完全一致。\n\n### 方式二：通过 openclaw.plugin.json 预配置\n\n```json\n{\n \"odoo\": {\n \"url\": \"https://www.huo15.com\",\n \"db\": \"huo15\",\n \"username\": \"admin@huo15.com\",\n \"password\": \"your-password\"\n },\n \"sync\": {\n \"enabled\": true,\n \"intervalSeconds\": 30,\n \"channels\": [\"todo\", \"activity\", \"message\", \"email\", \"calendar\"]\n }\n}\n```\n\n---\n\n## ⭐ 实施经理每日概况\n\n每天早上第一句话：\n\n> 今天有什么工作？\n\n龙虾会一次性汇总：\n\n| 类别 | 内容 |\n|------|------|\n| 📋 今日截止任务 | project.task 今日 deadline |\n| ⏰ 活动提醒 | 今日及逾期的 mail.activity |\n| 🎫 待处理工单 | 指派给我的 helpdesk.ticket |\n| 💰 逾期应收 | 未付款且已逾期的 account.move |\n| 🏆 商机跟进 | 需要今日跟进的 crm.lead |\n| 💬 未读消息 | mail.message 未读数 |\n\n---\n\n## 待办 / 任务\n\n| 你说 | 龙虾做什么 |\n|------|-----------|\n| 帮我写个待办 | 追问标题后创建任务（project.task） |\n| 帮我创建任务：明天发报价单给华为 | 直接创建，截止日期设为明天 |\n| 紧急待办：处理生产故障 | 创建优先级=3（紧急）的任务 |\n| 看看我的待办 | 列出我的全部待办 |\n| 我今天有什么要做的 | 列出今日截止任务 + 今日活动 |\n| 把任务 #123 标记完成 | 更新 state = 1_done |\n| 把任务 #123 截止日期改到下周五 | 更新 date_deadline |\n| 任务 #123 调高优先级为紧急 | 更新 priority = 3 |\n\n---\n\n## 活动提醒\n\n活动（mail.activity）关联到具体的辉火云记录（任务、商机、客户等）。\n\n| 你说 | 龙虾做什么 |\n|------|-----------|\n| 提醒我明天开会 | 创建活动提醒，截止明天 |\n| 帮我在客户 #42 上设一个跟进提醒 | 在 res.partner #42 创建活动 |\n| 查看我今天有哪些活动 | 列出今日到期活动 |\n| 查看逾期提醒 | 列出今日及逾期活动 |\n| 有哪些活动类型 | 调用 odoo_activity_types |\n\n> 常用 activity_type_id：4=待办、1=邮件、2=电话、3=会议（具体以系统为准，可通过 odoo_activity_types 查询）\n\n---\n\n## 日历 / 会议\n\n| 你说 | 龙虾做什么 |\n|------|-----------|\n| 安排一个会议 | 追问主题和时间后创建 calendar.event |\n| 明天上午10点安排产品评审会，持续1小时 | 创建 10:00~11:00 |\n| 下午2点约华为团队开会 | 创建 14:00~15:00 |\n| 查看我的日程安排 | odoo_search(model=\"calendar.event\") |\n\n---\n\n## CRM 商机管理\n\n| 你说 | 龙虾做什么 |\n|------|-----------|\n| 查看我的商机 | 查看我的商机管道 |\n| 查看全部销售人员的商机 | odoo_crm_pipeline(all_users=true) |\n| 新建一个商机：华为 ERP 项目 | 创建商机，追问金额/阶段 |\n| 把商机 #88 推进到下一阶段 | 更新 stage_id |\n| 把商机 #88 赢了 | 调用 odoo_crm_won |\n"},{"path":"README.md","content":"# 火一五·辉火云企业套件插件\n\n---\n\n
\n\n
![\"火一五Logo\"](\"https://tools.huo15.com/uploads/images/system/logo-colours.png\")
\n\n
\n\n
\n\n
打破信息孤岛，用一套系统驱动企业增长
\n加速企业用户向全场景人工智能机器人转变
\n\n\n
\n\n| 🏫 教学机构 | 👨🏫 讲师 | 📧 联系方式 | 💬 QQ群 | 📺 配套视频 |\n|:-----------:|:--------:|:------------------:|:-----------:|:-----------------------------------:|\n| 逸寻智库 | Job | support@huo15.com | 1093992108 | [📺 B站视频](https://space.bilibili.com/400418085) |\n\n
\n---\n\n## 简介\n\n**火一五·辉火云企业套件插件** 是 [OpenClaw](https://github.com/nicepkg/openclaw) 的辉火云企业套件适配插件，让你用自然语言全面操作辉火云企业套件。尤其适合**实施经理、项目经理、销售经理**的日常工作场景。\n\n连接后，龙虾 AI Agent 即可帮你管理待办、跟进商机、查看工单、核对账款、记录工时、查库存、看员工——一句话搞定。\n\n### 核心特性\n\n- **Per-Agent 凭据隔离** — 搭配 WeCom 动态 agent，每个企微用户拥有独立的辉火云凭据，互不干扰\n- **智能连接引导** — 首次使用自动引导输入系统地址、用户名、密码；数据库自动检测\n- **实施经理每日概况** — 一句\"今天有什么工作？\"汇总任务、活动、工单、逾期账款、商机、未读消息\n- **待办 & 任务** — 创建、列表、更新状态/优先级/截止日期\n- **CRM 商机管道** — 查看/创建/推进/赢单/输单\n- **项目 & 里程碑** — 项目进度总览、里程碑完成率、工时记录\n- **客服工单** — 查看/创建 Helpdesk 工单\n- **销售 & 采购** — 查看销售订单、采购订单\n- **财务发票** — 发票查询、逾期应收账款筛选\n- **联系人/客户** — 查询/创建联系人、客户、供应商\n- **库存管理** — 库存水平查询、调拨单/出入库单\n- **HR 人事** — 员工查询、考勤打卡记录、请假记录\n- **审批流** — 查看审批请求\n- **活动提醒** — 创建活动、查看今日到期/逾期活动\n- **日历会议** — 创建日历事件\n- **消息 & 邮件** — 未读消息查看、Chatter 消息发送\n- **通用搜索** — 搜索任意辉火云数据模型（客户、产品、员工、库存...）\n- **后台通知同步** — 自动轮询推送新任务/活动/消息/邮件/日历变更\n\n---\n\n## 一键安装\n\n```bash\nopenclaw plugins install @huo15/huo15-huihuoyun-odoo\n```\n\n重启 OpenClaw 生效：\n\n```bash\nopenclaw restart\n```\n\n---\n\n## 首次配置\n\n### 方式一：通过对话连接（推荐）\n\n用户只需说一句话，插件会自动引导：\n\n> 帮我连接公司系统\n\n龙虾会依次询问：系统地址、用户名、密码。数据库自动检测（单库自动连接，多库让你选择）。\n\n连接信息按 agent 隔离保存，下次使用自动恢复，无需重新输入。\n\n### 方式二：通过 openclaw.plugin.json 预配置\n\n```json\n{\n \"odoo\": {\n \"url\": \"https://www.huo15.com\",\n \"db\": \"huo15\",\n \"username\": \"admin@huo15.com\",\n \"password\": \"your-password\"\n },\n \"sync\": {\n \"enabled\": true,\n \"intervalSeconds\": 30,\n \"channels\": [\"todo\", \"activity\", \"message\", \"email\", \"calendar\"]\n }\n}\n```\n\n---\n\n## 工具列表（32 个）\n\n### 基础\n| 工具 | 说明 |\n|------|------|\n| `odoo_connect` | 连接辉火云企业套件（db 可选，自动检测） |\n| `odoo_status` | 检查连接状态和轮询状态 |\n| `odoo_disconnect` | 断开连接并清除已保存凭据 |\n\n### 任务 & 活动\n| 工具 | 说明 |\n|------|------|\n| `odoo_create_task` | 创建待办任务 |\n| `odoo_list_tasks` | 查看待办列表（支持 today_only/state 筛选） |\n| `odoo_update_task` | 更新任务（状态/阶段/截止日期/优先级） |\n| `odoo_create_activity` | 创建活动提醒（关联到记录） |\n| `odoo_list_activities` | 查看今日及逾期活动 |\n| `odoo_activity_types` | 查询活动类型列表 |\n| `odoo_create_event` | 创建日历事件/会议 |\n\n### 消息\n| 工具 | 说明 |\n|------|------|\n| `odoo_get_messages` | 查看未读消息/邮件通知 |\n| `odoo_send_message` | 向记录发送 Chatter 消息 |\n\n### CRM\n| 工具 | 说明 |\n|------|------|\n| `odoo_crm_pipeline` | 查看商机管道 |\n| `odoo_crm_create` | 创建商机/线索 |\n| `odoo_crm_update` | 更新商机信息 |\n| `odoo_crm_won` | 标记赢单 |\n| `odoo_crm_lost` | 标记输单 |\n\n### 项目 & 工时\n| 工具 | 说明 |\n|------|------|\n| `odoo_project_overview` | 项目列表 + 里程碑进度 |\n| `odoo_timesheet_log` | 记录工时 |\n\n### 销售 & 采购 & 财务\n| 工具 | 说明 |\n"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn7byevkn40d6z4p7ghdb097z983tj33\",\n \"slug\": \"huo15-huihuoyun-odoo\",\n \"version\": \"1.23.2\",\n \"publishedAt\": 1778438432216\n}"},{"path":"CHANGELOG-v1.19.md","content":"# v1.19.0 (2026-04-28)\n\n**核心修复：消除每次 prompt 注入 ~7900 字 / ~2000 tokens 的工具表，TTFT（首字延迟）实测降幅显著。**\n\n## 背景\n\n诊断发现 `before_prompt_build` hook 在每次 LLM call 之前都注入 ~7900 字的工具速查 + 自然语言映射表到 system context（[index.ts:5212-5489](index.ts#L5212)）。\n\n**用户感受**：哪怕只发\"你好\"也注入这 2000 tokens。LLM 处理这堆 prompt + reasoning thinking 一起拖到 TTFT 70-150 秒。\n\n实测 14:33-14:35 dispatch 拆解：\n- dispatch-start → first deliver-block = **129 秒**\n- 大头是 LLM TTFT 72 秒（首字延迟）\n- 加上 plugin 多次 reload 拖累 ~17 秒\n\n## 改动\n\n### 删 — system context 7900 字 → 1500 字\n\n[index.ts](index.ts) 的 `registerHooks` 函数中 `appendSystemContext` 模板字面量整体重写：\n\n| 删 | 改成 |\n|---|---|\n| 工具速查（共 77 个）整段 6500 字 | 只保留 6 行高频工具速查（任务 / CRM / 项目 / 客服 / 财务 / 联系人 / 检索 / 状态） |\n| 自然语言 → 工具映射 130+ 行 8000+ 字 | 全删（让 LLM 自己推断意图，识别不出再调 odoo_help） |\n| 常用数据模型 26 个 | 缩到 14 个最常用 |\n| 日期 & 字段规范 6 条 | 保留全部（这部分对 LLM 调用工具时仍重要，但本身只 200 字） |\n\n最终 system context 注入约 1500 字 / ~400 tokens。\n\n### 加 — `odoo_help` 工具（按需查工具表）\n\n新增 `api.registerTool({ name: 'odoo_help', ... })`，参数：\n\n- 无参数 → 返回完整 7900 字工具表 + 自然语言映射 + 数据模型清单\n- `keyword=\"<模糊词>\"` → 行级模糊匹配（如 `\"请假\"` 返回所有请假相关工具行；`\"CRM\"` 返回 CRM 分类）\n\nLLM 在不知道某意图对应哪个工具时**主动调 odoo_help**，把 token 消耗从\"每次 prompt 都付\"改成\"按需付\"。\n\n工具数从 189 → **190**。\n\n### 不改\n\n- 未连接路径的 system context（[index.ts:5176-5202](index.ts#L5176)）保留——那段本来就没工具表，只是连接引导\n- 189 工具的实现逻辑 / 接口 / 业务规则 全部不动\n- 共享凭据规则、品牌口径硬规则、用户/系统/凭据动态字段 全保留\n\n## 用户可见效果\n\n| 项 | v1.18 | v1.19 |\n|---|---|---|\n| 每次 prompt 注入 | ~7900 字 / ~2000 tokens | ~1500 字 / ~400 tokens |\n| TTFT 预期降幅 | — | -5 ~ -25 秒 |\n| 工具数 | 189 | 190 (+ odoo_help) |\n| LLM 调用工具的能力 | 完整可见 | 高频 8 个直接可见，其他通过 odoo_help 按需查 |\n\n## 风险与缓解\n\n- **风险**：LLM 看不到完整工具表可能导致它\"不知道某个工具存在\"\n- **缓解**：\n 1. system context 顶部明确告知\"完整 189 工具表调 odoo_help\"\n 2. odoo_help 工具的 description 写明 \"按需获取详细信息\"\n 3. 高频 8 个工具仍然在 system context 里直接可见，覆盖 80% 日常需求\n\n## 测试\n\n- `tsc --noEmit` exit 0（剩余 schema 字段警告是 v1.18 之前就存在的 SDK 类型定义问题，与本次改动无关）\n- 启动期 log 应从 `[odoo] 189 个工具已注册` 变为 `[odoo] 190 个工具已注册（v1.19 — 加 odoo_help 按需查工具表，system context 不再每次注入 ~7900 字）`\n- before_prompt_build 钩子注册 log 加 `v1.19 system context 已瘦身 ~6500 字 → 调 odoo_help 按需取详`\n\n## 兼容性\n\n完全向下兼容。所有 189 工具签名 / 行为 / 业务逻辑不变。LLM 端如果还期望从 system context 看完整工具表，调 odoo_help 即可恢复 v1.18 行为。"},{"path":"CHANGELOG-v1.20.md","content":"# v1.20.0 (2026-04-28)\n\n**核心修复：tier 分级让默认 prompt tool schema 从 ~190 工具 / ~17000 tokens 砍到 ~30 工具 / ~3000 tokens。配合 v1.19 的 system context 瘦身，每次 prompt 总省 ~16000 tokens。**\n\n## 背景\n\nv1.19 把 `before_prompt_build` 注入的 system context 从 7900 字砍到 1500 字（节省 ~1700 tokens）。但实测 `dispatch-start → deliver-start` TTFT 仍 70-150 秒。\n\n进一步诊断（直接 curl DeepSeek API）：\n\n| 测试 | 端到端时间 |\n|---|---|\n| DeepSeek 流式 TTFT | **530ms** |\n| DeepSeek 非流式（含响应） | **790ms** |\n\n→ DeepSeek API 端**完全没问题**。**真正的 TTFT 元凶是 prompt 太大**（单大头 = 189 个 odoo 工具的 JSON schema），LLM 端 prefill 处理 30k+ tokens 才出第一字。\n\n预估每个 odoo 工具 schema ≈ 80-200 tokens（name + description + properties + required）：\n\n- description 总和 16470 字符 / ~5490 tokens\n- 加 schema 结构（properties / required / type 等）×3-4 倍 → **15000-20000 tokens** 仅 odoo 一个 plugin\n\n## 改动\n\n### `index.ts` — 引入 tier 分级\n\n新增 `ODOO_TOOL_TIERS`（module-level 常量）：\n\n```ts\nconst ODOO_TOOL_TIERS = {\n minimal: new Set([...]), // 10 个：连接 + 最核心任务\n core: new Set([...]), // 30 个：覆盖 80% 日常需求（默认）\n // extended: null = 全部 190 个（v1.19 行为）\n};\n```\n\n`registerTools` 函数顶部读 plugin config：\n\n```ts\nconst cfg = (api.pluginConfig ?? {}) as { tier?: 'minimal' | 'core' | 'extended' };\nconst tier = cfg.tier ?? 'core'; // 默认 core\nconst allowedTools = tier === 'extended' ? null : ODOO_TOOL_TIERS[tier];\n\nconst register = (opts) => {\n if (allowedTools === null || allowedTools.has(opts.name) || opts.name === 'odoo_help') {\n api.registerTool(opts);\n registeredCount++;\n } else {\n skippedCount++;\n }\n};\n```\n\n然后 sed 把 489-5500 行内 189 个 `api.registerTool(` 替换为 `register(` —— **所有 189 个工具走 register wrapper 过滤**。\n\n`odoo_help` 工具**始终注册**（任何 tier），保证 LLM 能查完整工具表。\n\n### `index.ts` — system context 提示当前 tier\n\n将 v1.19 的 \"完整 189 个工具表 …\" 提示更新为 \"**当前 tier=core（默认 30 个高频工具直接可见）。完整 190 个工具调 odoo_help 查；如需恢复 v1.18 全量行为：改 ~/.openclaw/openclaw.json 的 plugins.entries.odoo.config.tier='extended'**\"。\n\n### `index.ts` — 启动期 log 报告 tier 状态\n\n```\nv1.18: [odoo] 189 个工具已注册（v1.18 — Studio 元编程+审计...）\nv1.19: [odoo] 190 个工具已注册（v1.19 — 加 odoo_help...）\nv1.20: [odoo] 30 个工具已注册（v1.20 — tier=core 精简档位 / 跳过 160 个，节省 ~12800 tokens schema）\n 完整 190 工具调 odoo_help 查；改 plugins.entries.odoo.config.tier=\"extended\" 可恢复全量。\n```\n\n## tier 三档\n\n### `minimal`（10 工具）\n\n仅最核心连接 + 任务搜索：\n```\nodoo_connect / odoo_status / odoo_disconnect / odoo_whoami / odoo_help\nodoo_create_task / odoo_list_tasks / odoo_my_today\nodoo_search / odoo_daily_briefing\n```\n\n适合：极致性能，仅做\"连接 + 任务列表\"演示场景。\n\n### `core`（30 工具，默认）\n\n覆盖 80% 日常需求的高频 30 个：\n\n- 连接 & 状态（5）：odoo_connect / odoo_status / odoo_disconnect / odoo_whoami / odoo_help\n- 任务 & 活动（8）：odoo_create_task / odoo_list_tasks / odoo_update_task / odoo_my_today / odoo_my_workload / odoo_create_activity / odoo_calendar_today / odoo_complete_activity\n- CRM（5）：odoo_crm_pipeline / odoo_crm_create / odoo_crm_update / odoo_crm_won / odoo_crm_lost\n- 项目（2）：odoo_project_overview / odoo_timesheet_log\n- 客服（2）：odoo_tickets / odoo_ticket_create\n- 财务（3）：odoo_invoices / odoo_sale_orders / odoo_purchase_orders\n- 联系人（2）：odoo_c"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"自然语言操作 辉火云企业套件 — 实施经理助手，覆盖任务/CRM/项目/工单/财务/销售/HR/库存/生产/客服/知识/Studio 元编程 13 业务域 204 个工具。v1.23.0 默认权限模型反转：odoo_connect 默认按 sender_id 隔离（每个企微/钉钉/飞书成员配自己的 Odoo 账号... Skill: Huo15 Huihuoyun Odoo Owner: zhaobod1 Summary: 自然语言操作 辉火云企业套件 — 实施经理助手，覆盖任务/CRM/项目/工单/财务/销售/HR/库存/生产/客服/知识/Studio 元编程 13 业务域 204 个工具。v1.23.0 默认权限模型反转：odoo_connect 默认按 sender_id 隔离（每个企微/钉钉/飞书成员配自己的 Odoo 账号... Tags: latest:1.23.2, plugin:1.23.0 Version history: v1.23.2 | 2026-05-10T18:40:32.216Z | auto - 新增 CHANGELOG.md 文件，便于追踪历史变更 - 更新 package.json（细节未公开） - 文档完整性增强，历史版本变更信息更清晰可查 v1.23.0 | 2026-05-07T09:19:51.849","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1284,"uniquenessScore":46,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T01:13:10.771Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T01:13:10.771Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T03:58:07.858Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}
![\"逸寻智库公众号二维码\"](\"https://tools.huo15.com/uploads/images/system/qrcode_yxzk.jpg\")
\n\n