Odoo ERP 集成工具：CLI 与 JavaScript 库，实现自动化与脚本操作

odoo by marcfargas/odoo-toolbox

82 周安装量

25 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/marcfargas/odoo-toolbox --skill odoo

自动化 ERP 命令行工具

🇨🇳中文介绍

/odoo

Odoo ERP 集成。两种工作方式：CLI（适用于大多数任务的最快方式）和库（适用于脚本和自动化）。

两种使用 Odoo 的方式

CLI — 适用于大多数任务的最快方式

odoo CLI 允许您搜索、创建、更新和删除记录，无需编写任何代码。

# 1. 验证连接（始终首先执行此操作）
odoo config check

# 2. 搜索记录
odoo records search res.partner --fields name,email --limit 5

# 3. 创建记录
odoo records create res.partner --data '{"name":"Acme Corp"}' --confirm

# 4. 在记录上发布备注
odoo mail note crm.lead 42 "Called customer" --confirm

库 — 适用于脚本和自动化

import { createClient } from '@marcfargas/odoo-client';

const client = await createClient();  // 读取 ODOO_URL, ODOO_DB, ODOO_USER, ODOO_PASSWORD

const partners = await client.searchRead('res.partner', [['is_company', '=', true]], {
  fields: ['name', 'email'],
  limit: 10,
});

await client.mail.postInternalNote('crm.lead', 42, '<p>Called customer.</p>');
await client.modules.isModuleInstalled('sale');

快速开始

步骤 1：配置环境

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

Azure RBAC 权限管理工具：查找最小角色、创建自定义角色与自动化分配

135,700 周安装

GitHub Actions 官方文档查询助手 - 精准解答 CI/CD 工作流问题

45,200 周安装

通过 LiteLLM 代理让 Claude Code 对接 GitHub Copilot 运行 | 高级变通方案指南

44,900 周安装

代码	含义
`0`	成功
`1`	用法错误（错误的标志、缺少 `--confirm`、无效参数）
`2`	身份验证/网络错误（凭据错误、Odoo 无法访问）
`3`	未找到
`4`	权限被拒绝
`5`	验证错误（Odoo 拒绝了值）
`6`	冲突（例如，已打卡上班）
`10`	部分成功

CLI 命令	技能文档	描述
`odoo config check/show`	`cli/config.md`	验证连接，显示已解析的配置
`odoo records search/get/create/write/delete/count/call`	`cli/records.md`	对任何模型的通用 CRUD 操作
`odoo schema models/fields/describe/codegen`	`base/introspection.md`	发现模型和字段
`odoo modules list/install/uninstall/upgrade/info/status`	`base/modules.md`	管理 Odoo 模块
`odoo url record/portal`	`base/urls.md`	生成版本无关的记录 URL
`odoo mail note/post`	`mail/chatter.md`	在 chatter 上发布备注和消息
`odoo attendance clock-in/clock-out/status/list`	`modules/attendance.md`	员工打卡上班/下班
`odoo timesheets start/stop/running/log/list`	`modules/timesheets.md`	时间跟踪
`odoo accounting cash-accounts/cash-balance/posted-moves/trace-recon/days-to-pay`	`modules/accounting.md`	只读会计查询
`odoo state plan/apply/diff` ⚠	`cli/state.md`	实验性：状态管理

访问器	CLI 命令	描述	技能文档
`client.mail.*`	`odoo mail`	在 chatter 上发布备注和消息	`mail/chatter.md`
`client.modules.*`	`odoo modules`	安装、卸载、检查模块	`base/modules.md`
`client.urls.*`	`odoo url`	生成版本无关的记录 URL	`base/urls.md`
`client.properties.*`	—	属性字段的安全操作	`base/properties.md`
`client.cdc.*`	—	变更数据捕获 — 通过 mail.tracking.value 获取字段变更历史	`modules/cdc.md`
`client.accounting.*`	`odoo accounting`	现金发现、对账、合作伙伴解析	`modules/accounting.md`
`client.attendance.*`	`odoo attendance`	打卡上班/下班、出勤跟踪	`modules/attendance.md`
`client.timesheets.*`	`odoo timesheets`	计时器启动/停止、时间记录	`modules/timesheets.md`

