什么是 vodoo？

vodoo 是一个专业的命令行界面，允许开发人员和 AI 智能体直接与 Odoo ERP 模块交互。通过利用像 vodoo 这样的 Openclaw Skills，用户可以通过编程方式管理服务台工单、项目任务、CRM 线索和知识库文章，而无需导航复杂的 Odoo Web 界面。

该工具专门针对 AI 环境进行了优化，需要使用 --no-color 标志以在保持对 Odoo XML-RPC API 完全访问的同时最小化 Token 消耗。它在自动化工作流和 Odoo 生态系统之间架起了一座桥梁，实现了无缝的数据操作和检索。

下载入口:https://github.com/openclaw/skills/tree/main/skills/julian-r/vodoo

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

vodoo 应用场景

• 通过 AI 智能体自动创建和更新 Odoo 服务台工单。
• 在不同的开发环境之间同步项目任务和阶段。
• 直接从终端更新 CRM 线索信息和收入预期。
• 管理 Odoo 知识库文章和内部备注以进行团队协作。
• 使用技术名称在任何 Odoo 模型上执行通用的 CRUD 操作。

1. 用户或 AI 智能体通过 uvx 调用该工具来运行 vodoo CLI，无需进行持久的本地安装。
2. 命令通过 XML-RPC 协议与 Odoo 实例建立安全连接。
3. 用户应用特定的模块命令（如 helpdesk、project-task 或 crm）来针对特定的数据集群。
4. 每个命令都附加 --no-color 标志，以确保输出整洁且利于 Openclaw Skills 内部的 AI 处理。
5. 实时检索或修改数据，并支持高级字段操作、讨论历史记录和文件附件。

vodoo 配置指南

要使用此 Openclaw Skills 资源，请确保您的系统中已安装 uv。然后，您可以直接使用 uvx 运行命令，无需单独的安装步骤：

# 列出服务台工单的示例命令
uvx vodoo --no-color helpdesk list

请确保已根据 vodoo 工具的要求配置了 Odoo 连接的环境变量（URL、数据库、用户名、密码）。

vodoo 数据架构与分类体系

vodoo 技能直接与 Odoo 数据模型交互，将 CLI 模块映射到其相应的技术模型，如下所示：

数值字段支持使用 +=、-=、*= 和 /= 等运算符进行相对更新，以实现高效的数值调整。

name: vodoo
description: Query and manage Odoo ERP data (helpdesk tickets, projects, tasks, CRM leads, knowledge articles) via the vodoo CLI

Vodoo - Odoo CLI Tool

Use uvx vodoo to interact with Odoo via XML-RPC. No installation required - uvx runs it directly.

Important: Always Use --no-color

ALWAYS add --no-color to every vodoo command. This disables ANSI escape codes and significantly reduces token usage.

# Correct
uvx vodoo --no-color helpdesk list

# Wrong (wastes tokens on color codes)
uvx vodoo helpdesk list

Commands Overview

Helpdesk Tickets

# List tickets
uvx vodoo helpdesk list
uvx vodoo helpdesk list --stage "New"
uvx vodoo helpdesk list --limit 5

# Show ticket details
uvx vodoo helpdesk show 123

# Add comment (visible to customer)
uvx vodoo helpdesk comment 123 "Your issue has been resolved"

# Add internal note (not visible to customer)
uvx vodoo helpdesk note 123 "Escalated to dev team"

# Manage tags
uvx vodoo helpdesk tags                    # List available tags
uvx vodoo helpdesk tag 123 "urgent"        # Add tag to ticket

# View history and attachments
uvx vodoo helpdesk chatter 123             # Message history
uvx vodoo helpdesk attachments 123         # List attachments
uvx vodoo helpdesk download 456            # Download attachment by ID
uvx vodoo helpdesk download-all 123        # Download all attachments

# Update fields
uvx vodoo helpdesk fields                  # List available fields
uvx vodoo helpdesk fields 123              # Show field values for ticket
uvx vodoo helpdesk set 123 priority=3      # Set field value

