跳转至

快速开始（引导式设置）

/setup-odoo-tools 命令会一步步带你完成连接，每次只问一个问题，并验证结果。 如果你更喜欢手动操作，本页概述了该流程。

第 0 步 — 检测你已有的东西

命令会首先检查 uvx/node 是否可用，以及环境变量 （ODOO_URL、ODOO_DB、ODOO_LOGIN 和一个密钥）是否已设置。 如果一切就绪，它会直接跳到验证步骤。

第 1 步 — 选择接口

  • MCP 服务器（推荐） — 完整工具 + 兼容层。需要 uv/uvx （或 Python 3.11+）。
  • 备用 CLI — 轻量，仅需 Node。如果你无法运行 MCP，请使用它。

第 2 步 — Odoo 的版本与版本类型（可选）

Community · Enterprise · Online (odoo.com/SaaS) · 不确定。兼容层会自动覆盖 10–19 各版本；此信息仅作为上下文。

第 3 步 — 连接数据

  1. Odoo 的 URL — 例如 https://mi-empresa.odoo.com（协议 + 主机，不带 结尾路径）。
  2. 数据库名称 — Settings → Database，或在登录 URL 中可见。
  3. 登录邮箱 — 你用来登录的账户。
  4. 凭据 — 一个 API key（Odoo 14+，推荐）或一个密码 （Odoo < 14）。获取 API key： Preferences → Account Security → New API Key（只显示一次 ——请复制下来）。

安全

切勿将密钥写入受仓库跟踪的文件中。为智能体使用一个 最小权限 的 Odoo 用户。参见 安全。

第 4 步 — 持久化配置

export ODOO_URL="…"
export ODOO_DB="…"
export ODOO_LOGIN="…"
export ODOO_API_KEY="…"
将它们添加到 ~/.bashrc 或 ~/.zshrc 并重启 Claude。

setx ODOO_URL "…"
setx ODOO_DB "…"
setx ODOO_LOGIN "…"
setx ODOO_API_KEY "…"
重启 Claude 以便插件读取这些变量。

对于 CLI，运行 /odoo-tools:odoo-setup-cli：它会安装 CLI 并在 ~/.claude/tools/odoo-cli 中写入一个本地的 .env。

第 5 步 — 验证（完成的定义）

  • MCP： 调用 odoo_version。成功 = 返回版本 + 版本类型 + 部署方式 + 传输方式。然后测试： odoo_search_read { "model": "res.partner", "fields": ["name"], "limit": 1 }。
  • CLI： node ~/.claude/tools/odoo-cli/dist/cli.js contacts '{"limit":1}'。

如果失败，根据错误进行诊断：

  • 认证错误 → 检查 DB / login / API key
  • 传输错误 → 检查 URL（协议 + 主机）
  • "database not found" → 检查数据库的准确名称

第 6 步 — 第一批提示词

  • "列出上个月已过账的发票"
  • "有多少个有效订阅"
  • "把产品导出为 CSV"

使用 /odoo-doctor 进行快速检查，使用 /odoo-tools:odoo-crossversion 查看 版本说明。