操作	级别	备注
`client.search()`, `searchRead()`, `read()`, `searchCount()`	读取
`client.create()`	写入
`client.write()`	写入
`client.unlink()`	破坏性	永久删除
`client.call()`	可变	取决于方法 — 请查看每个技能的文档
`client.mail.postInternalNote()`	写入	仅内部使用，不发送电子邮件
`client.mail.postOpenMessage()`	破坏性	向关注者发送电子邮件（可能包含外部人员）
`client.modules.isModuleInstalled()`	读取
`client.modules.installModule()`	破坏性	模式变更，难以回滚
`client.modules.uninstallModule()`	破坏性	删除模块数据，不可逆
`client.properties.*`	写入	安全的属性更新，防止数据丢失
`client.accounting.*`	读取	所有会计助手均为只读
`client.timesheets.logTime()`, `startTimer()`, `stopTimer()`	写入
`client.attendance.*`	写入	打卡上班/下班
`client.urls.*`	读取	纯 URL 构造，无 RPC 调用

模块	CLI 覆盖	描述
introspection	`odoo schema`	发现模型和字段
crud	`odoo records`	创建、读取、更新、删除模式
search	`odoo records search`	搜索和过滤模式
properties	—	动态用户定义字段
modules	`odoo modules`	模块生命周期管理
urls	`odoo url`	版本无关的记录 URL 生成
multi-company	`odoo records search --context`	多公司上下文、`allowed_company_ids`、常见问题
translations	—	读取和写入字段翻译（Odoo 17+，`ir.translation` 已移除）
context-keys	`--context` 标志	邮件/chatter 上下文键：`tracking_disable`、`mail_notrack`、`mail_create_nolog` 等

模块	CLI 覆盖	描述
chatter	`odoo mail`	在记录上发布消息和备注（`client.mail.*`）
activities	—	安排和管理活动/任务
discuss	—	聊天频道和直接消息

技能	路径	CLI 命令	必需模块	描述
accounting	`modules/accounting.md`	`odoo accounting`	`account`	会计模式、现金流、对账、损益、验证
contracts	`modules/contracts.md`	—	`contract` (OCA)	周期性合同、计费计划、收入预测
attendance	`modules/attendance.md`	`odoo attendance`	`hr_attendance`	打卡上班/下班、出勤跟踪（`client.attendance.*`）
timesheets	`modules/timesheets.md`	`odoo timesheets`	`hr_timesheet`	计时器启动/停止、项目时间记录（`client.timesheets.*`）
mis-builder	`oca/mis-builder.md`	—	`mis_builder`, `date_range`, `report_xlsx`	MIS Builder — 读取、计算、导出报告
mis-builder-dev	`oca/mis-builder-dev.md`	—	`mis_builder`, `date_range`, `report_xlsx`	MIS Builder — 创建和编辑报告模板
product-configurator	`modules/product-configurator.md`	—	`sale_product_configurator`	销售行上的产品属性和变体 — `no_variant`、`price_extra`、自定义值

🇺🇸English

/odoo

Odoo ERP integration. Two ways to work: CLI (fastest for most tasks) and Library (for scripts and automation).

Two Ways to Work with Odoo

CLI — Fastest for Most Tasks

The odoo CLI lets you search, create, update, and delete records without writing any code.

# 1. Verify connection (always do this first)
odoo config check

# 2. Search records
odoo records search res.partner --fields name,email --limit 5

# 3. Create a record
odoo records create res.partner --data '{"name":"Acme Corp"}' --confirm

# 4. Post a note on a record
odoo mail note crm.lead 42 "Called customer" --confirm

Library — For Scripts and Automation

import { createClient } from '@marcfargas/odoo-client';

const client = await createClient();  // reads ODOO_URL, ODOO_DB, ODOO_USER, ODOO_PASSWORD

const partners = await client.searchRead('res.partner', [['is_company', '=', true]], {
  fields: ['name', 'email'],
  limit: 10,
});

await client.mail.postInternalNote('crm.lead', 42, '<p>Called customer.</p>');
await client.modules.isModuleInstalled('sale');

Quick Start

Step 1: Configure Environment

export ODOO_URL=https://mycompany.odoo.com
export ODOO_DB=mycompany
export ODOO_USER=admin
export ODOO_PASSWORD=yourpassword

Step 2: Verify Connection

odoo config check
# ✓ Connected to https://mycompany.odoo.com (db: mycompany)
#   User: Administrator (admin) [id: 2]
#   Installed modules: 143

