{
  "schemaVersion": "1.0",
  "item": {
    "slug": "odoo-manager",
    "name": "Odoo Manager",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/willykinfoussia/odoo-manager",
    "canonicalUrl": "https://clawhub.ai/willykinfoussia/odoo-manager",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/odoo-manager",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=odoo-manager",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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-manager"
    },
    "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-manager",
    "agentPageUrl": "https://openagent3.xyz/skills/odoo-manager/agent",
    "manifestUrl": "https://openagent3.xyz/skills/odoo-manager/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/odoo-manager/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "URL Resolution",
        "body": "Odoo server URL precedence (highest to lowest):\n\ntemporary_url — one-time URL for a specific operation\nuser_url — user-defined URL for the current session\nODOO_URL — environment default URL\n\nThis allows you to:\n\nSwitch between multiple Odoo instances (production, staging, client-specific)\nTest against demo databases\nWork with different client environments without changing global config\n\nExamples (conceptual):\n\n// Default: uses ODOO_URL from environment\n{{resolved_url}}/xmlrpc/2/common\n\n// Override for one operation:\ntemporary_url = \"https://staging.mycompany.odoo.com\"\n{{resolved_url}}/xmlrpc/2/common\n\n// Override for session:\nuser_url = \"https://client-xyz.odoo.com\"\n{{resolved_url}}/xmlrpc/2/common"
      },
      {
        "title": "Database Resolution",
        "body": "Database name (db) precedence:\n\ntemporary_db\nuser_db\nODOO_DB\n\nUse this to:\n\nWork with multiple databases on the same Odoo server\nSwitch between test and production databases"
      },
      {
        "title": "Username & Secret Resolution",
        "body": "Username precedence:\n\ntemporary_username\nuser_username\nODOO_USERNAME\n\nSecret (password or API key) precedence:\n\ntemporary_api_key or temporary_password\nuser_api_key or user_password\nODOO_API_KEY (if set) or ODOO_PASSWORD\n\nImportant:\n\nOdoo API keys are used in place of the password, with the usual login.\nStore passwords / API keys like real passwords; never log or expose them.\n\nEnvironment variables are handled via standard OpenClaw metadata: requires.env declares required variables (ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_PASSWORD). ODOO_API_KEY is an optional environment variable used instead of the password when present; it is not listed in metadata and should simply be set in the environment when needed."
      },
      {
        "title": "Resolved Values",
        "body": "At runtime the skill always works with:\n\n{{resolved_url}} — final URL\n{{resolved_db}} — final database name\n{{resolved_username}} — final login\n{{resolved_secret}} — password or API key actually used to authenticate\n\nThese are computed using the precedence rules above."
      },
      {
        "title": "🔄 Context Management",
        "body": "The temporary_* and user_* names are runtime context variables used by the skill logic, not OpenClaw metadata fields. OpenClaw does not have an optional.context metadata key; context is resolved dynamically at runtime as described below."
      },
      {
        "title": "Temporary Context (One-Time Use)",
        "body": "User examples:\n\n\"Pour cette requête, utilise l’instance staging Odoo\"\n\"Utilise la base odoo_demo juste pour cette opération\"\n\"Connecte-toi avec cet utilisateur uniquement pour cette action\"\n\nBehavior:\n\nSet temporary_* (url, db, username, api_key/password)\nUse them for a single logical operation\nAutomatically clear after use\n\nThis is ideal for:\n\nComparing data between two environments\nRunning a single check on a different database"
      },
      {
        "title": "Session Context (Current Session)",
        "body": "User examples:\n\n\"Travaille sur l’instance Odoo du client XYZ\"\n\"Utilise la base clientx_prod pour cette session\"\n\"Connecte-toi avec mon compte administrateur pour les prochaines opérations\"\n\nBehavior:\n\nSet user_* (url, db, username, api_key/password)\nPersist for the whole current session\nOverridden only by temporary_* or by clearing user_*"
      },
      {
        "title": "Resetting Context",
        "body": "User examples:\n\n\"Reviens à la configuration Odoo par défaut\"\n\"Efface mon contexte utilisateur Odoo\"\n\nAction:\n\nClear user_url, user_db, user_username, user_password, user_api_key\nSkill falls back to environment variables (ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_PASSWORD / ODOO_API_KEY)"
      },
      {
        "title": "Viewing Current Context",
        "body": "User examples:\n\n\"Sur quelle instance Odoo es-tu connecté ?\"\n\"Montre la configuration Odoo actuelle\"\n\nResponse should show (never full secrets):\n\nCurrent Odoo Context:\n- URL: https://client-xyz.odoo.com (user_url)\n- DB: clientxyz_prod (user_db)\n- Username: api_integration (user_username)\n- Secret: using API key (user_api_key)\n- Fallback URL: https://default.odoo.com (ODOO_URL)\n- Fallback DB: default_db (ODOO_DB)"
      },
      {
        "title": "⚙️ Odoo XML-RPC Basics",
        "body": "Odoo exposes part of its server framework over XML-RPC (not REST).\nThe External API is documented here: https://www.odoo.com/documentation/18.0/fr/developer/reference/external_api.html\n\nTwo main endpoints:\n\n{{resolved_url}}/xmlrpc/2/common — authentication and meta calls\n{{resolved_url}}/xmlrpc/2/object — model methods via execute_kw"
      },
      {
        "title": "1. Checking Server Version",
        "body": "Call version() on the common endpoint to verify URL and connectivity:\n\ncommon = xmlrpc.client.ServerProxy(f\"{resolved_url}/xmlrpc/2/common\")\nversion_info = common.version()\n\nExample result:\n\n{\n  \"server_version\": \"18.0\",\n  \"server_version_info\": [18, 0, 0, \"final\", 0],\n  \"server_serie\": \"18.0\",\n  \"protocol_version\": 1\n}"
      },
      {
        "title": "2. Authenticating",
        "body": "Use authenticate(db, username, password_or_api_key, {}) on the common endpoint:\n\nuid = common.authenticate(resolved_db, resolved_username, resolved_secret, {})\n\nuid is an integer user ID and will be used in all subsequent calls.\n\nIf authentication fails, uid is False / 0 — the skill should:\n\nInform the user that credentials or database are invalid\nSuggest checking ODOO_URL, ODOO_DB, username, and secret"
      },
      {
        "title": "3. Calling Model Methods with execute_kw",
        "body": "Build an XML-RPC client for the object endpoint:\n\nmodels = xmlrpc.client.ServerProxy(f\"{resolved_url}/xmlrpc/2/object\")\n\nThen use execute_kw with the following signature:\n\nmodels.execute_kw(\n    resolved_db,\n    uid,\n    resolved_secret,\n    \"model.name\",     # e.g. \"res.partner\"\n    \"method_name\",    # e.g. \"search_read\"\n    [positional_args],\n    {keyword_args}\n)\n\nAll ORM operations in this skill are expressed in terms of execute_kw."
      },
      {
        "title": "Domain Filters",
        "body": "Domains are lists of conditions:\n\ndomain = [[\"field_name\", \"operator\", value], ...]\n\nExamples:\n\nAll companies: [['is_company', '=', True]]\nPartners in France: [['country_id', '=', france_id]]\nLeads with probability > 50%: [['probability', '>', 50]]\n\nCommon operators:\n\n\"=\", \"!=\", \">\", \">=\", \"<\", \"<=\"\n\"like\", \"ilike\" (case-insensitive)\n\"in\", \"not in\"\n\"child_of\" (hierarchical relations)"
      },
      {
        "title": "Field Value Conventions",
        "body": "Integer / Float / Char / Text: use native types.\nDate / Datetime: strings in YYYY-MM-DD or ISO 8601 format.\nMany2one: usually send the record ID (int) when writing; reads often return [id, display_name].\nOne2many / Many2many: use the Odoo command list protocol for writes (not fully detailed here; see Odoo docs if needed)."
      },
      {
        "title": "🧩 Generic ORM Operations (execute_kw)",
        "body": "Each subsection below shows typical user queries and the corresponding\nexecute_kw usage. They are applicable to any model (not only res.partner)."
      },
      {
        "title": "List / Search Records (search)",
        "body": "User queries:\n\n\"Liste tous les partenaires société\"\n\"Cherche les commandes de vente confirmées\"\n\nAction (generic):\n\nids = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"model.name\", \"search\",\n    [domain],\n    {\"offset\": 0, \"limit\": 80}\n)\n\nNotes:\n\ndomain is a list (can be empty [] to match all records).\nUse offset and limit for pagination."
      },
      {
        "title": "Count Records (search_count)",
        "body": "User queries:\n\n\"Combien de partenaires sont des sociétés ?\"\n\"Compte les tâches en cours\"\n\nAction:\n\ncount = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"model.name\", \"search_count\",\n    [domain]\n)"
      },
      {
        "title": "Read Records by ID (read)",
        "body": "User queries:\n\n\"Affiche les détails du partenaire 7\"\n\"Donne-moi les champs name et country_id pour ces IDs\"\n\nAction:\n\nrecords = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"model.name\", \"read\",\n    [ids],\n    {\"fields\": [\"name\", \"country_id\", \"comment\"]}\n)\n\nIf fields is omitted, Odoo returns all readable fields (often a lot)."
      },
      {
        "title": "Search and Read in One Step (search_read)",
        "body": "Shortcut for search() + read() in a single call.\n\nUser queries:\n\n\"Liste les sociétés (nom, pays, commentaire)\"\n\"Montre les 5 premiers partenaires avec leurs pays\"\n\nAction:\n\nrecords = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"model.name\", \"search_read\",\n    [domain],\n    {\n        \"fields\": [\"name\", \"country_id\", \"comment\"],\n        \"limit\": 5,\n        \"offset\": 0,\n        # Optional: \"order\": \"name asc\"\n    }\n)"
      },
      {
        "title": "Create Records (create)",
        "body": "User queries:\n\n\"Crée un nouveau partenaire 'New Partner'\"\n\"Crée une nouvelle tâche dans le projet X\"\n\nAction:\n\nnew_id = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"model.name\", \"create\",\n    [{\n        \"name\": \"New Partner\"\n        # other fields...\n    }]\n)\n\nReturns the newly created record ID."
      },
      {
        "title": "Update Records (write)",
        "body": "User queries:\n\n\"Met à jour le partenaire 7, change son nom\"\n\"Baisse la probabilité de ces leads\"\n\nAction:\n\nsuccess = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"model.name\", \"write\",\n    [ids, {\"field\": \"new value\", \"other_field\": 123}]\n)\n\nNotes:\n\nids is a list of record IDs.\nAll records in ids receive the same values."
      },
      {
        "title": "Delete Records (unlink)",
        "body": "User queries:\n\n\"Supprime ce partenaire de test\"\n\"Efface ces tâches temporaires\"\n\nAction:\n\nsuccess = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"model.name\", \"unlink\",\n    [ids]\n)"
      },
      {
        "title": "Name-Based Search (name_search)",
        "body": "Useful for quick lookup on models with a display name (e.g. partners, products).\n\nUser queries:\n\n\"Trouve le partenaire dont le nom contient 'Agrolait'\"\n\nAction:\n\nresults = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"res.partner\", \"name_search\",\n    [\"Agrolait\"],\n    {\"limit\": 10}\n)\n\nResult is a list of [id, display_name]."
      },
      {
        "title": "👥 Contacts / Partners (res.partner)",
        "body": "res.partner is the core model for contacts, companies, and many business relations in Odoo."
      },
      {
        "title": "List Company Partners",
        "body": "User queries:\n\n\"Liste toutes les sociétés\"\n\"Montre les sociétés avec leur pays\"\n\nAction:\n\ncompanies = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"res.partner\", \"search_read\",\n    [[[\"is_company\", \"=\", True]]],\n    {\"fields\": [\"name\", \"country_id\", \"comment\"], \"limit\": 80}\n)"
      },
      {
        "title": "Get a Single Partner",
        "body": "User queries:\n\n\"Affiche le partenaire 7\"\n\"Donne-moi le pays et le commentaire du partenaire 7\"\n\nAction:\n\n[partner] = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"res.partner\", \"read\",\n    [[7]],\n    {\"fields\": [\"name\", \"country_id\", \"comment\"]}\n)"
      },
      {
        "title": "Create a New Partner",
        "body": "User queries:\n\n\"Crée un partenaire 'Agrolait 2' en tant que société\"\n\"Crée un contact personne rattaché à la société X\"\n\nMinimal body:\n\npartner_id = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"res.partner\", \"create\",\n    [{\n        \"name\": \"New Partner\",\n        \"is_company\": True\n    }]\n)\n\nAdditional fields examples:\n\nstreet, zip, city, country_id\nemail, phone, mobile\ncompany_type (\"person\" or \"company\")"
      },
      {
        "title": "Update a Partner",
        "body": "User queries:\n\n\"Change l’adresse du partenaire 7\"\n\"Met à jour le pays et le téléphone\"\n\nAction:\n\nmodels.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"res.partner\", \"write\",\n    [[7], {\n        \"street\": \"New street 1\",\n        \"phone\": \"+33 1 23 45 67 89\"\n    }]\n)"
      },
      {
        "title": "Delete a Partner",
        "body": "User queries:\n\n\"Supprime le partenaire 999 de test\"\n\nAction:\n\nmodels.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"res.partner\", \"unlink\",\n    [[999]]\n)"
      },
      {
        "title": "Discover Fields of a Model (fields_get)",
        "body": "User queries:\n\n\"Quels sont les champs de res.partner ?\"\n\"Montre les types et labels des champs pour ce modèle\"\n\nAction:\n\nfields = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"res.partner\", \"fields_get\",\n    [],\n    {\"attributes\": [\"string\", \"help\", \"type\"]}\n)\n\nThe result is a mapping from field name to metadata:\n\n{\n  \"name\": {\"type\": \"char\", \"string\": \"Name\", \"help\": \"\"},\n  \"country_id\": {\"type\": \"many2one\", \"string\": \"Country\", \"help\": \"\"},\n  \"is_company\": {\"type\": \"boolean\", \"string\": \"Is a Company\", \"help\": \"\"}\n}"
      },
      {
        "title": "List All Models (ir.model)",
        "body": "User queries:\n\n\"Quels modèles sont disponibles dans ma base Odoo ?\"\n\nAction:\n\nmodels_list = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"ir.model\", \"search_read\",\n    [[]],\n    {\"fields\": [\"model\", \"name\", \"state\"], \"limit\": 200}\n)\n\nstate indicates whether a model is defined in code (\"base\") or created dynamically (\"manual\")."
      },
      {
        "title": "List Fields of a Specific Model (ir.model.fields)",
        "body": "User queries:\n\n\"Donne-moi la liste des champs du modèle res.partner via ir.model.fields\"\n\nAction (simplified):\n\npartner_model_ids = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"ir.model\", \"search\",\n    [[[\"model\", \"=\", \"res.partner\"]]]\n)\nfields_meta = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"ir.model.fields\", \"search_read\",\n    [[[\"model_id\", \"in\", partner_model_ids]]],\n    {\"fields\": [\"name\", \"field_description\", \"ttype\", \"required\", \"readonly\"], \"limit\": 500}\n)"
      },
      {
        "title": "Typical Errors",
        "body": "Authentication failure: wrong URL, DB, username, or secret → authenticate returns False or later calls fail.\nAccess rights / ACLs: user does not have permission on a model or record.\nValidation errors: required fields missing, constraints violated.\nConnectivity issues: network errors reaching xmlrpc/2/common or xmlrpc/2/object.\n\nThe skill should:\n\nClearly indicate if the issue is with connection, credentials, or business validation.\nPropose next steps (check env vars, context overrides, user rights)."
      },
      {
        "title": "Pagination",
        "body": "Use limit / offset on search and search_read to handle large datasets.\nFor interactive use, default limit to a reasonable value (e.g. 80)."
      },
      {
        "title": "Field Selection",
        "body": "Always send an explicit fields list for read / search_read when possible.\nThis reduces payload and speeds up responses."
      },
      {
        "title": "Domains & Performance",
        "body": "Prefer indexed fields and simple operators (=, in) for large datasets.\nAvoid unbounded searches without domain on very big tables when possible."
      },
      {
        "title": "Example 1: Check Connection & List Company Partners",
        "body": "Resolve context: {{resolved_url}}, {{resolved_db}}, {{resolved_username}}, {{resolved_secret}}\nCall version() on {{resolved_url}}/xmlrpc/2/common\nAuthenticate to get uid\nCall execute_kw on res.partner with search_read and domain [['is_company', '=', True]]"
      },
      {
        "title": "Example 2: Create a Partner, Then Read It Back",
        "body": "Authenticate via common.authenticate\ncreate a new res.partner with {\"name\": \"New Partner\", \"is_company\": True}\nread that ID with fields [\"name\", \"is_company\", \"country_id\"]"
      },
      {
        "title": "Example 3: Work on Another Database for One Operation",
        "body": "Set temporary_url and/or temporary_db to point to another Odoo environment.\nAuthenticate and perform the requested operation using resolved context.\nTemporary context is cleared automatically."
      },
      {
        "title": "📚 References & Capabilities Summary",
        "body": "Official Odoo External API documentation (XML-RPC): https://www.odoo.com/documentation/18.0/fr/developer/reference/external_api.html\nRequires an Odoo plan with External API access (Custom plans; not available on One App Free / Standard).\n\nThis skill can:\n\nConnect to Odoo via XML-RPC using password or API key.\nSwitch dynamically between multiple instances and databases using context.\nPerform generic CRUD (search, search_count, read, search_read, create, write, unlink) on any Odoo model via execute_kw.\nProvide ready-made flows for res.partner (contacts / companies).\nInspect model structures using fields_get, ir.model, and ir.model.fields.\nApply best practices regarding pagination, field selection, and error handling."
      }
    ],
    "body": "Odoo Manager Skill\n🔐 URL, Database & Credential Resolution\nURL Resolution\n\nOdoo server URL precedence (highest to lowest):\n\ntemporary_url — one-time URL for a specific operation\nuser_url — user-defined URL for the current session\nODOO_URL — environment default URL\n\nThis allows you to:\n\nSwitch between multiple Odoo instances (production, staging, client-specific)\nTest against demo databases\nWork with different client environments without changing global config\n\nExamples (conceptual):\n\n// Default: uses ODOO_URL from environment\n{{resolved_url}}/xmlrpc/2/common\n\n// Override for one operation:\ntemporary_url = \"https://staging.mycompany.odoo.com\"\n{{resolved_url}}/xmlrpc/2/common\n\n// Override for session:\nuser_url = \"https://client-xyz.odoo.com\"\n{{resolved_url}}/xmlrpc/2/common\n\nDatabase Resolution\n\nDatabase name (db) precedence:\n\ntemporary_db\nuser_db\nODOO_DB\n\nUse this to:\n\nWork with multiple databases on the same Odoo server\nSwitch between test and production databases\nUsername & Secret Resolution\n\nUsername precedence:\n\ntemporary_username\nuser_username\nODOO_USERNAME\n\nSecret (password or API key) precedence:\n\ntemporary_api_key or temporary_password\nuser_api_key or user_password\nODOO_API_KEY (if set) or ODOO_PASSWORD\n\nImportant:\n\nOdoo API keys are used in place of the password, with the usual login.\nStore passwords / API keys like real passwords; never log or expose them.\n\nEnvironment variables are handled via standard OpenClaw metadata: requires.env declares required variables (ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_PASSWORD). ODOO_API_KEY is an optional environment variable used instead of the password when present; it is not listed in metadata and should simply be set in the environment when needed.\n\nResolved Values\n\nAt runtime the skill always works with:\n\n{{resolved_url}} — final URL\n{{resolved_db}} — final database name\n{{resolved_username}} — final login\n{{resolved_secret}} — password or API key actually used to authenticate\n\nThese are computed using the precedence rules above.\n\n🔄 Context Management\n\nThe temporary_* and user_* names are runtime context variables used by the skill logic, not OpenClaw metadata fields. OpenClaw does not have an optional.context metadata key; context is resolved dynamically at runtime as described below.\n\nTemporary Context (One-Time Use)\n\nUser examples:\n\n\"Pour cette requête, utilise l’instance staging Odoo\"\n\"Utilise la base odoo_demo juste pour cette opération\"\n\"Connecte-toi avec cet utilisateur uniquement pour cette action\"\n\nBehavior:\n\nSet temporary_* (url, db, username, api_key/password)\nUse them for a single logical operation\nAutomatically clear after use\n\nThis is ideal for:\n\nComparing data between two environments\nRunning a single check on a different database\nSession Context (Current Session)\n\nUser examples:\n\n\"Travaille sur l’instance Odoo du client XYZ\"\n\"Utilise la base clientx_prod pour cette session\"\n\"Connecte-toi avec mon compte administrateur pour les prochaines opérations\"\n\nBehavior:\n\nSet user_* (url, db, username, api_key/password)\nPersist for the whole current session\nOverridden only by temporary_* or by clearing user_*\nResetting Context\n\nUser examples:\n\n\"Reviens à la configuration Odoo par défaut\"\n\"Efface mon contexte utilisateur Odoo\"\n\nAction:\n\nClear user_url, user_db, user_username, user_password, user_api_key\nSkill falls back to environment variables (ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_PASSWORD / ODOO_API_KEY)\nViewing Current Context\n\nUser examples:\n\n\"Sur quelle instance Odoo es-tu connecté ?\"\n\"Montre la configuration Odoo actuelle\"\n\nResponse should show (never full secrets):\n\nCurrent Odoo Context:\n- URL: https://client-xyz.odoo.com (user_url)\n- DB: clientxyz_prod (user_db)\n- Username: api_integration (user_username)\n- Secret: using API key (user_api_key)\n- Fallback URL: https://default.odoo.com (ODOO_URL)\n- Fallback DB: default_db (ODOO_DB)\n\n⚙️ Odoo XML-RPC Basics\n\nOdoo exposes part of its server framework over XML-RPC (not REST). The External API is documented here: https://www.odoo.com/documentation/18.0/fr/developer/reference/external_api.html\n\nTwo main endpoints:\n\n{{resolved_url}}/xmlrpc/2/common — authentication and meta calls\n{{resolved_url}}/xmlrpc/2/object — model methods via execute_kw\n1. Checking Server Version\n\nCall version() on the common endpoint to verify URL and connectivity:\n\ncommon = xmlrpc.client.ServerProxy(f\"{resolved_url}/xmlrpc/2/common\")\nversion_info = common.version()\n\n\nExample result:\n\n{\n  \"server_version\": \"18.0\",\n  \"server_version_info\": [18, 0, 0, \"final\", 0],\n  \"server_serie\": \"18.0\",\n  \"protocol_version\": 1\n}\n\n2. Authenticating\n\nUse authenticate(db, username, password_or_api_key, {}) on the common endpoint:\n\nuid = common.authenticate(resolved_db, resolved_username, resolved_secret, {})\n\n\nuid is an integer user ID and will be used in all subsequent calls.\n\nIf authentication fails, uid is False / 0 — the skill should:\n\nInform the user that credentials or database are invalid\nSuggest checking ODOO_URL, ODOO_DB, username, and secret\n3. Calling Model Methods with execute_kw\n\nBuild an XML-RPC client for the object endpoint:\n\nmodels = xmlrpc.client.ServerProxy(f\"{resolved_url}/xmlrpc/2/object\")\n\n\nThen use execute_kw with the following signature:\n\nmodels.execute_kw(\n    resolved_db,\n    uid,\n    resolved_secret,\n    \"model.name\",     # e.g. \"res.partner\"\n    \"method_name\",    # e.g. \"search_read\"\n    [positional_args],\n    {keyword_args}\n)\n\n\nAll ORM operations in this skill are expressed in terms of execute_kw.\n\n🔍 Domains & Data Types (Odoo ORM)\nDomain Filters\n\nDomains are lists of conditions:\n\ndomain = [[\"field_name\", \"operator\", value], ...]\n\n\nExamples:\n\nAll companies: [['is_company', '=', True]]\nPartners in France: [['country_id', '=', france_id]]\nLeads with probability > 50%: [['probability', '>', 50]]\n\nCommon operators:\n\n\"=\", \"!=\", \">\", \">=\", \"<\", \"<=\"\n\"like\", \"ilike\" (case-insensitive)\n\"in\", \"not in\"\n\"child_of\" (hierarchical relations)\nField Value Conventions\nInteger / Float / Char / Text: use native types.\nDate / Datetime: strings in YYYY-MM-DD or ISO 8601 format.\nMany2one: usually send the record ID (int) when writing; reads often return [id, display_name].\nOne2many / Many2many: use the Odoo command list protocol for writes (not fully detailed here; see Odoo docs if needed).\n🧩 Generic ORM Operations (execute_kw)\n\nEach subsection below shows typical user queries and the corresponding execute_kw usage. They are applicable to any model (not only res.partner).\n\nList / Search Records (search)\n\nUser queries:\n\n\"Liste tous les partenaires société\"\n\"Cherche les commandes de vente confirmées\"\n\nAction (generic):\n\nids = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"model.name\", \"search\",\n    [domain],\n    {\"offset\": 0, \"limit\": 80}\n)\n\n\nNotes:\n\ndomain is a list (can be empty [] to match all records).\nUse offset and limit for pagination.\nCount Records (search_count)\n\nUser queries:\n\n\"Combien de partenaires sont des sociétés ?\"\n\"Compte les tâches en cours\"\n\nAction:\n\ncount = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"model.name\", \"search_count\",\n    [domain]\n)\n\nRead Records by ID (read)\n\nUser queries:\n\n\"Affiche les détails du partenaire 7\"\n\"Donne-moi les champs name et country_id pour ces IDs\"\n\nAction:\n\nrecords = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"model.name\", \"read\",\n    [ids],\n    {\"fields\": [\"name\", \"country_id\", \"comment\"]}\n)\n\n\nIf fields is omitted, Odoo returns all readable fields (often a lot).\n\nSearch and Read in One Step (search_read)\n\nShortcut for search() + read() in a single call.\n\nUser queries:\n\n\"Liste les sociétés (nom, pays, commentaire)\"\n\"Montre les 5 premiers partenaires avec leurs pays\"\n\nAction:\n\nrecords = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"model.name\", \"search_read\",\n    [domain],\n    {\n        \"fields\": [\"name\", \"country_id\", \"comment\"],\n        \"limit\": 5,\n        \"offset\": 0,\n        # Optional: \"order\": \"name asc\"\n    }\n)\n\nCreate Records (create)\n\nUser queries:\n\n\"Crée un nouveau partenaire 'New Partner'\"\n\"Crée une nouvelle tâche dans le projet X\"\n\nAction:\n\nnew_id = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"model.name\", \"create\",\n    [{\n        \"name\": \"New Partner\"\n        # other fields...\n    }]\n)\n\n\nReturns the newly created record ID.\n\nUpdate Records (write)\n\nUser queries:\n\n\"Met à jour le partenaire 7, change son nom\"\n\"Baisse la probabilité de ces leads\"\n\nAction:\n\nsuccess = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"model.name\", \"write\",\n    [ids, {\"field\": \"new value\", \"other_field\": 123}]\n)\n\n\nNotes:\n\nids is a list of record IDs.\nAll records in ids receive the same values.\nDelete Records (unlink)\n\nUser queries:\n\n\"Supprime ce partenaire de test\"\n\"Efface ces tâches temporaires\"\n\nAction:\n\nsuccess = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"model.name\", \"unlink\",\n    [ids]\n)\n\nName-Based Search (name_search)\n\nUseful for quick lookup on models with a display name (e.g. partners, products).\n\nUser queries:\n\n\"Trouve le partenaire dont le nom contient 'Agrolait'\"\n\nAction:\n\nresults = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"res.partner\", \"name_search\",\n    [\"Agrolait\"],\n    {\"limit\": 10}\n)\n\n\nResult is a list of [id, display_name].\n\n👥 Contacts / Partners (res.partner)\n\nres.partner is the core model for contacts, companies, and many business relations in Odoo.\n\nList Company Partners\n\nUser queries:\n\n\"Liste toutes les sociétés\"\n\"Montre les sociétés avec leur pays\"\n\nAction:\n\ncompanies = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"res.partner\", \"search_read\",\n    [[[\"is_company\", \"=\", True]]],\n    {\"fields\": [\"name\", \"country_id\", \"comment\"], \"limit\": 80}\n)\n\nGet a Single Partner\n\nUser queries:\n\n\"Affiche le partenaire 7\"\n\"Donne-moi le pays et le commentaire du partenaire 7\"\n\nAction:\n\n[partner] = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"res.partner\", \"read\",\n    [[7]],\n    {\"fields\": [\"name\", \"country_id\", \"comment\"]}\n)\n\nCreate a New Partner\n\nUser queries:\n\n\"Crée un partenaire 'Agrolait 2' en tant que société\"\n\"Crée un contact personne rattaché à la société X\"\n\nMinimal body:\n\npartner_id = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"res.partner\", \"create\",\n    [{\n        \"name\": \"New Partner\",\n        \"is_company\": True\n    }]\n)\n\n\nAdditional fields examples:\n\nstreet, zip, city, country_id\nemail, phone, mobile\ncompany_type (\"person\" or \"company\")\nUpdate a Partner\n\nUser queries:\n\n\"Change l’adresse du partenaire 7\"\n\"Met à jour le pays et le téléphone\"\n\nAction:\n\nmodels.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"res.partner\", \"write\",\n    [[7], {\n        \"street\": \"New street 1\",\n        \"phone\": \"+33 1 23 45 67 89\"\n    }]\n)\n\nDelete a Partner\n\nUser queries:\n\n\"Supprime le partenaire 999 de test\"\n\nAction:\n\nmodels.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"res.partner\", \"unlink\",\n    [[999]]\n)\n\n🧱 Model Introspection (ir.model, ir.model.fields, fields_get)\nDiscover Fields of a Model (fields_get)\n\nUser queries:\n\n\"Quels sont les champs de res.partner ?\"\n\"Montre les types et labels des champs pour ce modèle\"\n\nAction:\n\nfields = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"res.partner\", \"fields_get\",\n    [],\n    {\"attributes\": [\"string\", \"help\", \"type\"]}\n)\n\n\nThe result is a mapping from field name to metadata:\n\n{\n  \"name\": {\"type\": \"char\", \"string\": \"Name\", \"help\": \"\"},\n  \"country_id\": {\"type\": \"many2one\", \"string\": \"Country\", \"help\": \"\"},\n  \"is_company\": {\"type\": \"boolean\", \"string\": \"Is a Company\", \"help\": \"\"}\n}\n\nList All Models (ir.model)\n\nUser queries:\n\n\"Quels modèles sont disponibles dans ma base Odoo ?\"\n\nAction:\n\nmodels_list = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"ir.model\", \"search_read\",\n    [[]],\n    {\"fields\": [\"model\", \"name\", \"state\"], \"limit\": 200}\n)\n\n\nstate indicates whether a model is defined in code (\"base\") or created dynamically (\"manual\").\n\nList Fields of a Specific Model (ir.model.fields)\n\nUser queries:\n\n\"Donne-moi la liste des champs du modèle res.partner via ir.model.fields\"\n\nAction (simplified):\n\npartner_model_ids = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"ir.model\", \"search\",\n    [[[\"model\", \"=\", \"res.partner\"]]]\n)\nfields_meta = models.execute_kw(\n    resolved_db, uid, resolved_secret,\n    \"ir.model.fields\", \"search_read\",\n    [[[\"model_id\", \"in\", partner_model_ids]]],\n    {\"fields\": [\"name\", \"field_description\", \"ttype\", \"required\", \"readonly\"], \"limit\": 500}\n)\n\n⚠️ Error Handling & Best Practices\nTypical Errors\nAuthentication failure: wrong URL, DB, username, or secret → authenticate returns False or later calls fail.\nAccess rights / ACLs: user does not have permission on a model or record.\nValidation errors: required fields missing, constraints violated.\nConnectivity issues: network errors reaching xmlrpc/2/common or xmlrpc/2/object.\n\nThe skill should:\n\nClearly indicate if the issue is with connection, credentials, or business validation.\nPropose next steps (check env vars, context overrides, user rights).\nPagination\nUse limit / offset on search and search_read to handle large datasets.\nFor interactive use, default limit to a reasonable value (e.g. 80).\nField Selection\nAlways send an explicit fields list for read / search_read when possible.\nThis reduces payload and speeds up responses.\nDomains & Performance\nPrefer indexed fields and simple operators (=, in) for large datasets.\nAvoid unbounded searches without domain on very big tables when possible.\n🚀 Quick End-to-End Examples\nExample 1: Check Connection & List Company Partners\nResolve context: {{resolved_url}}, {{resolved_db}}, {{resolved_username}}, {{resolved_secret}}\nCall version() on {{resolved_url}}/xmlrpc/2/common\nAuthenticate to get uid\nCall execute_kw on res.partner with search_read and domain [['is_company', '=', True]]\nExample 2: Create a Partner, Then Read It Back\nAuthenticate via common.authenticate\ncreate a new res.partner with {\"name\": \"New Partner\", \"is_company\": True}\nread that ID with fields [\"name\", \"is_company\", \"country_id\"]\nExample 3: Work on Another Database for One Operation\nSet temporary_url and/or temporary_db to point to another Odoo environment.\nAuthenticate and perform the requested operation using resolved context.\nTemporary context is cleared automatically.\n📚 References & Capabilities Summary\nOfficial Odoo External API documentation (XML-RPC): https://www.odoo.com/documentation/18.0/fr/developer/reference/external_api.html\nRequires an Odoo plan with External API access (Custom plans; not available on One App Free / Standard).\n\nThis skill can:\n\nConnect to Odoo via XML-RPC using password or API key.\nSwitch dynamically between multiple instances and databases using context.\nPerform generic CRUD (search, search_count, read, search_read, create, write, unlink) on any Odoo model via execute_kw.\nProvide ready-made flows for res.partner (contacts / companies).\nInspect model structures using fields_get, ir.model, and ir.model.fields.\nApply best practices regarding pagination, field selection, and error handling."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/willykinfoussia/odoo-manager",
    "publisherUrl": "https://clawhub.ai/willykinfoussia/odoo-manager",
    "owner": "willykinfoussia",
    "version": "0.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/odoo-manager",
    "downloadUrl": "https://openagent3.xyz/downloads/odoo-manager",
    "agentUrl": "https://openagent3.xyz/skills/odoo-manager/agent",
    "manifestUrl": "https://openagent3.xyz/skills/odoo-manager/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/odoo-manager/agent.md"
  }
}