# Attachments and URL
uvx vodoo helpdesk attach 123 report.pdf   # Attach file
uvx vodoo helpdesk url 123                 # Get web URL

Project Tasks

# List tasks
uvx vodoo project-task list
uvx vodoo project-task list --project "Website Redesign"
uvx vodoo project-task list --stage "In Progress"

# Create task
uvx vodoo project-task create "Fix login bug" --project "Website"

# Show task details
uvx vodoo project-task show 456

# Comments and notes
uvx vodoo project-task comment 456 "Started working on this"
uvx vodoo project-task note 456 "Need clarification from client"

# Tags
uvx vodoo project-task tags
uvx vodoo project-task tag 456 "backend"
uvx vodoo project-task tag-create "new-tag"
uvx vodoo project-task tag-delete "old-tag"

# Attachments and history
uvx vodoo project-task chatter 456
uvx vodoo project-task attachments 456
uvx vodoo project-task attach 456 spec.pdf

# Fields and URL
uvx vodoo project-task fields
uvx vodoo project-task set 456 priority=1
uvx vodoo project-task url 456

Projects

# List projects
uvx vodoo project list

# Show project details
uvx vodoo project show 789

# Comments and notes
uvx vodoo project comment 789 "Project kickoff complete"
uvx vodoo project note 789 "Budget approved"

# History and attachments
uvx vodoo project chatter 789
uvx vodoo project attachments 789
uvx vodoo project attach 789 contract.pdf

# Fields and stages
uvx vodoo project fields
uvx vodoo project set 789 description="Updated description"
uvx vodoo project stages              # List task stages
uvx vodoo project url 789

CRM Leads/Opportunities

# List leads
uvx vodoo crm list
uvx vodoo crm list --stage "Qualified"

# Show lead details
uvx vodoo crm show 321

# Comments and notes
uvx vodoo crm comment 321 "Follow-up scheduled"
uvx vodoo crm note 321 "Decision maker: John Smith"

# Tags
uvx vodoo crm tags
uvx vodoo crm tag 321 "hot-lead"

# History and attachments
uvx vodoo crm chatter 321
uvx vodoo crm attachments 321
uvx vodoo crm attach 321 proposal.pdf

# Fields and URL
uvx vodoo crm fields
uvx vodoo crm set 321 expected_revenue=50000
uvx vodoo crm url 321

Knowledge Articles

# List articles
uvx vodoo knowledge list

# Show article
uvx vodoo knowledge show 111

# Comments and notes
uvx vodoo knowledge comment 111 "Updated for v2.0"
uvx vodoo knowledge note 111 "Needs review"

# History and URL
uvx vodoo knowledge chatter 111
uvx vodoo knowledge attachments 111
uvx vodoo knowledge url 111

Generic Model Operations

For any Odoo model not covered by specific commands:

# Read records
uvx vodoo model read res.partner --domain "[('is_company', '=', True)]" --fields name,email
uvx vodoo model read res.partner --ids 1,2,3

# Create record
uvx vodoo model create res.partner name="ACME Corp" is_company=true

# Update record
uvx vodoo model update res.partner 123 phone="+1234567890"

# Delete record
uvx vodoo model delete res.partner 123

# Call model method
uvx vodoo model call res.partner 123 method_name

Security / User Management

# Create standard Vodoo security groups
uvx vodoo security create-groups

# Create API service account
uvx vodoo security create-user "api-bot" "api-bot@example.com"

# Assign user to Vodoo API groups
uvx vodoo security assign-bot 456

# Set/reset user password
uvx vodoo security set-password 456 "new-password"

Common Options

Most commands support:

• --no-color - Required for AI usage (put right after vodoo)
• --limit N - Limit results
• --help - Show command help

Field Updates

The set command supports special operators for numerical fields:

• field=value - Set to value
• field+=10 - Add to current value
• field-=5 - Subtract from current value
• field*=2 - Multiply current value
• field/=2 - Divide current value

Tips

1. Always use --no-color flag (saves tokens by removing ANSI codes)
2. Use fields command to discover available fields before updating
3. Stage names are case-sensitive and must match exactly
4. The model command can access any Odoo model if you know its technical name