辉火云企业套件插件使用指南#

OpenClaw 龙虾的辉火云企业套件插件。连接后即可用自然语言全面操作辉火云系统， 尤其适合 实施经理、项目经理、销售经理 的日常工作场景。

---

首次配置（v1.23 默认按 sender_id 隔离 — 每人配自己的）#

方式一：通过对话连接（推荐）#

每位同事 @ 机器人时各自配一次自己的辉火云账号：

帮我连接辉火云企业套件，地址 https://www.huo15.com，数据库 huo15，账号 你自己的邮箱@huo15.com，密码 xxxxxx

龙虾自动调 odoo_connect， 默认按当前 sender_id 隔离保存 到 ~/.openclaw/plugin-configs/odoo/{agentId}.json，与 Odoo 内部 RBAC 对齐 —— 销售看销售的、管理员看管理员的，不再共用同一账号。

「为什么不默认全员共用？」#

v1.10–v1.22 默认全员共享一套凭据，结果 Odoo 内部权限失效（不管你是销售还是管理员，看到的数据完全一样）。v1.23 起反转： 每个 sender_id 用自己的账号 = 权限按 Odoo 用户区分。这是绝大多数企业期望的协作模型。

方式二：组织共用一个公共账号（少数场景）#

仅当组织内只有一个 Odoo 公共只读账号、所有同事都用它访问相同数据时：

帮我连接辉火云，组织内大家共用这个账号：…，请保存为共享配置

LLM 会调 odoo_connect(shared=true) 写入 default.json，作为兜底 fallback。 注意：此时 Odoo RBAC 失效，所有人看到的数据完全一致。

方式二：通过 openclaw.plugin.json 预配置#

json

{
  "odoo": {
    "url": "https://www.huo15.com",
    "db": "huo15",
    "username": "admin@huo15.com",
    "password": "your-password"
  },
  "sync": {
    "enabled": true,
    "intervalSeconds": 30,
    "channels": ["todo", "activity", "message", "email", "calendar"]
  }
}

---

⭐ 实施经理每日概况#

每天早上第一句话：

今天有什么工作？

龙虾会一次性汇总：

类别内容📋 今日截止任务project.task 今日 deadline⏰ 活动提醒今日及逾期的 mail.activity🎫 待处理工单指派给我的 helpdesk.ticket💰 逾期应收未付款且已逾期的 account.move🏆 商机跟进需要今日跟进的 crm.lead💬 未读消息mail.message 未读数

---

待办 / 任务#

你说龙虾做什么帮我写个待办追问标题后创建任务（project.task）帮我创建任务：明天发报价单给华为直接创建，截止日期设为明天紧急待办：处理生产故障创建优先级=3（紧急）的任务看看我的待办列出我的全部待办我今天有什么要做的列出今日截止任务 + 今日活动把任务 #123 标记完成更新 state = 1_done把任务 #123 截止日期改到下周五更新 date_deadline任务 #123 调高优先级为紧急更新 priority = 3

---

活动提醒#

活动（mail.activity）关联到具体的辉火云记录（任务、商机、客户等）。

你说龙虾做什么提醒我明天开会创建活动提醒，截止明天帮我在客户 #42 上设一个跟进提醒在 res.partner #42 创建活动查看我今天有哪些活动列出今日到期活动查看逾期提醒列出今日及逾期活动有哪些活动类型调用 odoo_activity_types

常用 activity_type_id：4=待办、1=邮件、2=电话、3=会议（具体以系统为准，可通过 odoo_activity_types 查询）

---

日历 / 会议#

你说龙虾做什么安排一个会议追问主题和时间后创建 calendar.event明天上午10点安排产品评审会，持续1小时创建 10:0011:00下午2点约华为团队开会创建 14:0015:00查看我的日程安排odoo_search(model="calendar.event")

---

CRM 商机管理#

你说龙虾做什么查看我的商机查看我的商机管道查看全部销售人员的商机odoo_crm_pipeline(all_users=true)新建一个商机：华为 ERP 项目创建商机，追问金额/阶段把商机 #88 推进到下一阶段更新 stage_id把商机 #88 赢了调用 odoo_crm_won商机 #88 输了调用 odoo_crm_lost商机 #88 预计收入改为 50 万更新 expected_revenue查看 CRM 各阶段odoo_search(model="crm.stage")

---

项目管理#

你说龙虾做什么项目进展如何查看所有项目列表 + 里程碑「辉火云实施」项目进度查看指定项目 + 其里程碑里程碑完成了多少返回每个里程碑的 done_tasks/task_count今天记录了3小时的需求分析工时创建工时记录 3h在任务 #55 上记录 2 小时工时关联任务的工时记录

---

客服工单（Helpdesk）#

你说龙虾做什么查看我的工单列出指派给我的工单查看紧急工单odoo_tickets(priority="3")帮我提交一个问题：系统登录失败创建 helpdesk.ticket客户华为的工单odoo_tickets(partner_id=...)

---

销售 & 采购#

你说龙虾做什么查看销售订单列出有效销售订单查看待确认的报价单odoo_sale_orders(state="draft")查看采购订单列出有效采购订单查询到货日期odoo_purchase_orders，查 planned_arrival

---

财务 / 发票#

你说龙虾做什么查看发票列出最近发票有哪些客户还没付款odoo_invoices(payment_state="not_paid")逾期应收账款odoo_invoices(overdue_only=true)查供应商账单odoo_invoices(move_type="in_invoice")

