备用 CLI¶
CLI 是一个轻量的 XML-RPC 客户端(仅需 Node.js,无需 Python)。当 MCP 服务器 无法在你的环境中运行时,或用于脚本的批量访问时,请使用它。 MCP 服务器仍然是主要且最完整的接口。
何时使用¶
- 你没有可用的
uv或 Python 3.11+。 - 你需要从终端或流水线进行可脚本化/批量的访问。
- 一个只有 Node 的受限环境。
安装¶
需要 Node.js 18+:
若缺失:nodejs.org(LTS)、brew install node 或
apt install nodejs npm。该命令会将 CLI 安装到 ~/.claude/tools/odoo-cli,
并写入一个包含你凭据的本地 .env。
用法¶
示例:
可用命令¶
CLI 包含 13 个命令,面向最常见的 Odoo 流程:
| 命令 | 作用 |
|---|---|
contacts |
查询联系人(res.partner) |
invoices |
查询发票 |
products |
查询产品 |
stock |
查询库存 |
subscriptions |
查询订阅 |
payments |
查询付款 |
account-lines |
会计明细行 |
bank-journals |
银行日记账 |
bank-statements |
银行对账单 |
chart-of-accounts |
会计科目表 |
search |
按模型/域进行通用搜索 |
fields |
一个模型的字段内省 |
write |
通用写入(创建/更新) |
写入
write 命令会 修改数据。与 MCP 服务器中一样,请使用最小权限的 Odoo
用户,并审查该操作。
与 MCP 服务器的对等性¶
CLI 通过 XML-RPC 覆盖了常见流程,但 不 包含 MCP 服务器完整的版本间兼容层, 也没有其对模型/字段的自动解析。对于版本间的工作或 Enterprise 实例, 请优先使用 MCP 服务器。
Skill 参考:/odoo-tools:odoo-setup-cli。