Step 3: Explore

# Search for records
odoo records search res.partner --fields name,email --limit 10

# Introspect schema
odoo schema fields crm.lead --type many2one

# Check installed modules
odoo modules list --filter installed --search sale

CLI Exit Codes

All odoo CLI commands use these standard exit codes:

Code	Meaning
`0`	Success
`1`	Usage error (bad flags, missing `--confirm`, invalid arguments)
`2`	Auth / network error (wrong credentials, Odoo unreachable)
`3`	Not found
`4`	Permission denied
`5`

Use in scripts:

odoo records get crm.lead 42 || echo "Exit code: $?"

CLI Command Reference

CLI Command	Skill Doc	Description
`odoo config check/show`	`cli/config.md`	Verify connection, show resolved config
`odoo records search/get/create/write/delete/count/call`	`cli/records.md`	Generic CRUD on any model
`odoo schema models/fields/describe/codegen`	`base/introspection.md`	Discover models and fields

Library API

Service Accessors

Domain-specific helpers are accessed via lazy getters on the client:

Accessor	CLI Command	Description	Skill doc
`client.mail.*`	`odoo mail`	Post notes & messages on chatter	`mail/chatter.md`
`client.modules.*`	`odoo modules`	Install, uninstall, check modules	`base/modules.md`
`client.urls.*`

Core CRUD (searchRead, create, write, unlink, etc.) stays directly on client.

Safety Model

Operation	Level	Notes
`client.search()`, `searchRead()`, `read()`, `searchCount()`	READ
`client.create()`	WRITE
`client.write()`	WRITE
`client.unlink()`

Prerequisites (Must Read First)

Before any Odoo operation, load these foundational modules:

base/connection.md — createClient(), authentication, environment variables
base/field-types.md — Odoo type system (read/write asymmetry)
base/domains.md — Query filter syntax

Additional Modules

Load as needed by reading base/{name}.md:

Module	CLI Coverage	Description
introspection	`odoo schema`	Discover models & fields
crud	`odoo records`	Create, read, update, delete patterns
search	`odoo records search`	Search & filtering patterns
properties	—	Dynamic user-defined fields
modules	`odoo modules`	Module lifecycle management
urls

Mail & Messaging

Skills for Odoo's mail system. Load by reading mail/{name}.md:

Module	CLI Coverage	Description
chatter	`odoo mail`	Post messages and notes on records (`client.mail.*`)
activities	—	Schedule and manage activities/tasks
discuss	—	Chat channels and direct messages

Note: The mail module is part of base Odoo and is typically always installed.

Module-Specific Skills

Skills that require specific Odoo modules to be installed. Before loading, verify the required modules are present.

# CLI: check a module is installed
odoo modules status hr_attendance



// Library: check a module is installed
await client.modules.isModuleInstalled('hr_attendance')

Load by reading the path shown below:

Skill	Path	CLI Command	Required Modules	Description
accounting	`modules/accounting.md`	`odoo accounting`	`account`	Accounting patterns, cashflow, reconciliation, PnL, validation
contracts	`modules/contracts.md`	—	`contract` (OCA)	Recurring contracts, billing schedules, revenue projection
attendance

Weekly Installs

Repository

marcfargas/odoo-toolbox

GitHub Stars

First Seen

Feb 11, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

codex77

github-copilot76

amp76

kimi-cli76

gemini-cli76

opencode76

Odoo ERP 集成工具：CLI 与 JavaScript 库，实现自动化与脚本操作

🇨🇳中文介绍

/odoo

两种使用 Odoo 的方式

CLI — 适用于大多数任务的最快方式

库 — 适用于脚本和自动化

快速开始

步骤 1：配置环境

相关 Skills

步骤 2：验证连接

步骤 3：探索

CLI 退出代码

CLI 命令参考

库 API

服务访问器

安全模型

先决条件（必须首先阅读）

附加模块

邮件与消息传递

模块特定技能

🇺🇸English

/odoo

Two Ways to Work with Odoo

CLI — Fastest for Most Tasks

Library — For Scripts and Automation

Quick Start

Step 1: Configure Environment

Step 2: Verify Connection

Step 3: Explore

CLI Exit Codes

CLI Command Reference

Library API

Service Accessors

Safety Model

Prerequisites (Must Read First)

Additional Modules

Mail & Messaging

Module-Specific Skills

最新 Skills