---

消息 / 邮件#

你说龙虾做什么查看我的消息列出未读 chatter 消息看看邮件通知列出收件箱未读通知给商机 #88 发条消息：正在跟进在 crm.lead #88 上发 chatter

---

通用搜索#

你说模型示例帮我查「华为」客户res.partnername ilike 华为查所有活跃项目project.projectactive=true查库存情况stock.quant—查员工列表hr.employee—查产品product.product—查活动类型mail.activity.type—查 CRM 阶段crm.stage—查工单阶段helpdesk.stage—

---

通知同步（后台轮询）#

插件启动后每 30 秒（可配置）自动检查：

通道触发条件todo我的任务有新增或更新activity今日到期活动message新 chatter 消息email（可选）新邮件通知calendar（可选）今明两天内的新日历事件

---

工具完整列表（23 个）#

基础#

工具说明odoo_connect连接辉火云企业套件odoo_status检查连接状态和轮询状态

任务 & 活动#

工具说明odoo_create_task创建待办任务odoo_list_tasks查看待办列表（支持 today_only/state 筛选）odoo_update_task更新任务（状态/阶段/截止日期/优先级）odoo_create_activity创建活动提醒（关联到记录）odoo_list_activities查看今日及逾期活动odoo_activity_types查询活动类型列表odoo_create_event创建日历事件/会议

消息#

工具说明odoo_get_messages查看未读消息/邮件通知odoo_send_message向记录发送 chatter 消息

CRM#

工具说明odoo_crm_pipeline查看商机管道odoo_crm_create创建商机/线索odoo_crm_update更新商机信息odoo_crm_won标记赢单odoo_crm_lost标记输单

项目 & 工时#

工具说明odoo_project_overview项目列表 + 里程碑进度odoo_timesheet_log记录工时

销售 & 采购 & 财务#

工具说明odoo_sale_orders查看销售订单odoo_purchase_orders查看采购订单odoo_invoices查看发票/账单（支持逾期筛选）

客服#

工具说明odoo_tickets查看客服工单odoo_ticket_create创建客服工单

搜索 & 助手#

工具说明odoo_search通用搜索（任意模型任意条件）odoo_daily_briefing⭐ 实施经理每日工作概况

---

常见问题#

Q: 连接失败怎么办？ A: 检查 URL（末尾不带斜杠）、数据库名（区分大小写）、账号密码。用 odoo_status 查看当前状态。

Q: 活动提醒需要哪些参数？ A: 必须提供 res_model（如 crm.lead）、 res_id（记录ID）、 activity_type_id、 date_deadline。 通过 odoo_activity_types 查询系统中的活动类型。

Q: 商机阶段 ID 怎么获取？ A: 通过 odoo_search(model="crm.stage") 查询所有 CRM 阶段及其 ID。

Q: 每日概况失败提示没有 helpdesk 模块？ A: 系统中未安装 Helpdesk 模块时，工单部分会自动跳过，其他项正常返回。

---

使用纪律（hard rules，给 LLM）#

附件 / 文件内容判断#

用户上传压缩包/文档/Excel 让你"建商机/任务/工单"等操作时：

1. 附件内容由用户负责。不要解读"内容是不是跟商机字段对得上"、"这文件像不像 ERP 数据"。即便附件是工厂排产、菜单、随便一个 PDF，也直接按用户意图建记录。
2. 解压/读附件 仅用于提取用户明示的字段（如用户说"客户名取里面表头第一行"），不主动做"内容相符性"判断后打回用户。
3. 正确工作流：先按用户口头说的字段（公司名/金额/阶段等）调 odoo_crm_create → 再用 odoo_attach_file 把附件挂到该 crm.lead → 回报"商机 #X 已创建并附上文件"。
4. 用户没说要看附件内容时 绝不主动解析后质疑 用户。常见错误回复：「我解压出来的内容跟商机对不上，你发错了吗？」 ❌ —— 这是越权。
5. 只有用户 明确问"这附件是什么"时才解读。

凭据隔离#

• 默认 sender_id 隔离 — 每个同事独立账号，权限按 Odoo 角色区分。
• 不主动建议"配一次全员通用"。仅当用户明确说"组织共用一个公共账号"才传 shared: true。
• 用户问"为什么我看不到 X"/"为什么权限不区分"——可能落到了 shared fallback，让对方各自调 odoo_connect 配自己账号即可。

---

Changelog#

• v1.23.0 — 默认权限模型反转：odoo_connect 默认按 sender_id 隔离（旧版默认全员 shared 导致 Odoo RBAC 失效）；新参数 shared（默认 false），旧 private 标 deprecated 仍兼容；prompt supplement 加附件硬规则（不替用户判断附件内容相符性，避免 LLM 解压看到内容跟"商机"字段对不上就打回用户的越权行为）；SKILL.md 同步说明
• v1.22.0 — odoo_sale_orders / odoo_purchase_orders 加 name + record_id + include_lines（写合同/对账免 N+1 RPC）+ description 强化防 LLM 走 exec/curl 手写 JSON-RPC
• v1.1.0 — CRM 商机管道（查询/创建/赢/输/更新）、项目里程碑、工时记录、销售/采购订单、Helpdesk 工单、发票/逾期账款查询、任务状态更新、活动类型查询、实施经理每日概况（odoo_daily_briefing）
• v1.0.0 — 基础版：待办/任务、活动提醒、日历事件、消息/邮件、通用搜索、后台轮询