{
  "schemaVersion": "1.0",
  "item": {
    "slug": "odoo-erp-connector",
    "name": "Clawhub Package Full",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/NullNaveen/odoo-erp-connector",
    "canonicalUrl": "https://clawhub.ai/NullNaveen/odoo-erp-connector",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/odoo-erp-connector",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=odoo-erp-connector",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "odoo_skill/client.py",
      "odoo_skill/config.py",
      "odoo_skill/errors.py",
      "odoo_skill/models/calendar_ops.py",
      "odoo_skill/models/crm.py",
      "odoo_skill/models/ecommerce.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/odoo-erp-connector"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/odoo-erp-connector",
    "agentPageUrl": "https://openagent3.xyz/skills/odoo-erp-connector/agent",
    "manifestUrl": "https://openagent3.xyz/skills/odoo-erp-connector/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/odoo-erp-connector/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Odoo ERP Connector",
        "body": "Full-featured Odoo 19 ERP integration for OpenClaw. Control your entire business via natural language chat commands.\n\n📦 Full Source Code: https://github.com/NullNaveen/openclaw-odoo-skill"
      },
      {
        "title": "Quick Install",
        "body": "\\\bash\nnpx clawhub install odoo-erp-connector\n\\"
      },
      {
        "title": "Overview",
        "body": "The Odoo ERP Connector bridges OpenClaw and Odoo 19, enabling autonomous, chat-driven control over 153+ business modules including:\n\nSales & CRM\nPurchasing & Inventory\nInvoicing & Accounting\nProjects & Task Management\nHuman Resources\nFleet Management\nManufacturing (MRP)\nCalendar & Events\neCommerce\n\nAll operations use smart actions that handle fuzzy matching and auto-creation workflows."
      },
      {
        "title": "Sales & CRM",
        "body": "Create quotations with dynamic line items\nManage sales orders (draft → confirmed → done)\nSearch and filter orders by status, customer, date range\nCreate and qualify leads and opportunities\nMove leads through CRM pipeline stages\nView full sales pipeline with revenue forecasting"
      },
      {
        "title": "Purchasing",
        "body": "Create purchase orders from vendors\nManage PO status (draft → purchase → received)\nReceive and validate goods\nSearch and filter POs by vendor, status, date\nTrack purchase history and vendor performance"
      },
      {
        "title": "Inventory & Products",
        "body": "Create products (consumables, stockable, services)\nQuery stock levels and availability\nSet reorder points and receive low-stock alerts\nSearch products by name, code, or category\nTrack stock movements and valuations"
      },
      {
        "title": "Invoicing & Accounting",
        "body": "Create and post customer invoices\nManage payment terms and schedules\nQuery unpaid and overdue invoices\nSearch by customer, date range, or amount\nTrack invoice status (draft → posted → paid)"
      },
      {
        "title": "Projects & Tasks",
        "body": "Create projects and organize by team/status\nCreate tasks with priority, dates, and assignments\nLog timesheets and track project hours\nSearch and filter tasks by project, status, assignee\nManage project stages and closure"
      },
      {
        "title": "Human Resources",
        "body": "Create employees and departments\nManage job titles and work schedules\nProcess expense reports and reimbursements\nSearch employees by name, department, job\nTrack leave requests and attendance"
      },
      {
        "title": "Fleet Management",
        "body": "Create and track vehicles\nLog odometer readings and service records\nTrack maintenance schedules and costs\nSearch fleet by license plate, status, brand\nGenerate fleet reports"
      },
      {
        "title": "Manufacturing (MRP)",
        "body": "Create Bills of Materials (BOMs)\nManage manufacturing orders (MOs)\nTrack component requirements and production status\nSearch MOs by product or status\nLink BOMs to product variants"
      },
      {
        "title": "Calendar & Events",
        "body": "Create meetings and events with attendees\nSet reminders and locations\nSearch events by date range or attendee\nTrack calendar availability"
      },
      {
        "title": "eCommerce",
        "body": "Publish products to website\nView website orders and customer activity\nManage product visibility and pricing"
      },
      {
        "title": "Sales",
        "body": "\"Create a quotation for Acme Corp with 10 Widgets at $50 each\"\n\"Confirm sales order SO00042\"\n\"Show me all draft quotations from the past week\"\n\"What's the total revenue from completed orders this month?\"\n\"Create a quote for Rocky with product Rock\""
      },
      {
        "title": "CRM",
        "body": "\"Create a lead for Rocky, email rocky@example.com, potential $50k deal\"\n\"Move lead #47 to Qualified stage\"\n\"Show me the sales pipeline with all open opportunities\"\n\"What leads are at proposal stage?\"\n\"Create an opportunity for Acme with $100k expected value\""
      },
      {
        "title": "Purchasing",
        "body": "\"Create a PO for 500 widgets from Supplier ABC\"\n\"Confirm purchase order PO00123\"\n\"Show all pending purchase orders\"\n\"Get me the vendor history for ABC Supplies\"\n\"What's on order that's overdue?\""
      },
      {
        "title": "Inventory & Products",
        "body": "\"Create a new product: TestWidget, $25 price, min stock 10\"\n\"Show products with stock below 20 units\"\n\"What's the stock level for Widget X?\"\n\"Search for all consumable products\"\n\"Set reorder point for Product Y to 50 units\""
      },
      {
        "title": "Invoicing",
        "body": "\"Create an invoice for Acme Corp with 5 units at $50 each\"\n\"Show me unpaid invoices\"\n\"What invoices are overdue?\"\n\"Post invoice INV-001\"\n\"Send a reminder for invoice INV-002\""
      },
      {
        "title": "Projects & Tasks",
        "body": "\"Create a project called Website Redesign\"\n\"Create a task 'Fix login button' in Website Redesign project\"\n\"Show me all tasks assigned to me\"\n\"Log 3 hours of work on task #42\"\n\"What's the status of the Website Redesign project?\""
      },
      {
        "title": "HR",
        "body": "\"Create employee John Smith, job title Developer\"\n\"Create department Engineering\"\n\"Show me all employees in Engineering\"\n\"Submit expense report for $45.99\"\n\"What are the pending leave requests?\""
      },
      {
        "title": "Fleet",
        "body": "\"Create vehicle: Tesla Model 3, license plate TESLA-001\"\n\"Log odometer reading: 50,000 miles for vehicle #1\"\n\"Show all vehicles with service due\"\n\"What's the maintenance cost for this month?\"\n\"Search for blue vehicles\""
      },
      {
        "title": "Manufacturing",
        "body": "\"Create BOM: Widget contains 3 Components A and 2 Components B\"\n\"Create manufacturing order: produce 50 Widgets\"\n\"Confirm production order #1\"\n\"What's the status of MO-001?\"\n\"Show all in-progress manufacturing orders\""
      },
      {
        "title": "Calendar",
        "body": "\"Create meeting: Team Standup, tomorrow at 10am, 1 hour\"\n\"Show me my meetings for next week\"\n\"What events do I have on the 15th?\"\n\"Schedule a 2-hour planning session with the team\""
      },
      {
        "title": "eCommerce",
        "body": "\"Publish Widget X to the website\"\n\"Show me website orders from this week\"\n\"What's my website revenue?\""
      },
      {
        "title": "Smart Actions",
        "body": "The connector handles fuzzy/incomplete requests with intelligent find-or-create logic."
      },
      {
        "title": "How Smart Actions Work",
        "body": "Example: \"Create quotation for Rocky with product Rock\"\n\nThe system:\n\nSearches for a customer named \"Rocky\" (case-insensitive, ilike matching)\nIf not found: Creates a new customer \"Rocky\" (auto-company flag)\nSearches for product \"Rock\"\nIf not found: Creates a basic product \"Rock\" (consumable type, default price $0)\nCreates the quotation, linking both the found/created customer and product\nReports what was found vs. created:\n\n\"Created quotation QT-001 for new customer Rocky with 1 × Rock at $0.00\"\n\nThis pattern applies across all smart actions:\n\nsmart_create_quotation() — customer + products\nsmart_create_purchase() — vendor + products\nsmart_create_lead() — partner (optional)\nsmart_create_task() — project + task\nsmart_create_employee() — department\nsmart_create_event() — event only (no dependencies)"
      },
      {
        "title": "Benefits",
        "body": "Fuzzy matching: Searches are case-insensitive and forgiving\nAuto-creation: Missing dependencies are created automatically\nTransparency: Each response explains what was created vs. found\nNo IDs needed: Use names instead of Odoo IDs\nBatch operations: Create multiple related records in one call"
      },
      {
        "title": "Core Components",
        "body": "OdooClient — Low-level XML-RPC wrapper\n\nConnects to Odoo 19 instance\nHandles authentication via API key\nProvides search(), read(), create(), write(), unlink() methods\nBuilt-in retry logic and error handling\n\nModel Ops Classes — Business logic for each module\n\nPartnerOps — Customers/suppliers\nSaleOrderOps — Quotations and sales orders\nInvoiceOps — Customer invoices\nInventoryOps — Products and stock\nCRMOps — Leads and opportunities\nPurchaseOrderOps — POs and vendors\nProjectOps — Projects and tasks\nHROps — Employees, departments, expenses\nManufacturingOps — BOMs and MOs\nCalendarOps — Events and meetings\nFleetOps — Vehicles and odometer\nEcommerceOps — Website orders and products\n\nSmartActionHandler — High-level natural-language interface\n\nWraps all Ops classes\nImplements find-or-create workflows\nFuzzy name matching (case-insensitive)\nMulti-step transaction orchestration\nDetailed response summaries"
      },
      {
        "title": "Field Handling",
        "body": "The connector auto-detects required vs. optional fields in Odoo 19:\n\nImplicit defaults: Fields with Odoo defaults (e.g., state) are omitted\nSmart creation: Auto-fills reasonable defaults for optional fields\nError reporting: Missing required fields raise clear OdooError with field name"
      },
      {
        "title": "config.json Format",
        "body": "{\n  \"url\": \"http://localhost:8069\",\n  \"db\": \"your_database\",\n  \"username\": \"api_user@yourcompany.com\",\n  \"api_key\": \"your_api_key_from_odoo_preferences\",\n  \"timeout\": 60,\n  \"max_retries\": 3,\n  \"poll_interval\": 60,\n  \"log_level\": \"INFO\",\n  \"webhook_port\": 8070,\n  \"webhook_secret\": \"\"\n}"
      },
      {
        "title": "Getting Your API Key",
        "body": "Log in to your Odoo instance\nGo to Settings → Users & Companies → Users\nOpen your user record\nScroll to Access Tokens\nClick Generate Token\nCopy the token and paste into config.json"
      },
      {
        "title": "Environment Variables",
        "body": "Alternatively, set in .env:\n\nODOO_URL=http://localhost:8069\nODOO_DB=your_database\nODOO_USERNAME=api_user@yourcompany.com\nODOO_API_KEY=your_api_key\n\nThe client auto-loads from .env if config.json is missing."
      },
      {
        "title": "Basic Usage",
        "body": "from odoo_skill import OdooClient, SmartActionHandler\n\n# Load config from config.json\nclient = OdooClient.from_config(\"config.json\")\n\n# Test connection\nstatus = client.test_connection()\nprint(f\"Connected to Odoo {status['server_version']}\")\n\n# Use smart actions for natural workflows\nsmart = SmartActionHandler(client)\n\n# Create a quotation with fuzzy partner and product matching\nresult = smart.smart_create_quotation(\n    customer_name=\"Rocky\",\n    product_lines=[\n        {\"name\": \"Rock\", \"quantity\": 5, \"price_unit\": 19.99}\n    ],\n    notes=\"Fuzzy match quotation\"\n)\n\nprint(result[\"summary\"])\n# Output: \"Created quotation QT-001 for new customer Rocky with 1 × Rock at $19.99\""
      },
      {
        "title": "Smart Actions API",
        "body": "# Find-or-create a customer\nresult = smart.find_or_create_partner(\n    name=\"Acme Corp\",\n    is_company=True,\n    city=\"New York\"\n)\npartner = result[\"partner\"]\ncreated = result[\"created\"]\n\n# Find-or-create a product\nresult = smart.find_or_create_product(\n    name=\"Widget X\",\n    list_price=49.99,\n    type=\"consu\"\n)\nproduct = result[\"product\"]\n\n# Smart quotation (auto-creates customer & products)\nresult = smart.smart_create_quotation(\n    customer_name=\"Rocky\",\n    product_lines=[\n        {\"name\": \"Product A\", \"quantity\": 10},\n        {\"name\": \"Product B\", \"quantity\": 5, \"price_unit\": 25.0}\n    ],\n    notes=\"Created via smart action\"\n)\norder = result[\"order\"]\nprint(f\"Order {order['name']} created with {len(result['products'])} product(s)\")\n\n# Smart lead creation\nresult = smart.smart_create_lead(\n    name=\"New Prospect\",\n    contact_name=\"John Doe\",\n    email=\"john@prospect.com\",\n    expected_revenue=50000.0\n)\nlead = result[\"lead\"]\n\n# Smart task creation (auto-creates project if needed)\nresult = smart.smart_create_task(\n    project_name=\"Website Redesign\",\n    task_name=\"Fix homepage\",\n    description=\"Update hero section\"\n)\ntask = result[\"task\"]\n\n# Smart employee creation (auto-creates department if needed)\nresult = smart.smart_create_employee(\n    name=\"Jane Smith\",\n    job_title=\"Developer\",\n    department_name=\"Engineering\"\n)\nemployee = result[\"employee\"]"
      },
      {
        "title": "Low-Level Ops API",
        "body": "from odoo_skill.models.sale_order import SaleOrderOps\nfrom odoo_skill.models.partner import PartnerOps\n\npartners = PartnerOps(client)\nsales = SaleOrderOps(client)\n\n# Get all customers\ncustomers = partners.search_customers(limit=10)\nfor cust in customers:\n    print(f\"{cust['name']} — {cust.get('email')}\")\n\n# Create a quotation with specific IDs\norder = sales.create_quotation(\n    partner_id=42,\n    lines=[\n        {\"product_id\": 7, \"quantity\": 10, \"price_unit\": 49.99},\n        {\"product_id\": 8, \"quantity\": 5}\n    ],\n    notes=\"Manual order\"\n)\nprint(f\"Created {order['name']}\")\n\n# Confirm the order\nconfirmed = sales.confirm_order(order['id'])\nprint(f\"Order {confirmed['name']} is now {confirmed['state']}\")"
      },
      {
        "title": "Response Format",
        "body": "All API methods return structured dictionaries:"
      },
      {
        "title": "Smart Action Response",
        "body": "{\n  \"summary\": \"Created quotation QT-001 for new customer Rocky with 1 × Rock\",\n  \"order\": {\n    \"id\": 1,\n    \"name\": \"QT-001\",\n    \"state\": \"draft\",\n    \"partner_id\": [42, \"Rocky\"],\n    \"amount_total\": 19.99\n  },\n  \"customer\": {\n    \"created\": True,\n    \"partner\": {\"id\": 42, \"name\": \"Rocky\"}\n  },\n  \"products\": [\n    {\n      \"created\": True,\n      \"product\": {\"id\": 7, \"name\": \"Rock\"}\n    }\n  ]\n}"
      },
      {
        "title": "Standard Response",
        "body": "{\n  \"id\": 1,\n  \"name\": \"QT-001\",\n  \"state\": \"draft\",\n  \"partner_id\": [42, \"Rocky\"],\n  \"amount_total\": 19.99,\n  \"order_line\": [\n    {\n      \"id\": 1,\n      \"product_id\": [7, \"Rock\"],\n      \"quantity\": 1,\n      \"price_unit\": 19.99,\n      \"price_subtotal\": 19.99\n    }\n  ]\n}"
      },
      {
        "title": "Error Handling",
        "body": "The connector uses custom exceptions:\n\nfrom odoo_skill.errors import OdooError, OdooAuthError, OdooNotFoundError\n\ntry:\n    result = smart.smart_create_quotation(\n        customer_name=\"Acme\",\n        product_lines=[{\"name\": \"Widget\"}]\n    )\nexcept OdooAuthError as e:\n    print(f\"Authentication failed: {e}\")\nexcept OdooNotFoundError as e:\n    print(f\"Record not found: {e}\")\nexcept OdooError as e:\n    print(f\"Odoo error: {e}\")"
      },
      {
        "title": "Supported Odoo Modules",
        "body": "The connector supports 153+ installed modules in Odoo 19:\n\nCore\n\nbase, web, website\n\nSales & CRM\n\nsale, crm, sale_management, website_sale, event, survey\n\nPurchasing\n\npurchase, purchase_stock, purchase_requisition\n\nInventory\n\nstock, stock_intrastat, stock_dropshipping\n\nAccounting\n\naccount, account_accountant, account_analytic, account_payment\n\nHR\n\nhr, hr_attendance, hr_expense, hr_contract, hr_holidays, hr_org_chart\n\nProjects\n\nproject, project_enterprise, task_base, project_timesheet_forecast\n\nManufacturing\n\nmrp, mrp_byproduct, quality, batch, shelf_life\n\nFleet\n\nfleet, maintenance\n\nMarketing\n\nmarketing_automation, email_marketing, mass_mailing, sms, website_form\n\neCommerce\n\nwebsite_sale, website_sale_analytics, website_sale_comparison, website_form_project\n\nTools\n\ncalendar, documents, spreadsheet, discuss, mail, knowledge\n\nPlus 50+ more specialized modules"
      },
      {
        "title": "Limits & Constraints",
        "body": "Search limit: 100 records by default (configurable)\nTimeout: 60 seconds per request (configurable)\nRetries: 3 automatic retries on network failure\nConcurrency: Single-threaded; queue requests if needed\nRate limiting: Follow your Odoo instance's API limits"
      },
      {
        "title": "Connection Issues",
        "body": "Verify url, db, username, api_key in config.json\nCheck Odoo server is running: http://your-odoo-url/web\nEnsure API key is generated in Odoo user settings\nCheck network connectivity and firewall rules"
      },
      {
        "title": "Authentication Errors",
        "body": "Regenerate API key in Odoo\nVerify username (email format)\nCheck that the user has API access enabled\nEnsure database name matches exactly"
      },
      {
        "title": "Missing Field Errors",
        "body": "Field names must match Odoo 19 exactly (e.g., product_tmpl_id, not product_id)\nSome fields are read-only in Odoo (state, computed fields)\nCheck Odoo model definition: Settings → Technical → Database Structure → Models"
      },
      {
        "title": "Smart Action Issues",
        "body": "Fuzzy matching is case-insensitive but searches only the name field\nFor exact matching, use the low-level Ops API with id directly\nIf a name exists in multiple records, the first match is used"
      },
      {
        "title": "Performance",
        "body": "Large searches (limit > 100) may timeout\nUse date range filters: date_from, date_to\nConsider batch operations for bulk data"
      },
      {
        "title": "Natural Language Sales Order",
        "body": "User: \"Create a quote for Acme Corp with 10 Widgets at $50 each\"\n\nOpenClaw → OdooClient (smart action):\n  1. Search for customer \"Acme Corp\"\n  2. Search for product \"Widgets\"\n  3. Create quotation with both\n  4. Return summary\n\nResult: \"✅ Created quotation QT-001 for Acme Corp with 10 × Widgets at $50\""
      },
      {
        "title": "Pipeline Status Check",
        "body": "User: \"Show me the sales pipeline\"\n\nOpenClaw → CRMOps.get_pipeline():\n  - Query all leads/opportunities\n  - Group by stage\n  - Calculate total revenue by stage\n  - Return formatted summary\n\nResult: \"Qualified: $50k | Proposal: $100k | Negotiation: $75k | Total: $225k\""
      },
      {
        "title": "Inventory Alert",
        "body": "User: \"What products are low on stock?\"\n\nOpenClaw → InventoryOps.get_low_stock_products():\n  - Query products with stock < reorder point\n  - List each product, stock level, reorder point\n  - Suggest PO quantities\n\nResult: \"Widget X: 5 on hand (min 20) | Component Y: 0 on hand (min 10)\""
      },
      {
        "title": "Project Structure",
        "body": "OdooConnector/\n├── odoo_skill/\n│   ├── client.py              # Core OdooClient\n│   ├── config.py              # Configuration loader\n│   ├── errors.py              # Custom exceptions\n│   ├── retry.py               # Retry logic\n│   ├── smart_actions.py       # Smart action handler\n│   ├── models/\n│   │   ├── partner.py\n│   │   ├── sale_order.py\n│   │   ├── invoice.py\n│   │   ├── inventory.py\n│   │   ├── crm.py\n│   │   ├── purchase.py\n│   │   ├── project.py\n│   │   ├── hr.py\n│   │   ├── manufacturing.py\n│   │   ├── calendar_ops.py\n│   │   ├── fleet.py\n│   │   ├── ecommerce.py\n│   ├── utils/\n│   │   ├── formatting.py      # Response formatting\n│   │   ├── validators.py      # Input validation\n│   ├── sync/\n│   │   ├── poller.py          # Webhook poller\n│   │   ├── webhook.py         # Webhook handler\n├── run_full_test.py           # Integration test suite\n├── config.json                # Configuration (create from template)\n├── config.template.json       # Configuration template\n├── requirements.txt           # Python dependencies\n├── README.md                  # User setup guide\n├── SKILL.md                   # This file\n└── setup.ps1                  # PowerShell installer"
      },
      {
        "title": "Running Tests",
        "body": "# Run full integration test suite\npython run_full_test.py\n\n# Run single test module\npython -m pytest tests/test_partners.py -v\n\n# Run with coverage\npython -m pytest --cov=odoo_skill tests/"
      },
      {
        "title": "Adding a New Smart Action",
        "body": "Implement the method in SmartActionHandler class\nUse find_or_create_* primitives for dependencies\nReturn a dict with summary, the main record, and creation details\nAdd docstring with example usage\nTest with run_full_test.py\n\nExample:\n\ndef smart_create_invoice(self, customer_name: str, product_lines: list[dict], **kwargs) -> dict:\n    \"\"\"Create invoice with fuzzy customer and product matching.\"\"\"\n    # Find or create customer\n    customer_result = self.find_or_create_partner(customer_name)\n    customer = customer_result[\"partner\"]\n    \n    # Find or create products\n    products = []\n    for line in product_lines:\n        prod_result = self.find_or_create_product(line[\"name\"], **line)\n        products.append(prod_result)\n    \n    # Create invoice with resolved IDs\n    invoice = self.invoices.create_invoice(\n        partner_id=customer[\"id\"],\n        lines=[...],\n        **kwargs\n    )\n    \n    return {\n        \"summary\": f\"Created invoice INV-001 for {customer['name']}\",\n        \"invoice\": invoice,\n        \"customer\": customer_result,\n        \"products\": products\n    }"
      },
      {
        "title": "License & Support",
        "body": "This connector is part of the OpenClaw project. For issues, questions, or contributions, contact the development team.\n\nLast Updated: 2026-02-09\nOdoo Version: 19.0\nPython: 3.10+\nStatus: Production Ready"
      }
    ],
    "body": "Odoo ERP Connector\n\nFull-featured Odoo 19 ERP integration for OpenClaw. Control your entire business via natural language chat commands.\n\n📦 Full Source Code: https://github.com/NullNaveen/openclaw-odoo-skill\n\nQuick Install\n\n\\\bash npx clawhub install odoo-erp-connector \\\n\nOverview\n\nThe Odoo ERP Connector bridges OpenClaw and Odoo 19, enabling autonomous, chat-driven control over 153+ business modules including:\n\nSales & CRM\nPurchasing & Inventory\nInvoicing & Accounting\nProjects & Task Management\nHuman Resources\nFleet Management\nManufacturing (MRP)\nCalendar & Events\neCommerce\n\nAll operations use smart actions that handle fuzzy matching and auto-creation workflows.\n\nCapabilities\nSales & CRM\nCreate quotations with dynamic line items\nManage sales orders (draft → confirmed → done)\nSearch and filter orders by status, customer, date range\nCreate and qualify leads and opportunities\nMove leads through CRM pipeline stages\nView full sales pipeline with revenue forecasting\nPurchasing\nCreate purchase orders from vendors\nManage PO status (draft → purchase → received)\nReceive and validate goods\nSearch and filter POs by vendor, status, date\nTrack purchase history and vendor performance\nInventory & Products\nCreate products (consumables, stockable, services)\nQuery stock levels and availability\nSet reorder points and receive low-stock alerts\nSearch products by name, code, or category\nTrack stock movements and valuations\nInvoicing & Accounting\nCreate and post customer invoices\nManage payment terms and schedules\nQuery unpaid and overdue invoices\nSearch by customer, date range, or amount\nTrack invoice status (draft → posted → paid)\nProjects & Tasks\nCreate projects and organize by team/status\nCreate tasks with priority, dates, and assignments\nLog timesheets and track project hours\nSearch and filter tasks by project, status, assignee\nManage project stages and closure\nHuman Resources\nCreate employees and departments\nManage job titles and work schedules\nProcess expense reports and reimbursements\nSearch employees by name, department, job\nTrack leave requests and attendance\nFleet Management\nCreate and track vehicles\nLog odometer readings and service records\nTrack maintenance schedules and costs\nSearch fleet by license plate, status, brand\nGenerate fleet reports\nManufacturing (MRP)\nCreate Bills of Materials (BOMs)\nManage manufacturing orders (MOs)\nTrack component requirements and production status\nSearch MOs by product or status\nLink BOMs to product variants\nCalendar & Events\nCreate meetings and events with attendees\nSet reminders and locations\nSearch events by date range or attendee\nTrack calendar availability\neCommerce\nPublish products to website\nView website orders and customer activity\nManage product visibility and pricing\nCommand Examples\nSales\n\"Create a quotation for Acme Corp with 10 Widgets at $50 each\"\n\"Confirm sales order SO00042\"\n\"Show me all draft quotations from the past week\"\n\"What's the total revenue from completed orders this month?\"\n\"Create a quote for Rocky with product Rock\"\nCRM\n\"Create a lead for Rocky, email rocky@example.com, potential $50k deal\"\n\"Move lead #47 to Qualified stage\"\n\"Show me the sales pipeline with all open opportunities\"\n\"What leads are at proposal stage?\"\n\"Create an opportunity for Acme with $100k expected value\"\nPurchasing\n\"Create a PO for 500 widgets from Supplier ABC\"\n\"Confirm purchase order PO00123\"\n\"Show all pending purchase orders\"\n\"Get me the vendor history for ABC Supplies\"\n\"What's on order that's overdue?\"\nInventory & Products\n\"Create a new product: TestWidget, $25 price, min stock 10\"\n\"Show products with stock below 20 units\"\n\"What's the stock level for Widget X?\"\n\"Search for all consumable products\"\n\"Set reorder point for Product Y to 50 units\"\nInvoicing\n\"Create an invoice for Acme Corp with 5 units at $50 each\"\n\"Show me unpaid invoices\"\n\"What invoices are overdue?\"\n\"Post invoice INV-001\"\n\"Send a reminder for invoice INV-002\"\nProjects & Tasks\n\"Create a project called Website Redesign\"\n\"Create a task 'Fix login button' in Website Redesign project\"\n\"Show me all tasks assigned to me\"\n\"Log 3 hours of work on task #42\"\n\"What's the status of the Website Redesign project?\"\nHR\n\"Create employee John Smith, job title Developer\"\n\"Create department Engineering\"\n\"Show me all employees in Engineering\"\n\"Submit expense report for $45.99\"\n\"What are the pending leave requests?\"\nFleet\n\"Create vehicle: Tesla Model 3, license plate TESLA-001\"\n\"Log odometer reading: 50,000 miles for vehicle #1\"\n\"Show all vehicles with service due\"\n\"What's the maintenance cost for this month?\"\n\"Search for blue vehicles\"\nManufacturing\n\"Create BOM: Widget contains 3 Components A and 2 Components B\"\n\"Create manufacturing order: produce 50 Widgets\"\n\"Confirm production order #1\"\n\"What's the status of MO-001?\"\n\"Show all in-progress manufacturing orders\"\nCalendar\n\"Create meeting: Team Standup, tomorrow at 10am, 1 hour\"\n\"Show me my meetings for next week\"\n\"What events do I have on the 15th?\"\n\"Schedule a 2-hour planning session with the team\"\neCommerce\n\"Publish Widget X to the website\"\n\"Show me website orders from this week\"\n\"What's my website revenue?\"\nSmart Actions\n\nThe connector handles fuzzy/incomplete requests with intelligent find-or-create logic.\n\nHow Smart Actions Work\n\nExample: \"Create quotation for Rocky with product Rock\"\n\nThe system:\n\nSearches for a customer named \"Rocky\" (case-insensitive, ilike matching)\nIf not found: Creates a new customer \"Rocky\" (auto-company flag)\nSearches for product \"Rock\"\nIf not found: Creates a basic product \"Rock\" (consumable type, default price $0)\nCreates the quotation, linking both the found/created customer and product\nReports what was found vs. created:\n\"Created quotation QT-001 for new customer Rocky with 1 × Rock at $0.00\"\n\nThis pattern applies across all smart actions:\n\nsmart_create_quotation() — customer + products\nsmart_create_purchase() — vendor + products\nsmart_create_lead() — partner (optional)\nsmart_create_task() — project + task\nsmart_create_employee() — department\nsmart_create_event() — event only (no dependencies)\nBenefits\nFuzzy matching: Searches are case-insensitive and forgiving\nAuto-creation: Missing dependencies are created automatically\nTransparency: Each response explains what was created vs. found\nNo IDs needed: Use names instead of Odoo IDs\nBatch operations: Create multiple related records in one call\nArchitecture\nCore Components\n\nOdooClient — Low-level XML-RPC wrapper\n\nConnects to Odoo 19 instance\nHandles authentication via API key\nProvides search(), read(), create(), write(), unlink() methods\nBuilt-in retry logic and error handling\n\nModel Ops Classes — Business logic for each module\n\nPartnerOps — Customers/suppliers\nSaleOrderOps — Quotations and sales orders\nInvoiceOps — Customer invoices\nInventoryOps — Products and stock\nCRMOps — Leads and opportunities\nPurchaseOrderOps — POs and vendors\nProjectOps — Projects and tasks\nHROps — Employees, departments, expenses\nManufacturingOps — BOMs and MOs\nCalendarOps — Events and meetings\nFleetOps — Vehicles and odometer\nEcommerceOps — Website orders and products\n\nSmartActionHandler — High-level natural-language interface\n\nWraps all Ops classes\nImplements find-or-create workflows\nFuzzy name matching (case-insensitive)\nMulti-step transaction orchestration\nDetailed response summaries\nField Handling\n\nThe connector auto-detects required vs. optional fields in Odoo 19:\n\nImplicit defaults: Fields with Odoo defaults (e.g., state) are omitted\nSmart creation: Auto-fills reasonable defaults for optional fields\nError reporting: Missing required fields raise clear OdooError with field name\nConfiguration\nconfig.json Format\n{\n  \"url\": \"http://localhost:8069\",\n  \"db\": \"your_database\",\n  \"username\": \"api_user@yourcompany.com\",\n  \"api_key\": \"your_api_key_from_odoo_preferences\",\n  \"timeout\": 60,\n  \"max_retries\": 3,\n  \"poll_interval\": 60,\n  \"log_level\": \"INFO\",\n  \"webhook_port\": 8070,\n  \"webhook_secret\": \"\"\n}\n\nGetting Your API Key\nLog in to your Odoo instance\nGo to Settings → Users & Companies → Users\nOpen your user record\nScroll to Access Tokens\nClick Generate Token\nCopy the token and paste into config.json\nEnvironment Variables\n\nAlternatively, set in .env:\n\nODOO_URL=http://localhost:8069\nODOO_DB=your_database\nODOO_USERNAME=api_user@yourcompany.com\nODOO_API_KEY=your_api_key\n\n\nThe client auto-loads from .env if config.json is missing.\n\nPython API\nBasic Usage\nfrom odoo_skill import OdooClient, SmartActionHandler\n\n# Load config from config.json\nclient = OdooClient.from_config(\"config.json\")\n\n# Test connection\nstatus = client.test_connection()\nprint(f\"Connected to Odoo {status['server_version']}\")\n\n# Use smart actions for natural workflows\nsmart = SmartActionHandler(client)\n\n# Create a quotation with fuzzy partner and product matching\nresult = smart.smart_create_quotation(\n    customer_name=\"Rocky\",\n    product_lines=[\n        {\"name\": \"Rock\", \"quantity\": 5, \"price_unit\": 19.99}\n    ],\n    notes=\"Fuzzy match quotation\"\n)\n\nprint(result[\"summary\"])\n# Output: \"Created quotation QT-001 for new customer Rocky with 1 × Rock at $19.99\"\n\nSmart Actions API\n# Find-or-create a customer\nresult = smart.find_or_create_partner(\n    name=\"Acme Corp\",\n    is_company=True,\n    city=\"New York\"\n)\npartner = result[\"partner\"]\ncreated = result[\"created\"]\n\n# Find-or-create a product\nresult = smart.find_or_create_product(\n    name=\"Widget X\",\n    list_price=49.99,\n    type=\"consu\"\n)\nproduct = result[\"product\"]\n\n# Smart quotation (auto-creates customer & products)\nresult = smart.smart_create_quotation(\n    customer_name=\"Rocky\",\n    product_lines=[\n        {\"name\": \"Product A\", \"quantity\": 10},\n        {\"name\": \"Product B\", \"quantity\": 5, \"price_unit\": 25.0}\n    ],\n    notes=\"Created via smart action\"\n)\norder = result[\"order\"]\nprint(f\"Order {order['name']} created with {len(result['products'])} product(s)\")\n\n# Smart lead creation\nresult = smart.smart_create_lead(\n    name=\"New Prospect\",\n    contact_name=\"John Doe\",\n    email=\"john@prospect.com\",\n    expected_revenue=50000.0\n)\nlead = result[\"lead\"]\n\n# Smart task creation (auto-creates project if needed)\nresult = smart.smart_create_task(\n    project_name=\"Website Redesign\",\n    task_name=\"Fix homepage\",\n    description=\"Update hero section\"\n)\ntask = result[\"task\"]\n\n# Smart employee creation (auto-creates department if needed)\nresult = smart.smart_create_employee(\n    name=\"Jane Smith\",\n    job_title=\"Developer\",\n    department_name=\"Engineering\"\n)\nemployee = result[\"employee\"]\n\nLow-Level Ops API\nfrom odoo_skill.models.sale_order import SaleOrderOps\nfrom odoo_skill.models.partner import PartnerOps\n\npartners = PartnerOps(client)\nsales = SaleOrderOps(client)\n\n# Get all customers\ncustomers = partners.search_customers(limit=10)\nfor cust in customers:\n    print(f\"{cust['name']} — {cust.get('email')}\")\n\n# Create a quotation with specific IDs\norder = sales.create_quotation(\n    partner_id=42,\n    lines=[\n        {\"product_id\": 7, \"quantity\": 10, \"price_unit\": 49.99},\n        {\"product_id\": 8, \"quantity\": 5}\n    ],\n    notes=\"Manual order\"\n)\nprint(f\"Created {order['name']}\")\n\n# Confirm the order\nconfirmed = sales.confirm_order(order['id'])\nprint(f\"Order {confirmed['name']} is now {confirmed['state']}\")\n\nResponse Format\n\nAll API methods return structured dictionaries:\n\nSmart Action Response\n{\n  \"summary\": \"Created quotation QT-001 for new customer Rocky with 1 × Rock\",\n  \"order\": {\n    \"id\": 1,\n    \"name\": \"QT-001\",\n    \"state\": \"draft\",\n    \"partner_id\": [42, \"Rocky\"],\n    \"amount_total\": 19.99\n  },\n  \"customer\": {\n    \"created\": True,\n    \"partner\": {\"id\": 42, \"name\": \"Rocky\"}\n  },\n  \"products\": [\n    {\n      \"created\": True,\n      \"product\": {\"id\": 7, \"name\": \"Rock\"}\n    }\n  ]\n}\n\nStandard Response\n{\n  \"id\": 1,\n  \"name\": \"QT-001\",\n  \"state\": \"draft\",\n  \"partner_id\": [42, \"Rocky\"],\n  \"amount_total\": 19.99,\n  \"order_line\": [\n    {\n      \"id\": 1,\n      \"product_id\": [7, \"Rock\"],\n      \"quantity\": 1,\n      \"price_unit\": 19.99,\n      \"price_subtotal\": 19.99\n    }\n  ]\n}\n\nError Handling\n\nThe connector uses custom exceptions:\n\nfrom odoo_skill.errors import OdooError, OdooAuthError, OdooNotFoundError\n\ntry:\n    result = smart.smart_create_quotation(\n        customer_name=\"Acme\",\n        product_lines=[{\"name\": \"Widget\"}]\n    )\nexcept OdooAuthError as e:\n    print(f\"Authentication failed: {e}\")\nexcept OdooNotFoundError as e:\n    print(f\"Record not found: {e}\")\nexcept OdooError as e:\n    print(f\"Odoo error: {e}\")\n\nSupported Odoo Modules\n\nThe connector supports 153+ installed modules in Odoo 19:\n\nCore\n\nbase, web, website\n\nSales & CRM\n\nsale, crm, sale_management, website_sale, event, survey\n\nPurchasing\n\npurchase, purchase_stock, purchase_requisition\n\nInventory\n\nstock, stock_intrastat, stock_dropshipping\n\nAccounting\n\naccount, account_accountant, account_analytic, account_payment\n\nHR\n\nhr, hr_attendance, hr_expense, hr_contract, hr_holidays, hr_org_chart\n\nProjects\n\nproject, project_enterprise, task_base, project_timesheet_forecast\n\nManufacturing\n\nmrp, mrp_byproduct, quality, batch, shelf_life\n\nFleet\n\nfleet, maintenance\n\nMarketing\n\nmarketing_automation, email_marketing, mass_mailing, sms, website_form\n\neCommerce\n\nwebsite_sale, website_sale_analytics, website_sale_comparison, website_form_project\n\nTools\n\ncalendar, documents, spreadsheet, discuss, mail, knowledge\n\nPlus 50+ more specialized modules\n\nLimits & Constraints\nSearch limit: 100 records by default (configurable)\nTimeout: 60 seconds per request (configurable)\nRetries: 3 automatic retries on network failure\nConcurrency: Single-threaded; queue requests if needed\nRate limiting: Follow your Odoo instance's API limits\nTroubleshooting\nConnection Issues\nVerify url, db, username, api_key in config.json\nCheck Odoo server is running: http://your-odoo-url/web\nEnsure API key is generated in Odoo user settings\nCheck network connectivity and firewall rules\nAuthentication Errors\nRegenerate API key in Odoo\nVerify username (email format)\nCheck that the user has API access enabled\nEnsure database name matches exactly\nMissing Field Errors\nField names must match Odoo 19 exactly (e.g., product_tmpl_id, not product_id)\nSome fields are read-only in Odoo (state, computed fields)\nCheck Odoo model definition: Settings → Technical → Database Structure → Models\nSmart Action Issues\nFuzzy matching is case-insensitive but searches only the name field\nFor exact matching, use the low-level Ops API with id directly\nIf a name exists in multiple records, the first match is used\nPerformance\nLarge searches (limit > 100) may timeout\nUse date range filters: date_from, date_to\nConsider batch operations for bulk data\nExamples in OpenClaw\nNatural Language Sales Order\nUser: \"Create a quote for Acme Corp with 10 Widgets at $50 each\"\n\nOpenClaw → OdooClient (smart action):\n  1. Search for customer \"Acme Corp\"\n  2. Search for product \"Widgets\"\n  3. Create quotation with both\n  4. Return summary\n\nResult: \"✅ Created quotation QT-001 for Acme Corp with 10 × Widgets at $50\"\n\nPipeline Status Check\nUser: \"Show me the sales pipeline\"\n\nOpenClaw → CRMOps.get_pipeline():\n  - Query all leads/opportunities\n  - Group by stage\n  - Calculate total revenue by stage\n  - Return formatted summary\n\nResult: \"Qualified: $50k | Proposal: $100k | Negotiation: $75k | Total: $225k\"\n\nInventory Alert\nUser: \"What products are low on stock?\"\n\nOpenClaw → InventoryOps.get_low_stock_products():\n  - Query products with stock < reorder point\n  - List each product, stock level, reorder point\n  - Suggest PO quantities\n\nResult: \"Widget X: 5 on hand (min 20) | Component Y: 0 on hand (min 10)\"\n\nDevelopment\nProject Structure\nOdooConnector/\n├── odoo_skill/\n│   ├── client.py              # Core OdooClient\n│   ├── config.py              # Configuration loader\n│   ├── errors.py              # Custom exceptions\n│   ├── retry.py               # Retry logic\n│   ├── smart_actions.py       # Smart action handler\n│   ├── models/\n│   │   ├── partner.py\n│   │   ├── sale_order.py\n│   │   ├── invoice.py\n│   │   ├── inventory.py\n│   │   ├── crm.py\n│   │   ├── purchase.py\n│   │   ├── project.py\n│   │   ├── hr.py\n│   │   ├── manufacturing.py\n│   │   ├── calendar_ops.py\n│   │   ├── fleet.py\n│   │   ├── ecommerce.py\n│   ├── utils/\n│   │   ├── formatting.py      # Response formatting\n│   │   ├── validators.py      # Input validation\n│   ├── sync/\n│   │   ├── poller.py          # Webhook poller\n│   │   ├── webhook.py         # Webhook handler\n├── run_full_test.py           # Integration test suite\n├── config.json                # Configuration (create from template)\n├── config.template.json       # Configuration template\n├── requirements.txt           # Python dependencies\n├── README.md                  # User setup guide\n├── SKILL.md                   # This file\n└── setup.ps1                  # PowerShell installer\n\nRunning Tests\n# Run full integration test suite\npython run_full_test.py\n\n# Run single test module\npython -m pytest tests/test_partners.py -v\n\n# Run with coverage\npython -m pytest --cov=odoo_skill tests/\n\nAdding a New Smart Action\nImplement the method in SmartActionHandler class\nUse find_or_create_* primitives for dependencies\nReturn a dict with summary, the main record, and creation details\nAdd docstring with example usage\nTest with run_full_test.py\n\nExample:\n\ndef smart_create_invoice(self, customer_name: str, product_lines: list[dict], **kwargs) -> dict:\n    \"\"\"Create invoice with fuzzy customer and product matching.\"\"\"\n    # Find or create customer\n    customer_result = self.find_or_create_partner(customer_name)\n    customer = customer_result[\"partner\"]\n    \n    # Find or create products\n    products = []\n    for line in product_lines:\n        prod_result = self.find_or_create_product(line[\"name\"], **line)\n        products.append(prod_result)\n    \n    # Create invoice with resolved IDs\n    invoice = self.invoices.create_invoice(\n        partner_id=customer[\"id\"],\n        lines=[...],\n        **kwargs\n    )\n    \n    return {\n        \"summary\": f\"Created invoice INV-001 for {customer['name']}\",\n        \"invoice\": invoice,\n        \"customer\": customer_result,\n        \"products\": products\n    }\n\nLicense & Support\n\nThis connector is part of the OpenClaw project. For issues, questions, or contributions, contact the development team.\n\nLast Updated: 2026-02-09\nOdoo Version: 19.0\nPython: 3.10+\nStatus: Production Ready"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/NullNaveen/odoo-erp-connector",
    "publisherUrl": "https://clawhub.ai/NullNaveen/odoo-erp-connector",
    "owner": "NullNaveen",
    "version": "1.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/odoo-erp-connector",
    "downloadUrl": "https://openagent3.xyz/downloads/odoo-erp-connector",
    "agentUrl": "https://openagent3.xyz/skills/odoo-erp-connector/agent",
    "manifestUrl": "https://openagent3.xyz/skills/odoo-erp-connector/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/odoo-erp-connector/agent.md"
  }
}