Search and read in a single call (most common operation). Args: model: Odoo model name. domain: Odoo domain filter.

Format a single label: value line.

Read specific records by ID. Args: model: Odoo model name. ids: Single ID or list of IDs. fields: Fields

Create a record. Args: model: Odoo model name. values: Field values for the new record. Returns:

Format a monetary value.

Execute an Odoo RPC method. Wraps ``execute_kw`` on the ``/xmlrpc/2/object`` endpoint. Args: model: Odoo model name (e.g

Update existing records. Args: model: Odoo model name. ids: Single ID or list of IDs to update. values: F

Read a single lead/opportunity by ID.

Search for a partner by name. Create if not found. Uses case-insensitive ``ilike`` matching. If multiple matches, returns the best ma

Read a single manufacturing order by ID.

Read a single task by ID.

Get full details of a single purchase order. Args: po_id: The purchase order ID. Returns: Purchase order rec

Read a single employee by ID.

Persist last-check timestamps to disk.

Classify a raw exception into the appropriate OdooError subclass. Examines the fault string from XML-RPC faults and maps known Odoo error pat

Search for a product by name or internal reference. Create if not found. Args: name: Product name or SKU to search for.

Get full details of a single sales order. Args: order_id: The sale order ID. Returns: Order record dict.

Check that all required fields are populated. Returns: A list of human-readable error strings (empty == valid).

Read a single event by ID.

Read a single project by ID.

Get full details of a single invoice. Args: invoice_id: The invoice ID. Returns: Invoice record dict, or emp

Load configuration from environment variables with config.json fallback. **Priority order** (highest → lowest): 1. Environment variables (``O

Delete records. Args: model: Odoo model name. ids: Single ID or list of IDs to delete. Returns:

Validate that a value is a positive number. Args: value: The value to check. field_name: Human-readable name for error messages.

Search for a project by name. Create if not found. Args: name: Project name. **defaults: Additional fields for creati

Load last-check timestamps from disk.

Poll every watched model for changes.

Poll a single model for changes since last_check.

Read a single vehicle by ID.

Authenticate against Odoo and cache the user ID. Returns: The authenticated user's ID (``uid``). Raises: Odo

Create a new department. Args: name: Department name. parent_id: Parent department ID for hierarchical org.

Create a new employee record. Args: name: Employee's full name. job_title: Job title/position. department

Create a calendar event. Args: name: Event title/subject. start: Start datetime as ``YYYY-MM-DD HH:MM:SS`` or

Create a customer invoice. Args: partner_id: Customer ID. lines: List of line dicts, each containing at minimum

Create a new CRM lead. Args: name: Lead title / subject. contact_name: Contact person name. email: Contac

Create a new project. Args: name: Project name. partner_id: Customer associated with the project. descrip

Create a new purchase order (RFQ). Args: partner_id: Vendor/supplier partner ID. lines: List of line dicts, each cont

Create a new sales quotation. Args: partner_id: Customer ID. lines: List of line dicts, each containing at minimum

Create a task within a project. Args: project_id: The project to create the task in. name: Task name/title.

Parse natural language command and execute appropriate Odoo operation. This is a simple parser - in production, OpenClaw's LLM would han

Create a client loading config from environment / config.json.

Get full details of a Bill of Materials. Args: bom_id: The BOM ID. Returns: BOM record dict with lines, or e

Check product stock.

Confirm a sales order.

Create employee.

Create CRM lead.

Create CRM opportunity.

Create purchase order.

Parse create quotation command. Example: "Create quotation for Snake with 100 Snake Skin at $10"

Create project task.

Main entry point for OpenClaw skill invocation.

Validate that a value is a positive integer ID. Args: value: The value to check. field_name: Human-readable name for error messag

Get the Odoo server version info (no auth required).

Initialise the client. Args: config: An :class:`OdooConfig` instance. If *None*, configuration is loaded from en

Main polling loop — runs in the background thread.

Approve a pending leave request. Args: leave_id: The leave request ID. Returns: The updated leave record.

Assign users to a task. Args: task_id: The task ID. user_ids: List of user IDs to assign. Returns:

Cancel a sales order. Args: order_id: The sale order ID. Returns: The updated order record (state should be

Cancel a purchase order. Args: po_id: The purchase order ID. Returns: The updated purchase order record.

Check stock and forecast for a single product. Args: product_id: The ``product.product`` ID. Returns: Dict w

``/xmlrpc/2/common`` endpoint (lazy, cached).

Confirm a draft manufacturing order. Args: mo_id: The manufacturing order ID. Returns: The updated manufactu

Confirm a draft quotation → sales order. Args: order_id: The sale order ID. Returns: The updated order recor

Confirm a draft RFQ → purchase order. Args: po_id: The purchase order ID. Returns: The updated purchase orde

Create a Bill of Materials (BOM). Args: product_tmpl_id: Product template ID for the finished product. components: Li

Create a new customer in Odoo. Args: name: Customer / company name. email: Contact email address. phone:

Create an expense record for an employee. Args: name: Expense description/title. employee_id: The employee submitting

Create a leave (time off) request for an employee. Args: employee_id: The employee requesting leave. leave_type_id: T

Create a manufacturing order. Args: product_id: The product to manufacture (``product.product`` ID). product_qty: Qua

Create a new CRM opportunity (linked to a partner). Args: name: Opportunity title. partner_id: Associated customer/pa

Log a service/maintenance record for a vehicle. Args: vehicle_id: The vehicle ID. service_type_id: Service type ID (`

Create a new vehicle record. Args: model_id: Vehicle model ID (``fleet.vehicle.model``). license_plate: Vehicle licen

Delete (archive) a customer. Note: Odoo may prevent deletion if the partner has linked transactions. In that case, th

Delete a calendar event. Args: event_id: The event ID. Returns: ``True`` on success.

Health-check endpoint.

Handle an incoming webhook POST request.

Retrieve field metadata for a model (cached). Args: model: Odoo model name. attributes: Metadata attributes to includ

Search customers by name, email, or phone. Args: query: Free-text search string. limit: Max results to return.

Format a customer record for chat display. Args: customer: Partner dict from Odoo. Returns: Markdown-formatted string.